Вкратце
Коммерческий MCP-сервер для интеграции AI с МойСклад: товары, услуги, контрагенты, документы продажи/закупки/перемещения, остатки в реальном времени, отчёты.
Источник данных: МойСклад . Atomno MCP не аффилирован с провайдером.
Установка
Один сниппет — поддержка Cursor, Claude Desktop, Claude Code, Cline, Continue.
Добавьте в ~/.cursor/mcp.json (или .cursor/mcp.json в проекте):
{
"mcpServers": {
"atomno-moysklad": {
"command": "uvx",
"args": ["atomno-mcp-moysklad"],
"env": {
"MCP_MOYSKLAD_API_KEY": "<your-value>",
"MCP_MOYSKLAD_TOKEN": "<your-value>"
}
}
}
}
Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"atomno-moysklad": {
"command": "uvx",
"args": ["atomno-mcp-moysklad"],
"env": {
"MCP_MOYSKLAD_API_KEY": "<your-value>",
"MCP_MOYSKLAD_TOKEN": "<your-value>"
}
}
}
}В терминале (Claude Code CLI):
claude mcp add atomno-moysklad -- uvx atomno-mcp-moysklad -e MCP_MOYSKLAD_API_KEY=<your-value> -e MCP_MOYSKLAD_TOKEN=<your-value>
Для Cline (VS Code) — в cline_mcp_settings.json.
Для Continue — в ~/.continue/config.yaml:
{
"mcpServers": {
"atomno-moysklad": {
"command": "uvx",
"args": ["atomno-mcp-moysklad"],
"env": {
"MCP_MOYSKLAD_API_KEY": "<your-value>",
"MCP_MOYSKLAD_TOKEN": "<your-value>"
}
}
}
}Конфигурация (переменные окружения)
| Переменная | Описание | Где взять | Required | Default |
|---|---|---|---|---|
| MCP_MOYSKLAD_API_KEY | API key Atomno MCP hosted MCP | Sales-команда (после demo) | yes | — |
| MCP_MOYSKLAD_TOKEN | Токен МойСклад (Bearer) | МойСклад → Настройки → API | yes | — |
| MCP_MOYSKLAD_LOG_LEVEL | Уровень логирования | — | no | INFO |
Инструменты MCP-сервера
Сервер регистрирует 4 инструмента для AI-агента. Все входные данные строго проверяются.
list_products async tool Список товаров с фильтрами.
filter?: dict, limit?: int list[Product] get_stock async tool Остатки товаров на складах.
product_id?: str, warehouse_id?: str list[Stock { product, warehouse, quantity, reserve }] create_demand async tool Создать документ продажи.
counterparty_id: str, items: list, warehouse_id: str Demand create_supply async tool Создать документ закупки.
counterparty_id: str, items: list, warehouse_id: str Supply Тарифы
Размещение на нашей стороне, установка в вашем контуре или корпоративная лицензия — выберите формат. Все тарифы включают тестовый доступ для отладки и боевой адрес подключения.
Облачный
До 5000 запросов в месяц. 1 аккаунт МойСклад.
- 5 000 запросов в месяц
- 1 аккаунт МойСклад
- Поддержка по почте
- Журнал аудита 30 дней
Облачный: Бизнес
До 25 000 запросов в месяц. До 5 аккаунтов. Уведомления о событиях.
- 25 000 запросов в месяц
- До 5 аккаунтов
- Уведомления о событиях (webhooks)
- Поддержка в Telegram
- Журнал аудита 1 год
Установка в контур
Установка в контур клиента. Без лимитов.
- Без лимитов
- Установка в контур
- Разработка под вас
- Поддержка 24/7
- Доступность 99,9%
Примеры использования
Реальные запросы для AI-агента в Cursor / Claude Code:
- list_products: «Используй mcp-moysklad инструмент
list_productsи список товаров с фильтрами.» - get_stock: «Используй mcp-moysklad инструмент
get_stockи остатки товаров на складах.» - create_demand: «Используй mcp-moysklad инструмент
create_demandи создать документ продажи.»
Решение проблем
1. uvx не найден
Установите uv: pipx install uv (или pip install uv).
После этого uvx доступен в PATH.
2. MCP не подцепился в Cursor
Проверьте: ~/.cursor/mcp.json — валидный JSON. Перезапустите Cursor полностью
(Quit, не просто закрытие окна). В Settings → MCP должна появиться зелёная точка.
3. Ошибка авторизации (401 / 403)
Проверьте переменные окружения MCP_MOYSKLAD_API_KEY, MCP_MOYSKLAD_TOKEN.
Они должны быть доступны в окружении процесса Cursor (часто требует перезапуска IDE
после установки переменных).
Полное руководство по решению проблем → /docs/troubleshooting
FAQ
Как установить mcp-moysklad? +
Какой Python нужен? +
Что нужно настроить перед запуском? +
Это открытый код? +
Где сообщить об ошибке? +
Запросить демо
mcp-moysklad — коммерческий сервер с размещением на нашей стороне. Тестовый доступ для разработки бесплатный. Боевой доступ — после демо и обсуждения нагрузки.
Changelog
Версия пока не опубликована — проект в активной разработке. Полная история — GitHub Releases.
Исходный код и задачи
- GitHub: atomno-mcp/mcp-moysklad
- Issues: atomno-mcp/mcp-moysklad/issues
- Discussions: atomno-mcp/mcp-moysklad/discussions
Правовая оговорка
Atomno MCP не аффилирован с МойСклад. mcp-moysklad использует публичные / коммерческие интерфейсы источника. Ответственность за соблюдение лимитов и условий использования источника — на пользователе. Лицензия: Коммерческая (Atomno MCP).