moysklad-mcp-ru
MCP-сервер для JSON API 1.2 МойСклад: остатки, заказы, отчеты о прибыли и создание документов за двумя уровнями защиты
Установка
uvx moysklad-mcp-ruЗапуск из PyPI без установки. Проверка: moysklad-mcp-ru doctor.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту прямой доступ к аккаунту МойСклад без браузера. Типизированные инструменты читают остатки, товары, заказы, контрагентов, документы и отчеты о прибыли, оборотах и деньгах, суммы приходят в рублях. Для остального API есть мета-инструменты: поиск метода в каталоге, построенном по официальной документации, его описание и вызов. Запись документов вроде приемок, отгрузок, счетов и возвратов по умолчанию выключена: документ создается черновиком, а проведение и удаление требуют отдельного подтверждения. Поддерживается несколько кабинетов с переключением из чата.
Для кого. Предпринимателям, кладовщикам и бухгалтерам, которые ведут учет в МойСклад.
Подходит, если
- Нужно посмотреть остатки и понять, что пора дозаказать
- Нужен отчет о прибыли по товарам за месяц
- Нужно найти контрагентов с задолженностью
- Нужно подготовить черновик приемки или заказа поставщику
Не подходит, если
- Нет тестового кабинета, а запись нужно сразу включить на рабочем учете
- Нужна замена бухгалтера, а не помощник по операционке
Пример запроса к агенту
Покажи остатки на основном складе и что пора дозаказать, потом вытащи прибыль по товарам за прошлый месяцОграничения
Проект в статусе alpha. Нужен токен доступа МойСклад. Методы, импортированные из документации, проверены только по путям, тела запросов на запись нужно сверять с документацией. Автор советует включать запись только на тестовом кабинете. Активный кабинет из локального хранилища важнее переменных окружения, это частая причина ошибки 401.
Как отключить. Удалите сервер из конфигурации клиента или плагин moysklad-mcp-ru через /plugin. Токены лежат в ~/.moysklad-mcp/cabinets.json, отзовите их в настройках МойСклад.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| MOYSKLAD_ALLOW_WRITE | Включает запись, по умолчанию выключена |
| MOYSKLAD_WRITE_CABINETS | Ограничивает запись указанными кабинетами |
Проверка безопасности
- При включенной записи создает, проводит и удаляет документы, которые двигают остатки и деньги
- Хранит токены доступа к учету нескольких компаний
Коротко о README
README на русском с английской версией описывает типизированные и мета-инструменты, каталог методов по документации МойСклад и модель безопасности с разделением на чтение, запись и разрушающие операции. Предложено несколько путей установки: попросить агента через встроенный скилл установки, запустить установщик двойным кликом, install.py под конкретный клиент или uvx. Отдельно разобраны перевод копеек в рубли, лимиты API и оговорки альфа-версии. Есть манифесты плагинов для Claude Code, Codex и Cursor и расширение Gemini CLI. Лицензия MIT.
Частые вопросы
Как включить создание документов?
Нужно задать MOYSKLAD_ALLOW_WRITE=1, при желании ограничить кабинеты через MOYSKLAD_WRITE_CABINETS, и в каждом вызове передать confirm_write. Проведение и удаление требуют еще одного флага подтверждения.
Где взять токен?
В МойСклад в разделе настроек пользователей, пункт токенов доступа. Сервер хранит его локально в ~/.moysklad-mcp/cabinets.json.
Похожие
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Официальный MCP-сервер и скиллы CCXT: рыночные данные, балансы и торговля по выбору на криптобиржах и рынках предсказаний
Плагины со скиллами для анализа акций, отчетностей, опционов и стартапов плюс чтение соцсетей и рыночных данных
Скиллы и MCP-сервер для опционных трейдеров: котировки, технический анализ, греки, спреды, сканеры и портфель Interactive Brokers