ilyautov/moysklad-mcp-ru

> 🇬🇧 English version
>
> **Ведёте учёт в МойСклад — дайте ИИ прямой доступ к вашему аккаунту.** Один
> MCP-сервер над JSON API 1.2 МойСклад: остатки, товары, заказы, контрагенты,
> отчёты (прибыль, обороты, деньги) и **запись документов** (приёмки, отгрузки,
> заказы, счета, возвраты) — напрямую по API, без браузера. Числа приходят из
> **реального API**, а не выдумываются моделью. **Два гейта на запись** не дают
> случайно создать или провести документ в боевом учёте. Авто-пагинация,
> мультикабинет, поиск по-русски. Для Claude Code, Cursor, Codex, Cowork и Claude
> Desktop.
**Быстрый старт**, без установки в систему:
Клиенты, токен и способ «попроси своего ИИ поставить»: в разделе «Установка».
> ⚠️ **alpha.** Помогает с операционкой учёта, но это инструмент, а не замена
> бухгалтера. Курированное ядро и срез записи выверены боем на тестовом кабинете;
> импортированные из доки методы — карта для разведки (пути надёжны, тела
> write-запросов сверяйте по доке или зовите через raw-инструменты). Подробности — в
> разделе «Оговорки».
Зачем это нужно
Учёт живёт в МойСклад, а ИИ-ассистент обычно бесполезен: либо ходит через браузер
и спотыкается, либо выдумывает цифры, которые звучат уверенно. moysklad-mcp-ru
даёт агенту **прямой доступ к JSON API 1.2** вашего аккаунта:
- **Числа из реального API, а не из головы модели.** Остатки, заказы, прибыль,
обороты — это ответ МойСклад, с источником и полями.
- **Запись за двумя гейтами.** Создание документа делает ЧЕРНОВИК; проведение
(двигает учёт) — отдельный destructive-шаг с подтверждением. Запись вообще
выключена, пока её явно не включить и не направить на тестовый кабинет.
- **Без браузера.** Прямые HTTPS-вызовы по токену кабинета.
Скажите агенту обычными словами: «покажи остатки», «что пора дозаказать»,
«создай приёмку на 10 Рога от поставщика» — он подберёт метод или сценарий.
Что внутри
**Не «один тул на эндпоинт», а 10 generic мета-тулов над каталогом** — полное
покрытие API при маленькой поверхности.
**Мета-тулы** (ms_search_methods, ms_describe_method, ms_call_method,
ms_write_method, ms_delete_method, ms_get_raw, ms_write_raw,
ms_delete_raw, ms_fetch_all, ms_map, + тулы кабинетов).
**Типизированные read-тулы:** ms_get_stock, ms_get_products, ms_get_orders,
ms_get_profit, ms_get_money, ms_get_turnover, ms_get_counterparties,
ms_get_stores, ms_get_documents (7 типов), ms_ping. Копейки автоматически
переводятся в рубли.
**Тулы записи (за двумя гейтами):**
| Тул | Уровень | Назначение |
|---|---|---|
| ms_build_document | read | Preview ЛЮБОГО типа: резолв ссылок + точное тело, БЕЗ записи. |
| ms_create_document | write | Создать ЛЮБОЙ ролевой тип ЧЕРНОВИКОМ (applicable:false). |
| ms_build_purchaseorder / ms_create_purchaseorder | read / write | Типизированный заказ поставщику (для совместимости). |
| ms_post_document | destructive | Провести документ (applicable:true) — двигает учёт. |
| ms_delete_document | destructive | Удалить документ (уборка). |
7 ролевых типов: purchaseorder, supply, demand, invoicein, invoiceout,
salesreturn, purchasereturn.
**Каталог — schema-driven из официальной доки МойСклад:** 892 метода (курированное
ядро выверено живьём; остальное импортировано из доки). ms_get_raw достаёт всё,
чего ещё нет в каталоге.
Что можно спросить
Не уверены, с чего начать — скажите **«что ты умеешь по моему кабинету»** или
вызовите ms_map.
Safety model
Токен кабинета двигает остатки и деньги. Каждый метод классифицирован:
- **read** → выполняется сразу;
- **write** (создать черновик) → требует confirm_write=true **И** включённой