MCP-сервер для Хорошоп: что умеет ИИ-агент в магазине и безопасно ли это

Краткий ответ

Хорошоп MCP - бесплатный MCP-сервер с открытым кодом. Он дает ИИ-агенту 118 инструментов для работы с магазином на Хорошопе: цены, заказы, редиректы, фиды.

Агент показывает план изменений к записи, но не всегда. Из 71 инструмента, которые меняют магазин, 57 показывают план, остальные 14 записывают без плана. Чтобы ограничить риск, дайте агенту отдельного администратора с узкой ролью и оставьте в программе запрос разрешения перед каждым изменением.

Что такое MCP-сервер и зачем он владельцу магазина?

MCP-сервер дает ИИ-агенту доступ к магазину, поэтому рутину выполняет агент, а менеджер утверждает план. MCP (Model Context Protocol) - протокол, по которому агент подключается к внешним системам. Агент работает в программе вроде Claude или Cursor. Сервер дает ему список действий, например «покажи заказы» или «создай редирект», и эти действия называют инструментами.

Без сервера вы копируете данные из админки в чат и обратно. С ним агент работает в магазине напрямую. Код открыт и лежит в репозитории на GitHub. Описание и цифры смотрите на странице проекта.

Какую рутину в админке Хорошопа возьмет на себя ИИ-агент?

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

Чтобы не формулировать задачу с нуля, у сервера есть семь готовых сценариев. Программа показывает их в меню: вы заполняете одно-два поля. Начните со сценария «Проверка магазина»: он только читает доступы, фиды и продажи.

Как состояние каталога влияет на заказы из рекламы?

Каталог с пробелами тратит бюджет впустую: клик оплачен, а страница не дает заказ, поэтому цена заказа растет. Агент находит пробелы до запуска:

• Товары без фото. Показывает первыми те, что в наличии.
• Фид для Facebook. Показывает, где не сопоставлены цена, наличие и категории.
• Коды отслеживания. Проверяет, подключены ли Pixel и GTM: без них не видно, какие клики дали заказы.
• Старые адреса. Создает 301-редиректы списком, чтобы реклама не вела на несуществующую страницу.

Пример: из 40 рекламируемых товаров 8 без фото. Агент находит их одним запросом, вы добавляете фото до запуска, и оплаченные клики не попадают на такие карточки.

О рекламе в Meta и TikTok и конверсии страниц для таких магазинов читайте в решении для Хорошопа. Что настроить перед стартом рекламы, разбирает статья о продвижении магазина на Хорошопе.

Изменит ли агент цены без подтверждения и как их вернуть?

Массовое изменение цен проходит в два шага: инструмент показывает план, а записывает после вашего подтверждения. В плане видно, что изменится, с какого значения и на какое. Кроме плана, инструмент:

• не принимает нулевую или отрицательную цену;
• для более чем 50 товаров требует назвать точное количество;
• если цена товара меняется более чем на 50%, требует отдельного подтверждения;
• дает готовые параметры, по которым агент возвращает старые цены.

Пример: вместо скидки 9% вы пишете 90. План показывает новые цены, а изменение более 50% сервер не пропустит без отдельного подтверждения.

План перед записью показывают 57 из 71 инструмента, которые меняют магазин. Остальные 14 записывают без плана, поэтому оставьте в программе запрос разрешения перед каждым изменением. Каждый инструмент помечен как чтение, запись или разрушительная запись, так что программа может разрешать чтение автоматически и спрашивать перед записью.

Отмена и удаление заказов, удаление справочников, изменение адреса фида и импорт прайса требуют явного подтверждения. После записи сервер перечитывает результат: Хорошоп иногда отвечает «OK», ничего не сохранив.

Какие данные магазина видит ИИ-сервис и как это ограничить?

ИИ-сервис, к которому обращается ваша программа, видит все, что агент прочитал в магазине. Сервер работает на вашем компьютере, телеметрии в нем нет. Но ответы инструментов попадают в разговор, а разговор идет в ИИ-сервис.

Пример: запрос «покажи 10 последних заказов» передает в ИИ-сервис телефоны и данные доставки десяти покупателей. Запрос «каких товаров нет в наличии» не передает ни одного покупателя. Просите только то, что нужно для задачи.

• Создайте отдельного администратора с самой узкой ролью, которой достаточно для задач. Агент работает от его имени: чего не может администратор, не сможет и агент.
• Держите логин и пароль в файле stores.json, а не в запросах к агенту: сервер читает их сам.
• Чтобы закрыть доступ, удалите этого администратора в админке.

Что агент не умеет и что может сломаться?

Агент не умеет то, чего не позволяет сам Хорошоп, а инструменты админки могут сломаться после обновления платформы. Поэтому новые сценарии сначала запускайте на тестовом магазине.

• Хорошоп не позволяет изменить товары в уже созданном заказе, а получателя, адрес, оплату и комментарий менеджера можно.
• Отдельное фото из галереи товара удалить нельзя.
• Записи через админку под нагрузкой иногда не сохраняются. Обновление и удаление сервер повторяет до пяти раз, а пропуски попадают в отчет, поэтому после массового изменения проверьте его.
• Когда агент открывает заказ в админке, он поднимается вверх списка. Данные заказа не меняются, но предупредите менеджеров.

Кто и как подключает агента к Claude или Cursor?

Подключает технический специалист: в Claude Code это одна команда в терминале. Нужны Node.js 18 или новее, Git и отдельный администратор магазина. Его логин, пароль и адрес магазина запишите в файл stores.json в папке, куда не имеют доступа посторонние.

Команда для Claude Code:

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

Claude Desktop обходится без терминала: загрузите и откройте файл horoshop-mcp.mcpb со страницы релиза. Подключение остальных программ описывает пошаговая инструкция.

Что еще нужно, чтобы реклама магазина давала заказы?

Кроме порядка в каталоге, нужны реклама с допустимой ценой заказа и страницы, которые доводят покупателя до оформления. Мы запускаем рекламу в Meta и TikTok и работаем над конверсией сайта, карточек товаров и корзины. Бесплатный аудит разберет ваш рекламный кабинет и посчитает допустимую цену заказа.

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

Это официальный продукт Хорошоп?

Нет, это независимый проект, не связанный с компанией Хорошоп. Ошибки и пожелания принимаем в GitHub Issues. Реальных данных магазина и доступов туда не вставляйте.

Сколько стоит Хорошоп MCP?

Ничего не стоит: код открытый, лицензия MIT. Вы платите только за Хорошоп и за программу, которой пользуетесь.

Какие программы с ИИ-агентом работают с сервером?

Работает любая программа, умеющая запускать локальный MCP-сервер. Пошаговая инструкция охватывает Claude Code, Claude Desktop, Cursor, Codex, VS Code, Windsurf, Zed, Cline и другие.

Можно ли вести несколько магазинов одним подключением?

Да. Опишите все магазины в одном файле stores.json, а в запросе назовите нужный.