MCP-сервер Wildberries (search + execute)
mcp-server-wildberries
MCP-сервер Wildberries Seller API с паттерном search + execute: 235 действий вместо 235 отдельных инструментов
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- 235 действий охватывают заказы, поставки, цены и финансы, часть из них меняет данные продавца
- Отмена заказов и работа с поставками необратимы
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-server-wildberriesОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'WB_TOKEN=<ваш WB_TOKEN>' wildberries -- uvx mcp-server-wildberries==0.2.1Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"wildberries": {
"command": "uvx",
"args": [
"mcp-server-wildberries==0.2.1"
],
"env": {
"WB_TOKEN": "<ваш WB_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
WB_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"wildberries": {
"command": "uvx",
"args": [
"mcp-server-wildberries==0.2.1"
],
"env": {
"WB_TOKEN": "<ваш WB_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
WB_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"wildberries","type":"stdio","command":"uvx","args":["mcp-server-wildberries==0.2.1"],"env":{"WB_TOKEN":"<ваш WB_TOKEN>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"wildberries": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-server-wildberries==0.2.1"
],
"env": {
"WB_TOKEN": "<ваш WB_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
WB_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add wildberries --env 'WB_TOKEN=<ваш WB_TOKEN>' -- uvx mcp-server-wildberries==0.2.1Или добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.wildberries]
command = "uvx"
args = ["mcp-server-wildberries==0.2.1"]
env = { WB_TOKEN = "<ваш WB_TOKEN>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
WB_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user -e 'WB_TOKEN=<ваш WB_TOKEN>' wildberries uvx mcp-server-wildberries==0.2.1Или добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"wildberries": {
"command": "uvx",
"args": [
"mcp-server-wildberries==0.2.1"
],
"env": {
"WB_TOKEN": "<ваш WB_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
WB_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"wildberries": {
"command": "uvx",
"args": [
"mcp-server-wildberries==0.2.1"
],
"env": {
"WB_TOKEN": "<ваш WB_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
WB_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"wildberries": {
"command": "uvx",
"args": [
"mcp-server-wildberries==0.2.1"
],
"env": {
"WB_TOKEN": "<ваш WB_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
WB_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"wildberries": {
"command": "uvx",
"args": [
"mcp-server-wildberries==0.2.1"
],
"env": {
"WB_TOKEN": "<ваш WB_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
WB_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"wildberries": {
"type": "local",
"command": [
"uvx",
"mcp-server-wildberries==0.2.1"
],
"environment": {
"WB_TOKEN": "<ваш WB_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
WB_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"wildberries": {
"command": "uvx",
"args": [
"mcp-server-wildberries==0.2.1"
],
"env": {
"WB_TOKEN": "<ваш WB_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
WB_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"wildberries": {
"command": "uvx",
"args": [
"mcp-server-wildberries==0.2.1"
],
"env": {
"WB_TOKEN": "<ваш WB_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
WB_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Установи сервер командой pip install mcp-server-wildberries, подключи в Claude Code командой claude mcp add wildberries -e WB_TOKEN=токен -- mcp-server-wildberries, где токен из seller.wildberries.ru, Настройки, Доступ к API.
Другие способы из описания автора
pip install mcp-server-wildberriesУстановка пакета из README.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер построен по официальной документации Wildberries API и покрывает товары, заказы, поставки, аналитику, рекламу и финансы, 235 действий на все разделы. Вместо 235 отдельных инструментов агенту доступны три: wb_search находит действие по описанию на естественном языке, wb_execute выполняет его по id с параметрами, wb_execute_file делает то же со скачиванием файла. Такой подход экономит контекст LLM, потому что в схему попадают только три инструмента, а не сотни. Есть отдельный CLI для запуска действий без агента.
Для кого. Для продавцов на Wildberries, которым нужен агент с доступом ко всему API продавца без раздувания контекста десятками инструментов.
Подходит, если
- Нужен полный охват Wildberries Seller API в одном сервере
- Важно не раздувать контекст агента множеством схем инструментов
- Нужен CLI для тех же действий без агента, например ping или проверка токена
Не подходит, если
- Нужны заранее описанные отдельные инструменты для каждого действия, а не поиск по описанию
- Нужен доступ сразу к нескольким маркетплейсам одним сервером
Пример запроса к агенту
Найди на Wildberries действие для отмены заказа FBS и отмени заказ 12345Ограничения
Нужен токен продавца Wildberries (JWT) из личного кабинета. Версия 0.2.1, сервер молодой. Паттерн search + execute требует, чтобы агент сначала нашел id действия и только потом вызвал его, это лишний шаг по сравнению с прямыми инструментами.
Как отключить. Удалите сервер командой claude mcp remove wildberries или уберите его из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| WB_TOKEN обязательная, секрет | API-токен Wildberries (JWT) из личного кабинета продавца |
| WB_TIMEOUT | Таймаут HTTP-запросов в секундах, по умолчанию 30 |
| WB_FILE_TIMEOUT | Таймаут скачивания файлов в секундах, по умолчанию 60 |
Проверка безопасности
- 235 действий охватывают заказы, поставки, цены и финансы, часть из них меняет данные продавца
- Отмена заказов и работа с поставками необратимы
Коротко о README
README объясняет архитектуру search + execute с примером диалога LLM с сервером, дает пошаговую установку через pip или uvx для macOS, Linux и Windows, подключение к Claude Code с токеном из переменной или файла, разовое подключение через --mcp-config и таблицу переменных окружения с таймаутами.
Частые вопросы
Почему всего три инструмента вместо 235?
Сервер использует паттерн search + execute: wb_search находит нужное действие, wb_execute его выполняет, это экономит токены контекста.
Можно ли подключить сервер без сохранения в настройках Claude?
Да, через флаг --mcp-config на одну сессию, токен при этом можно держать в отдельном файле .env.mcp.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма