Horoshop MCP server

horoshop-mcp

English: an MCP server for the Horoshop e-commerce platform. It gives Claude, Cursor and any other MCP client direct access to a Horoshop store's API — orders, catalog, categories, customers, product sets, reference data and webhooks. Install with npx -y horoshop-mcp, configure with your store domain and an admin login. llms-install.md lets an AI agent do the whole setup for you. MIT licensed. Documentation below is in Ukrainian.

Пояснення для власника магазину, без технічних деталей —

ecomkit.com.ua/instrumenty.

Що це

Це MCP-сервер для Horoshop. Він дає Claude (або будь-якому іншому MCP-клієнту) прямий доступ до API вашого магазину: замовлення, каталог, розділи, покупці, комплекти товарів, довідники доставки й оплати, вебхуки.

Далі можна просто просити звичайною мовою:

• «покажи замовлення за минулий тиждень, які ще в обробці»
• «вивантаж товари з розділу "Аксесуари", де не заповнений SEO-опис»
• «онови ціни на ці 20 артикулів»
• «скільки покупців зареєструвалося в серпні»

Сервер не має власної логіки поверх Horoshop — це тонка обгортка над офіційним API.

Що потрібно

• Node.js 20 або новіший
• магазин на Horoshop
• логін і пароль адміністратора

Встановлення через ШІ

Найшвидший шлях — попросити про це самого асистента. Скопіюйте цей промпт у Claude Code, Claude Desktop або Cursor:

Встанови мені MCP-сервер horoshop-mcp.
Інструкція для тебе:
https://github.com/ecomkit-com-ua/horoshop-mcp/blob/main/llms-install.md
Прочитай її й виконай: спитай у мене домен магазину, логін і пароль адміна, пропиши конфіг
для того клієнта, у якому ти зараз працюєш, залиш на перший раз режим лише-читання
і перевір, що сервер відповідає.

Асистент сам спитає доступи, впише блок у потрібний файл конфігурації й перевірить зв'язок. Пароль він записує тільки в конфіг — не в чат і не в git.

Далі — те саме руками, якщо так зручніше.

Крок 1. Створіть окремого адміна для API

В адмінпанелі магазину: Налаштування → Адміни → додати адміністратора.

Створіть окремий обліковий запис саме для API, а не використовуйте свій особистий. Так доступ можна відкликати одним рухом, не блокуючи собі вхід, і в логах видно, що саме робив інтеграційний доступ.

Horoshop не має API-ключів: авторизація йде звичайним логіном і паролем адміна.

Крок 2. Підключіть сервер

Claude Code — у .mcp.json в корені проєкту:

{
  "mcpServers": {
    "horoshop": {
      "command": "npx",
      "args": ["-y", "horoshop-mcp"],
      "env": {
        "HOROSHOP_DOMAIN": "myshop.com.ua",
        "HOROSHOP_LOGIN": "api",
        "HOROSHOP_PASSWORD": "..."
      }
    }
  }
}

Claude Desktop — те саме, але у claudedesktopconfig.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).

Cursor — той самий блок у ~/.cursor/mcp.json.

Cline — той самий блок у clinemcpsettings.json.

Gemini CLI — той самий блок у ~/.gemini/settings.json.

VS Code (GitHub Copilot) — те саме у .vscode/mcp.json, але сервери лежать під ключем servers, а не mcpServers.

Будь-який інший клієнт із підтримкою MCP через stdio теж підійде — конфіг скрізь той самий.

Після цього перезапустіть клієнт.

npx сам завантажить пакет з npm — окремо нічого встановлювати не треба. Найсвіжіший код, ще до релізу, ставиться прямо з GitHub: ["-y", "github:ecomkit-com-ua/horoshop-mcp"].

Файл конфігурації містить пароль адміна відкритим текстом. Тримайте його поза git —

додайте .mcp.json у .gitignore.

Інструменти

Читання:

Shortened. The full README is on GitHub.