horoshop-mcp

Агент делает то, что вы делали бы руками

Хорошоп MCP подключает Claude, Cursor, Codex и других ИИ-агентов к вашему магазину на Хорошопе. Каталог, заказы, SEO, редиректы, фиды маркетплейсов, настройки. Сервер работает на вашем компьютере, доступы остаются в вашем файле.

Одна строка в вашем ИИ-клиенте
npx -y github:IgorShutko/horoshop-mcp

Пользуетесь Claude Desktop? Скачайте файл horoshop-mcp.mcpb и откройте его: сервер поставится сам, терминал не нужен.

Задай SEO-заголовок и описание категории «Кроссовки» на украинском и русском. Сначала покажи план.

запрос человека к агенту

ПолеСейчас в магазинеСтанет
title, укрКросівкиКросівки чоловічі та жіночі - купити в Дніпрі | REBUS+
description, укрпустоКросівки для міста і залу. Розміри 36-46, приміряння при отриманні, доставка Новою поштою.
title, русКроссовкиКроссовки мужские и женские - купить в Днепре | REBUS+
h1Кросівкибез изменений

Ничего не сохранено. Чтобы применить, агент должен повторить вызов с dryRun:false.

118 инструментов, сгруппированных так, как устроен магазин

РазделПримерыИнструментов
Подключение и диагностикасписок магазинов, проверка доступа2
Каталог товаровэкспорт и импорт товаров, привязка фото4
Заказызаказы с UTM, смена статуса3
Категории, покупатели, комплектыдерево категорий, покупатели, комплекты5
Оплата, доставка, валютыспособы оплаты и доставки, курсы5
B2B: группы и уровни ценгруппы покупателей, уровни цен2
Вебхукиподписки на события магазина2
Витрина: корзина и оформлениенастоящая корзина покупателя, купоны6
Админка: универсальный движокчтение и сохранение любой записи6
Админка: заказы и аналитикаредактирование заказов, печать ТТН, дашборд8
Админка: товары, цены, фотомассовая смена цен с откатом, остатки9
Админка: характеристики и справочникисхемы характеристик, шаблоны, переводы15
Админка: категории, страницы, блог, баннеры, фильтрыSEO-тексты категорий, статьи, баннеры12
Админка: SEO, sitemap, редиректыcanonical, robots.txt, 301 с проверкой циклов11
Админка: фиды маркетплейсовRozetka, Hotline, Google, Facebook, Kasta6
Админка: дизайн и языкитема, свой CSS, языки интерфейса8
Админка: настройки, маркетинг, чекиконтакты, GTM и Pixel, купоны, Checkbox14

Плюс семь готовых сценариев, которые ваш ИИ-клиент показывает своим списком: проверка магазина, SEO категории, товары без фото, сводка заказов, фиды, редиректы, смена цен с откатом. Выбираете сценарий, заполняете одно поле, дальше агент идёт проверенным порядком действий. Полный перечень инструментов со всеми параметрами лежит в репозитории.

Почему этому можно дать доступ к рабочему магазину

Сначала план, потом запись

57 из 71 инструмента записи по умолчанию только показывают, что именно изменится. Выполнение - отдельный шаг с dryRun:false.

Подтверждение для необратимого

Удаление заказов, смена алиаса фида, импорт прайса и массовые изменения цен требуют явного подтверждения, а смена цен возвращает параметры для отката.

Проверка другим каналом

Хорошоп иногда отвечает «сохранено», ничего не сохранив. Поэтому инструменты перечитывают результат, часто через другой канал.

Доступы не уходят наружу

Сервер ходит только на домен вашего магазина. Значения, похожие на ключи и токены, маскируются в ответах.

Подключение за четыре шага

  1. Node.js 18 или новее

    Проверьте в терминале. Если команда ничего не показывает, установите Node.

    node -v
  2. Отдельный администратор в магазине

    В админке Хорошопа создайте отдельного администратора для агента: та же пара логин и пароль работает и для API, и для инструментов админки.

  3. Файл с магазинами

    Сохраните stores.json там, куда нет доступа посторонним.

    { "myshop": { "baseUrl": "https://myshop.com.ua", "login": "api-user", "password": "REPLACE_ME" } }
  4. Строка в вашем ИИ-клиенте

    Для Claude Code достаточно одной команды. Для остальных клиентов готовые конфиги лежат в инструкции.

    claude mcp add horoshop -s user -e HOROSHOP_STORES_FILE=/abs/path/to/stores.json -- npx -y github:IgorShutko/horoshop-mcp

Частые вопросы

Что такое Хорошоп MCP?
Это MCP-сервер с открытым кодом, который даёт ИИ-агенту доступ к вашему магазину на Хорошопе: каталог, заказы, SEO, редиректы, фиды, дизайн и настройки. Вы пишете агенту обычным языком, он вызывает нужные инструменты.
Это официальный продукт Хорошопа?
Нет. Проект неофициальный, не связан с компанией Хорошоп и ею не поддерживается. Инструменты админки работают через внутренние недокументированные запросы, которые могут измениться без предупреждения.
Какие ИИ-ассистенты поддерживаются?
Claude Code, Claude Desktop, Cursor, Codex, Gemini CLI, VS Code, Windsurf, Zed, LM Studio, Hermes Agent, OpenCode, Goose и другие клиенты с поддержкой MCP: всего 22 готовых конфига в инструкции.
Безопасно ли давать агенту доступ к магазину?
Сервер работает локально, доступы лежат в вашем файле, телеметрии нет. Записи по умолчанию только показывают план, необратимые действия требуют подтверждения, а секреты маскируются в ответах. Создайте для агента отдельного администратора и сначала обкатайте сценарии на тестовом магазине.
Можно ли управлять несколькими магазинами?
Да. Каждый инструмент принимает аргумент store, поэтому агентство подключает магазины всех клиентов через один сервер.
Сколько это стоит?
Ничего. Лицензия MIT, код открыт. Вы платите только за свой тариф Хорошопа и за ИИ-клиент, которым пользуетесь.

Дальше