shopware-mcp — MCP-сервер для Shopware 6: что делает и как установить
MCP-сервер для управления магазином Shopware 6 через Claude Code и другие редакторы: товары, заказы, складские остатки, аудит витрины и прогноз продаж.
MIT ★ 18 обновлён 2026-10-18
claude mcp add --env SHOPWARE_URL=<SHOPWARE_URL> --env SHOPWARE_CLIENT_ID=<SHOPWARE_CLIENT_ID> --env SHOPWARE_CLIENT_SECRET=<SHOPWARE_CLIENT_SECRET> --env SHOPWARE_MCP_ALLOW_WRITE=<SHOPWARE_MCP_ALLOW_WRITE> --transport stdio shopware-mcp -- npx -y shopware-mcpЧто делает shopware-mcp
Сервер подключает ИИ-агента к Admin API магазина Shopware 6 и даёт двадцать инструментов вместо прямого доступа к двумстам сущностям: заказы с историей, клиенты, товары, категории, акции, отзывы, складские остатки, каналы продаж, документы. Инструмент shop_pulse сравнивает текущий день с аналогичными часами прошлых недель и показывает, нормально ли затишье или витрина сломалась. shop_audit за один вызов проверяет семнадцать точек: оплаченные заказы без отгрузки, товары без обложки или скрытые во всех каналах, акции с истёкшим сроком, задачи по расписанию, которые перестали выполняться, юридические страницы витрины, отзывы на модерации.
checkout_simulate кладёт товары и промокоды в тестовую корзину через Store API как гость или указанный клиент, применяет правила цен его группы и объясняет каждую ошибку корзины: страна вне зоны доставки канала, код с истёкшим сроком, способ оплаты, скрытый правилом, родительский товар без выбора варианта. Заказ не создаётся, корзина удаляется. sales_report и customer_report агрегируют выручку, средний чек, топ товаров и клиентов, динамику по дням и неделям с опциональным сравнением с предыдущим периодом. stock_forecast превращает скорость продаж в дни запаса и даты исчерпания остатков.
По умолчанию сервер работает только на чтение. Флаг --allow-write включает пятнадцать операций записи, каждая — сначала сухой прогон с показом точного запроса. Бюджет записи ограничивает число реальных изменений за процесс.
Какие задачи решает
- Проверить, почему за шесть часов не пришло ни одного заказа
- Найти оплаченные заказы без отгрузки или счёта
- Симулировать оформление заказа как клиент определённой группы и увидеть ошибки корзины
- Агрегировать выручку, топ товаров и средний чек за период с динамикой
- Спрогнозировать дату исчерпания товара по текущей скорости продаж
Примеры запросов агенту
- Запусти аудит магазина и покажи, что требует внимания
- Сравни сегодняшний день с аналогичными часами прошлых недель — нормальное ли затишье
- Положи товар
SW10003в корзину как клиент с IDa1b2c3d4и объясни ошибки
Как установить shopware-mcp
Командой платформы
claude mcp add --env SHOPWARE_URL=<SHOPWARE_URL> --env SHOPWARE_CLIENT_ID=<SHOPWARE_CLIENT_ID> --env SHOPWARE_CLIENT_SECRET=<SHOPWARE_CLIENT_SECRET> --env SHOPWARE_MCP_ALLOW_WRITE=<SHOPWARE_MCP_ALLOW_WRITE> --transport stdio shopware-mcp -- npx -y shopware-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add shopware-mcp --env SHOPWARE_URL=<SHOPWARE_URL> --env SHOPWARE_CLIENT_ID=<SHOPWARE_CLIENT_ID> --env SHOPWARE_CLIENT_SECRET=<SHOPWARE_CLIENT_SECRET> --env SHOPWARE_MCP_ALLOW_WRITE=<SHOPWARE_MCP_ALLOW_WRITE> -- npx -y shopware-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"shopware-mcp": {
"command": "npx",
"args": [
"-y",
"shopware-mcp"
],
"env": {
"SHOPWARE_URL": "<SHOPWARE_URL>",
"SHOPWARE_CLIENT_ID": "<SHOPWARE_CLIENT_ID>",
"SHOPWARE_CLIENT_SECRET": "<SHOPWARE_CLIENT_SECRET>",
"SHOPWARE_MCP_ALLOW_WRITE": "<SHOPWARE_MCP_ALLOW_WRITE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"shopware-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"shopware-mcp"
],
"env": {
"SHOPWARE_URL": "<SHOPWARE_URL>",
"SHOPWARE_CLIENT_ID": "<SHOPWARE_CLIENT_ID>",
"SHOPWARE_CLIENT_SECRET": "<SHOPWARE_CLIENT_SECRET>",
"SHOPWARE_MCP_ALLOW_WRITE": "<SHOPWARE_MCP_ALLOW_WRITE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SHOPWARE_URL=<SHOPWARE_URL> -e SHOPWARE_CLIENT_ID=<SHOPWARE_CLIENT_ID> -e SHOPWARE_CLIENT_SECRET=<SHOPWARE_CLIENT_SECRET> -e SHOPWARE_MCP_ALLOW_WRITE=<SHOPWARE_MCP_ALLOW_WRITE> shopware-mcp npx -y shopware-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о shopware-mcp
Как установить shopware-mcp в Claude Code?
Выполни `claude mcp add shopware-mcp -e SHOPWARE_URL=<SHOPWARE_URL> -e SHOPWARE_CLIENT_ID=<SHOPWARE_CLIENT_ID> -e SHOPWARE_CLIENT_SECRET=<SHOPWARE_CLIENT_SECRET> -- npx -y shopware-mcp`, подставив URL магазина и учётные данные интеграции OAuth.
Что делает shopware-mcp?
Даёт ИИ-агенту двадцать инструментов для работы с магазином Shopware 6: заказы, клиенты, товары, складские остатки, аудит витрины, симуляция оформления заказа как клиент, агрегированные отчёты и прогноз продаж. По умолчанию работает только на чтение.
Можно ли разрешить shopware-mcp изменять данные магазина?
Да, передай флаг --allow-write при запуске или задай переменную окружения SHOPWARE_MCP_ALLOW_WRITE=true. Каждая операция записи сначала показывается как сухой прогон, реальное изменение требует подтверждения. Бюджет записи ограничивает число операций за процесс.