Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Shopware 6 Admin API одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Shopware 6 Admin API, бэк-офисный API магазина (не Store API): поиск по любой сущности, ведение товаров, категорий, макетов Shopping Experiences вплоть до отдельного слота и медиатеки, чтение каналов продаж, акций и SEO-URL. Универсальные записи, удаление и массовая синхронизация отключены при установке.
Попробуй спросить
Примеры промптов для Shopware 6 Admin API
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Shopware 6 Admin API, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Shopware 6 Admin API
Shopware 6 Admin API, бэк-офисный API магазина (не Store API): поиск по любой сущности, ведение товаров, категорий, макетов Shopping Experiences вплоть до отдельного слота и медиатеки, чтение каналов продаж, акций и SEO-URL. Универсальные записи, удаление и массовая синхронизация отключены при установке.
Настройка
Admin API, а не Store API: этот коннектор использует Admin API (/api) магазина Shopware 6, то есть API, через который сама Shopware Administration управляет магазином: товары, категории, макеты Shopping Experiences и медиатека. Это другой коннектор, чем Shopware 6 Store API (shopware-6), который читает публичную витрину с ключом доступа канала продаж. Устанавливайте этот, если ИИ должен работать с административными данными магазина.
Настройка занимает около 3 минут. Нужен доступ к Shopware Administration магазина.
- В Shopware Administration откройте Settings > System > Integrations и создайте новую интеграцию.
- Дайте ей имя и либо включите Administrator, либо назначьте роль с правами, которые должны быть у ИИ. С ролью только для чтения каждый инструмент записи завершается ошибкой 403.
- Скопируйте Access key ID (начинается с
SWIA) вSHOPWARE_ACCESS_KEY_ID, а Secret access key вSHOPWARE_SECRET_ACCESS_KEY. Секрет показывается только один раз; если он утерян, создайте в интеграции новый ключ. - Укажите в
SHOPWARE_URLадрес магазина без пути, напримерhttps://shop.example.com. Не добавляйте/apiили/admin. - Установите коннектор и запустите
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.
Предварительные требования: SHOPWARE_URL, SHOPWARE_ACCESS_KEY_ID, SHOPWARE_SECRET_ACCESS_KEY
Локальная установка коннектора
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
Откройте http://localhost:3000/connectors/store, выберите Shopware 6 Admin API и введите переменные, перечисленные в Предварительных требованиях.
Доступные инструменты
| Tool | What it does |
|---|---|
shopware_6_admin_get_version | Read the Shopware version of the instance |
shopware_6_admin_search_products | Search products with Shopware criteria: free text, filters (productNumber, active, stock, manufacturerId, categories.id, properties.id… |
shopware_6_admin_get_product | Read one product by id with its own fields (name, productNumber, stock, price, active, description, SEO fields, customFields) |
shopware_6_admin_update_product | Change fields of one product in the live shop: texts and SEO fields (written in the language of language_id), custom fields, active flag… |
shopware_6_admin_add_product_property | Assign an existing property option (e.g |
shopware_6_admin_remove_product_property | Unassign a property option from a product |
shopware_6_admin_create_property_option | Create a new option in a property group (e.g. a new color value) |
shopware_6_admin_search_categories | Search categories with Shopware criteria, e.g. filter parentId for the children of a category, or level / active |
shopware_6_admin_create_category | Create a category in the live catalog tree: a page, a folder (structure only) or a link |
shopware_6_admin_update_category | Change one category in the live shop: name, texts and SEO fields (in the language of language_id), active / visible, layout, or its place… |
shopware_6_admin_search_cms_pages | Search Shopping Experiences layouts (CMS pages) with Shopware criteria, e.g. filter type landingpage / page / product_list /… |
shopware_6_admin_get_cms_page | Read one layout (CMS page) with its sections, blocks and slots sorted by position, including each slot's id, type and config (texts, media… |
shopware_6_admin_create_cms_page | Create a layout (CMS page), optionally with its sections, blocks and slots nested in one call |
shopware_6_admin_update_cms_page | Change a layout in the live shop: rename it, or update and add sections with their blocks and slots |
shopware_6_admin_create_cms_block | Add a block (e.g. text, image, image-text, product-listing) with its slots to an existing section of a layout |
shopware_6_admin_update_cms_slot | Change the content of one slot in the live shop, e.g. the HTML of a text element or the media of an image element, in the language of… |
shopware_6_admin_search_media | Search the media library with Shopware criteria, e.g. filter mediaFolderId, fileName, mimeType, or term |
shopware_6_admin_create_media | Create an empty media entry (no file yet) in the media library, optionally in a folder |
shopware_6_admin_upload_media_from_url | Have Shopware download a file from a public URL into a media entry (created with shopware_6_admin_create_media) |
shopware_6_admin_update_media | Change the alt text, title, folder or custom fields of a media entry in the live shop (alt and title in the language of language_id) |
shopware_6_admin_create_media_folder | Create a folder in the media library |
shopware_6_admin_search_sales_channels | Search sales channels (storefronts, headless channels) with Shopware criteria: name, type, active, maintenance, navigation / footer /… |
shopware_6_admin_search_promotions | Search promotions with Shopware criteria, e.g. filter active or code; associations {"discounts":{},"salesChannels":{}} add the discount… |
shopware_6_admin_search_seo_urls | Search SEO URLs with Shopware criteria, e.g. filter foreignKey (a product or category id), routeName (frontend.detail.page… |
shopware_6_admin_search_entities | Search any Admin API entity with Shopware criteria, e.g. order, customer, product-manufacturer, property-group, property-group-option… |
shopware_6_admin_get_entity | Read one record of any Admin API entity by id, e.g. order, customer, category, cms-slot, media, promotion |
shopware_6_admin_create_entity | Create one record of any Admin API entity, e.g. a cms-section, snippet, product-manufacturer or a product |
shopware_6_admin_update_entity | Change fields of one record of any Admin API entity in the live shop (orders, customers, sales channels, settings included) |
shopware_6_admin_delete_entity | Delete one record of any Admin API entity by id, e.g. a cms-block, a product or a media entry |
shopware_6_admin_sync | Bulk write: upsert or delete many records of one or more entities in a single request through the Sync API |
Примеры запросов
- «Найди все активные товары с остатком меньше 5 штук и покажи артикул, название и остаток.»
- «Перепиши meta title и meta description товара SW10001 на немецком и английском. Покажи мне тексты перед сохранением.»
- «Покажи макет Shopping Experiences нашей летней посадочной страницы с секциями, блоками и слотами.»
- «Загрузи изображение https://example.com/banner.jpg в медиапапку Banners и задай ему alt-текст.»
- «Какие акции сейчас активны, с их кодами и сроками действия?»
Следующие шаги
Это руководство помогло?