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, а в запиті назвіть потрібний.