moysklad-mcp-ru · alpha

МойСклад прямо в чате

Подключает ИИ-ассистента напрямую к вашему МойСклад через JSON API 1.2. Остатки, товары, заказы, контрагенты, документы и отчёты приходят из ответа МойСклад с указанием источника, а не выдумываются. Складской учёт становится обычным разговором на русском.

Открытый код · MIT · 32 инструмента поверх JSON API 1.2, ядро выверено на реальном аккаунте МойСклад
откуда берётся цифра

«Сколько у меня на складе?»

Обычный ассистент ответит уверенно и правдоподобно — и назовёт остаток из воздуха. Спросите его дважды и получите два разных ответа:

412 380 445

Модель не смотрит в базу — она достраивает похоже выглядящую цифру. Для решения о закупке, отгрузке или инвентаризации на такой цифре опираться нельзя. А ручная выгрузка из МойСклад каждый раз отнимает время.

Здесь цифра берётся из ответа МойСклад по JSON API 1.2 — с методом и полем, из которого она пришла. Не пересказ, не догадка.

Почему это не обёртка вокруг чата

«Подключите AI к складу» обычно значит чат, который уверенно врёт цифрами или норовит поменять данные без спроса. Здесь три принципа против этого.

Цифры из JSON API 1.2

Остатки, товары, заказы, контрагенты, документы и отчёты приходят из ответа МойСклад с указанием источника и полей. Суммы аккуратно переводятся из копеек в рубли. Не пересказ и не «прикидка» модели.

Двойной safety-гейт на запись

Создание и проведение документов (ms_create_document, ms_post_document) выключены по умолчанию. Чтобы включить, нужен и флаг MOYSKLAD_ALLOW_WRITE=1, и явное подтверждение. Случайно провести отгрузку не выйдет.

Один токен, всё локально

Обращение идёт по одному токену доступа напрямую в API. Никаких браузерных сценариев и капч. Токен лежит локально у вас и в чат не попадает.

Готовые сценарии, а не только сырой API

Внутри 32 инструмента поверх JSON API 1.2 МойСклад. Поверх них — пошаговые сценарии под ежедневные задачи склада и продаж: с трактовкой результата и типичными ошибками.

Остатки по складам

Показывает остатки по складам (ms_get_stock) и ассортимент (ms_get_products) — что и где лежит, чего мало, что пора дозаказать.

Остатки и товары — из API, а не на глаз.
остатки по складам

Заказы и контрагенты

Собирает заказы покупателей (ms_get_orders) и сопоставляет с контрагентами (ms_get_counterparties) — кто заказал, на какую сумму, что в работе.

Заказы и контрагенты — из ответа МойСклад.
заказы покупателей

Документы и отчёты

Достаёт приёмки, отгрузки, счета и возвраты (ms_get_documents) и считает прибыль и обороты (ms_get_profit, ms_get_turnover) за период.

Документы и отчёты тянутся из кабинета, свод — кодом.
прибыль и обороты

Как пользоваться: скажите обычными словами

Запоминать методы не нужно. Опишите задачу по-русски, агент подберёт нужный инструмент или сценарий и проведёт по шагам, спросив, чего не хватает. Не помните название метода — есть поиск по-русски (ms_search_methods).

Остатки и товары

покажи остатки по всем складам каких товаров осталось меньше десяти

Заказы и контрагенты

какие заказы покупателей за эту неделю сколько мне должен контрагент «Ромашка»

Документы и отчёты

покажи отгрузки за прошлый месяц посчитай прибыль и обороты за квартал

Не уверены, с чего начать

что ты умеешь по моему МойСклад найди метод про возвраты поставщику

Совет: первым делом скажите «что ты умеешь по моему МойСклад» — агент покажет готовые сценарии. Несколько аккаунтов (мультикабинет) подключаются и переключаются прямо из чата.

Установка

Несколько способов, результат один. От вас нужен только один токен доступа МойСклад — зависимости ставятся сами при первом запуске.

Claude Desktop — в один клик

Скачайте .mcpb из GitHub Releases и дважды кликните. Claude Desktop сам поставит расширение и спросит токен. Без терминала и Gatekeeper.

Для разработчиков — uvx

uvx moysklad-mcp-ru запускает сервер прямо из PyPI. Ручной запуск из репозитория — командой python3 serve.py ms.

Попросить своего ИИ — без терминала

Откройте Claude или Cowork и скажите «установи МойСклад MCP». Агент проведёт по встроенному скиллу установки. В Claude Code ставится полностью сам.

Claude Desktop — .mcpb Claude Code / Cowork — родной Codex — mcp add Cursor Gemini — GEMINI.md

Где взять токен: МойСклад → Настройки → Пользователи → Токены доступа. Токен кладётся в MOYSKLAD_TOKEN. Запись документов дополнительно требует MOYSKLAD_ALLOW_WRITE=1. Токен хранится локально (chmod 600), в репозиторий и в чат не попадает.

открытый проект

Это всё в опен-сорсе. Берите, форкайте, улучшайте.

Открытый инструмент для складского учёта в МойСклад под MIT: проверенное вручную ядро (остатки, товары, заказы, контрагенты, документы, отчёты) выверено на реальном аккаунте, запись документов защищена двойным safety-гейтом и выключена по умолчанию. Поставьте звезду, чтобы проект нашли другие. Нашли косяк или есть идея — заводите issue.

github.com/ilyautov/moysklad-mcp-ru