WB MCP Server

Установка

Работает в

• Claude Code
• Claude Desktop
• Cursor
• Windsurf
• VS Code
• GitHub Copilot
• Cline
• Gemini CLI
• Codex
• SourceCraft
• Koda
• Coddy

Сервисы

• Wildberries

Ручная установка

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": ["wb-mcp-server"],
      "env": {
        "WB_API_TOKEN": "your Wildberries API token",
        "DATA_DIR": "~/.wb-mcp"
      }
    }
  }
}

Что делает

Сервер покрывает большую часть Seller API Wildberries: карточки товаров и карточки с ошибками, цены и скидки, акции, рекламные кампании со ставками и минус-фразами, аналитику и воронку продаж, сборочные задания FBS и DBS, поставки FBW с коэффициентами приемки, склады и остатки, отчеты о реализации, отзывы, вопросы и чаты с покупателями. Каждый вызов принимает shop_id, поэтому несколько кабинетов доступны в одном диалоге. В Docker-режиме есть веб-панель со статистикой вызовов, добавлением магазинов и диагностикой токенов и API WB, которая замечает, когда метод, работавший раньше, начал стабильно падать. Токены магазинов хранятся зашифрованными.

Для кого. Для продавцов и менеджеров Wildberries, которые ведут один или несколько кабинетов и хотят управлять ими словами.

Пример запроса к агенту

Какие мои карточки заблокированы и почему? И на каких складах сейчас коэффициент приемки 0 или 1?

MCP

Транспорт

stdio

Авторизация

не нужна

Ограничения

Нужен токен Seller API Wildberries, он действует 180 дней, права на запись выдаются отдельно. У WB жесткие лимиты: часть методов допускает несколько запросов в минуту, ответ 4XX считается за десять запросов, а все кабинеты на одном сервере делят лимит одного IP. Веб-интерфейс не закрыт токеном и не должен быть доступен из интернета, HTTPS сервер не терминирует. Ключ шифрования лежит рядом с данными. Автор развивает сервер под свои задачи.

Как отключить. Выполните claude mcp remove wildberries или удалите блок из конфигурации клиента, для Docker остановите docker compose down. Токен WB отзовите в портале продавца.

Коротко о README

README на английском, русском и китайском описывает разделы Seller API и число инструментов в каждом, полный список вынесен в docs/tools.md. Показаны два пути: запуск через uvx или pip со stdio и Docker с веб-панелью и SSE. Для одиннадцати клиентов есть отдельные инструкции на русском. Большой раздел посвящен мультикабинету, лимитам WB, хранению токенов и тому, чего сервер не защищает. Лицензия MIT.