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, код відкритий. Ви платите лише за свій тариф Хорошопу і за ШІ-клієнт, яким користуєтеся.

Далі