Как подключить Shopware 6 Admin API к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Shopware 6 Admin API, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Shopware 6 Admin API + Cursor

Shopware 6 Admin API, бэк-офисный API магазина (не Store API): поиск по любой сущности, ведение товаров, категорий, макетов Shopping Experiences вплоть до отдельного слота и медиатеки, чтение каналов продаж, акций и SEO-URL. Универсальные записи, удаление и массовая синхронизация отключены при установке.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

SHOPWARE_URL, SHOPWARE_ACCESS_KEY_ID, SHOPWARE_SECRET_ACCESS_KEY

Шаг 1 — Получите учётные данные

Admin API, а не Store API: этот коннектор использует Admin API (/api) магазина Shopware 6, то есть API, через который сама Shopware Administration управляет магазином: товары, категории, макеты Shopping Experiences и медиатека. Это другой коннектор, чем Shopware 6 Store API (shopware-6), который читает публичную витрину с ключом доступа канала продаж. Устанавливайте этот, если ИИ должен работать с административными данными магазина.

Настройка занимает около 3 минут. Нужен доступ к Shopware Administration магазина.

1. В Shopware Administration откройте Settings > System > Integrations и создайте новую интеграцию.
2. Дайте ей имя и либо включите Administrator, либо назначьте роль с правами, которые должны быть у ИИ. С ролью только для чтения каждый инструмент записи завершается ошибкой 403.
3. Скопируйте Access key ID (начинается с SWIA) в SHOPWARE_ACCESS_KEY_ID, а Secret access key в SHOPWARE_SECRET_ACCESS_KEY. Секрет показывается только один раз; если он утерян, создайте в интеграции новый ключ.
4. Укажите в SHOPWARE_URL адрес магазина без пути, например https://shop.example.com. Не добавляйте /api или /admin.
5. Установите коннектор и запустите shopware_6_admin_get_version: он покажет версию Shopware и подтвердит учётные данные.

AnythingMCP получает краткоживущий bearer-токен на /api/oauth/token магазина по OAuth2 client credentials и сам его обновляет.

Что он читает: товары с полнотекстовым поиском и фильтрами (артикул, активность, остаток, производитель, категории, свойства, варианты через parentId) и один товар с его собственными полями (название, номер, остаток, цена, описание, SEO-поля, пользовательские поля); категории с родителем, позицией, типом, макетом, флагами активности и видимости и «хлебными крошками»; макеты Shopping Experiences (CMS-страницы) и один макет с его секциями, блоками и слотами, включая config каждого слота; медиатеку с URL, именем файла, alt-текстом, заголовком и папкой; каналы продаж с их доменами (ключ доступа Store API удаляется из ответа); акции с кодами, сроком действия и лимитами использования; SEO-URL. Любая другая сущность Admin API, например заказы, клиенты, производители, группы и значения свойств, правила, языки, валюты или сниппеты, читается через shopware_6_admin_search_entities и shopware_6_admin_get_entity.

Критерии поиска: каждый инструмент поиска принимает criteria Shopware: term, ids, filter (equals, equalsAny, contains, prefix, suffix, range, not, multi), sort, associations, includes, limit, page и total_count_mode; товары и универсальный поиск принимают также aggregations. Связанные поля фильтруются по путям через точку, например categories.id или manufacturer.name. ИИ передаёт includes, когда полные записи не нужны, потому что полный товар занимает много места. ID состоят из 32 шестнадцатеричных символов без дефисов; ИИ находит их инструментами поиска и никогда не угадывает.

Языки и варианты: тексты переводятся по языкам. С language_id (отправляется как заголовок sw-language-id) чтение возвращает этот перевод, а запись меняет этот перевод; без него используется системный язык магазина. Языки выводит shopware_6_admin_search_entities с сущностью language. Новые записи сначала создаются на системном языке. Варианты — это товары с parentId, они наследуют пустые поля от родительского товара; inheritance: true показывает унаследованные значения.

Что он записывает: shopware_6_admin_update_product (тексты, SEO-поля, пользовательские поля, флаг активности, остаток, распродажа, EAN, цена; цена заменяет весь прайс-лист), shopware_6_admin_add_product_property и shopware_6_admin_remove_product_property (только привязывают или отвязывают значение свойства), shopware_6_admin_create_property_option, shopware_6_admin_create_category и shopware_6_admin_update_category (включая перемещение категории в дереве), shopware_6_admin_create_cms_page, shopware_6_admin_update_cms_page (секции, блоки и слоты с id обновляются, без id добавляются, ничего не удаляется), shopware_6_admin_create_cms_block, shopware_6_admin_update_cms_slot (config заменяет config слота для этого языка), shopware_6_admin_create_media и затем shopware_6_admin_upload_media_from_url, shopware_6_admin_update_media и shopware_6_admin_create_media_folder. Эти инструменты включены при установке и меняют работающий магазин: покупатели видят изменение, как только обновится кэш магазина. Загрузка по URL требует enable_url_upload_feature Shopware (включена по умолчанию) и публичного URL и заменяет файл, который уже есть у медиазаписи.

Отключено при установке: shopware_6_admin_create_entity, shopware_6_admin_update_entity (любая сущность, включая заказы, клиентов, каналы продаж и настройки), shopware_6_admin_delete_entity (безвозвратно, зависимые записи могут удалиться вместе с ней) и shopware_6_admin_sync (массовый upsert и удаление через Sync API). Администратор рабочего пространства включает их осознанно.

Ответы: обновления, загрузки и удаления отвечают пустым 204, поэтому ИИ перечитывает запись, чтобы подтвердить изменение. Инструменты создания возвращают новую запись с её id. Списки возвращают total, data и aggregations.

Ограничения: максимум Shopware по умолчанию — 500 результатов на страницу; ИИ листает с помощью page. total_count_mode 1 возвращает точное общее число, 2 — только есть ли следующая страница.

Частые ошибки: 401 означает неверный Access key ID или секрет: скопируйте оба заново или создайте в интеграции новый ключ. 403 означает, что роли интеграции это не разрешено: включите Administrator или расширьте роль. 404 при каждом вызове обычно означает, что SHOPWARE_URL содержит /api, /admin или другой путь.

С инструментами, включёнными при установке, коннектор не создаёт и не меняет заказы, клиентов или настройки и ничего не удаляет. Медиа он загружает только по публичному URL, а не с вашего компьютера. Чтобы читать публичную витрину с ключом доступа канала продаж, используйте коннектор Shopware 6 Store API.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Shopware 6 Admin API.

Доступные инструменты

Примеры запросов

• «Найди все активные товары с остатком меньше 5 штук и покажи артикул, название и остаток.»
• «Перепиши meta title и meta description товара SW10001 на немецком и английском. Покажи мне тексты перед сохранением.»
• «Покажи макет Shopping Experiences нашей летней посадочной страницы с секциями, блоками и слотами.»
• «Загрузи изображение https://example.com/banner.jpg в медиапапку Banners и задай ему alt-текст.»
• «Какие акции сейчас активны, с их кодами и сроками действия?»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot