# shopware-mcp

MCP-сервер для управления магазином Shopware 6 через Claude Code и другие редакторы: товары, заказы, складские остатки, аудит витрины и прогноз продаж.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18 у репозитория
- Автор: bnymnDev
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/bnymnDev/shopware-mcp
- Обновлён: 2026-10-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/shopware-mcp

## Что делает

Сервер подключает ИИ-агента к Admin API магазина Shopware 6 и даёт двадцать инструментов вместо прямого доступа к двумстам сущностям: заказы с историей, клиенты, товары, категории, акции, отзывы, складские остатки, каналы продаж, документы. Инструмент `shop_pulse` сравнивает текущий день с аналогичными часами прошлых недель и показывает, нормально ли затишье или витрина сломалась. `shop_audit` за один вызов проверяет семнадцать точек: оплаченные заказы без отгрузки, товары без обложки или скрытые во всех каналах, акции с истёкшим сроком, задачи по расписанию, которые перестали выполняться, юридические страницы витрины, отзывы на модерации.

\`checkout_simulate` кладёт товары и промокоды в тестовую корзину через Store API как гость или указанный клиент, применяет правила цен его группы и объясняет каждую ошибку корзины: страна вне зоны доставки канала, код с истёкшим сроком, способ оплаты, скрытый правилом, родительский товар без выбора варианта. Заказ не создаётся, корзина удаляется. `sales_report` и `customer_report` агрегируют выручку, средний чек, топ товаров и клиентов, динамику по дням и неделям с опциональным сравнением с предыдущим периодом. `stock_forecast` превращает скорость продаж в дни запаса и даты исчерпания остатков.

По умолчанию сервер работает только на чтение. Флаг `--allow-write` включает пятнадцать операций записи, каждая — сначала сухой прогон с показом точного запроса. Бюджет записи ограничивает число реальных изменений за процесс.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `SHOPWARE_URL`, `SHOPWARE_CLIENT_ID`, `SHOPWARE_CLIENT_SECRET`, `SHOPWARE_MCP_ALLOW_WRITE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- Проверить, почему за шесть часов не пришло ни одного заказа
- Найти оплаченные заказы без отгрузки или счёта
- Симулировать оформление заказа как клиент определённой группы и увидеть ошибки корзины
- Агрегировать выручку, топ товаров и средний чек за период с динамикой
- Спрогнозировать дату исчерпания товара по текущей скорости продаж

## Примеры запросов агенту
- Запусти аудит магазина и покажи, что требует внимания
- Сравни сегодняшний день с аналогичными часами прошлых недель — нормальное ли затишье
- Положи товар `SW10003` в корзину как клиент с ID `a1b2c3d4` и объясни ошибки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
