МойСклад MCP
moysklad-mcp
MCP-сервер МойСклад на 60 инструментов: товары, остатки, заказы, отгрузки, приемки, платежи, отчеты по прибыли
Установка
claude mcp add moysklad --env MOYSKLAD_TOKEN=your-bearer-token -- npx -y @theyahia/moysklad-mcpЭто чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер закрывает торгово-складской цикл через JSON API 1.2 МойСклад. Агент ищет товары и контрагентов, смотрит остатки по складам, создает заказы покупателей и поставщикам, отгрузки, приемки, перемещения, инвентаризации, списания и возвраты. Есть счета, входящие и исходящие платежи, кассовые ордера, отчеты по прибыли, продажам и оборачиваемости, журнал аудита и вебхуки. Цены передаются в рублях, перевод в копейки и соблюдение лимита запросов сервер берет на себя. В репозитории лежат восемь готовых скиллов Claude Code для типовых операций склада.
Для кого. Владельцам магазинов, кладовщикам и бухгалтерам, которые ведут учет в МойСклад.
Подходит, если
- Нужно узнать остатки и резервы по товару без выгрузки в Excel
- Нужно оформить заказ покупателя и отгрузку по короткому описанию
- Нужен отчет по марже товаров за период
Не подходит, если
- Агенту нельзя доверять проведение платежей и складских документов без проверки
- Нужны вебхуки и расширенные отчеты на бесплатном тарифе МойСклад
Пример запроса к агенту
Покажи товары с остатком меньше 10 штук и их цены, потом собери отчет по прибыли за этот месяцОграничения
Нужен токен доступа МойСклад или логин и пароль, права пользователя ограничивают доступные операции. Выпуск нового токена отзывает предыдущий. Вебхуки и часть отчетов работают только на платном тарифе. В отчете get_dashboard суммы остаются в копейках. Лимитер по умолчанию консервативный, так как API может временно отключить доступ после серии ошибок 429.
Как отключить. Выполните claude mcp remove moysklad или удалите блок moysklad из конфигурации клиента, затем отзовите токен в МойСклад.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| MOYSKLAD_TOKEN секрет | Bearer-токен МойСклад, нужен он или пара логин и пароль |
| MOYSKLAD_LOGIN | Логин для Basic-авторизации |
| MOYSKLAD_PASSWORD секрет | Пароль для Basic-авторизации |
| MOYSKLAD_RATE_BUCKET | Сколько запросов разрешено в трехсекундном окне, по умолчанию 20 |
| MOYSKLAD_MAX_CONCURRENT | Максимум параллельных запросов, по умолчанию 5 |
| MOYSKLAD_HTTP_CORS_ORIGIN | Разрешенный CORS-origin для HTTP-режима |
Проверка безопасности
- Создает платежи, кассовые ордера и счета в рабочем аккаунте
- Проводит складские документы и меняет цены
- Токен дает доступ ко всем данным пользователя МойСклад
Коротко о README
README на русском дает конфигурации для Claude Desktop, Claude Code, Cursor и Windsurf и объясняет авторизацию токеном или логином с паролем. Все инструменты разбиты на группы: товары, остатки, контрагенты, заказы, складские документы, финансы, отчеты, справочники, вебхуки. Описаны переменные окружения, лимит запросов МойСклад, типичные ошибки и способы их устранить. Сервер входит в серию WWmcp. Лицензия MIT.
Частые вопросы
Где взять токен?
В МойСклад: Настройки, Пользователи, Токены доступа. Учтите, что новый токен отзывает старый.
Можно подключить по HTTP?
Да, запуск с HTTP_PORT=3000 или флагом --http 3000 открывает POST /mcp и GET /health. CORS по умолчанию выключен.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
E-Commerce Skills
E-Commerce Skills by Nexscope
Большой набор текстовых скиллов для продавцов Amazon, Shopify, eBay, Etsy, TikTok Shop и Walmart: цены, листинги, реклама, рост
153 скилла для кросс-бордер e-commerce через API LinkFox: Amazon, Ozon, TikTok Shop, 1688, ключевые слова, реклама и патенты
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки