moysklad-mcp

io.github.theYahia由 GitHub 帳號 theYahia 發布v3.0.1更新於 Oct 24, 2026

MCP server for MoySklad — warehouse, inventory, orders, reports (Russia)

已驗證STDIO僅桌面金融資料與分析商業與電商

概覽

AI 產生的概覽

針對俄羅斯 MoySklad（庫存/ERP）的 MCP 伺服器，讓助理查詢商品、庫存、訂單、單據、收付款與報表。

可以做什麼
  • 搜尋並建立商品、服務、變體、套裝與價格類型，更新價格
  • 查詢整體庫存與各倉庫庫存
  • 查找並建立往來對象（客戶與供應商）
  • 建立並追蹤客戶訂單、供應商訂單、出貨、進貨與退貨
  • 建立調撥、入庫、核銷與盤點等倉庫單據
  • 建立收付款、現金單據與發票，並取得利潤、銷售、週轉、資金與儀表板報表
適用情境
適合讓助理直接回答 MoySklad 帳戶中的庫存數量、毛利或週轉問題，或代為完成訂單、出貨、收付款等日常貿易與倉庫單據作業，而不必匯出到試算表。
執行需求
透過 npx 在本機執行（Node 18 以上；測試需 Node 20）。需要 MoySklad 帳戶，並在 MOYSKLAD_TOKEN 提供 bearer 權杖，或提供 MOYSKLAD_LOGIN 與 MOYSKLAD_PASSWORD。使用者或權杖需對所用實體具備檢視或編輯權限；webhook 與部分報表需要付費方案。需能存取 MoySklad JSON API 1.2。
安裝前請注意
伺服器以所提供權杖或登入帳號的完整權限運作，許多工具會建立和修改真實業務單據（訂單、出貨、收付款、核銷、webhook），並可刪除 webhook。產生新權杖會使舊權杖失效。可選的 HTTP 傳輸以你的權杖身分執行，啟用 MOYSKLAD_HTTP_CORS_ORIGIN 會將其暴露給瀏覽器來源。業務資料會傳送至 MoySklad 的 API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 moysklad-mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

MCP-сервер для МойСклад — 60 инструментов для ИИ-агента: товары, склад, заказы, финансы

Если вы искали, как подключить МойСклад к Claude или другому ИИ-агенту, — этот сервер закрывает весь торгово-складской цикл через JSON API 1.2: каталог и цены, остатки по складам, контрагенты, заказы покупателей и поставщикам, отгрузки, приёмки, перемещения, инвентаризации, списания, возвраты, счета, платежи и касса, отчёты по прибыли и оборотам, аудит и вебхуки. Спрашиваете «сколько футболок свободно к продаже» или «какая маржа по каждому товару за август» — получаете таблицу с цифрами, а не выгрузку в Excel. Цены во всех инструментах в рублях (перевод в копейки, которых требует API МойСклад, сервер делает сам), лимит запросов соблюдается автоматически.

[npm] [license]

[Демонстрация: вопрос «сколько футболок на складе и сколько из них в резерве» — агент вызывает get_stock и отвечает таблицей остатков и резервов]

Часть WWmcp — набора MCP-серверов для развивающихся рынков.

Быстрый старт

Claude Desktop

Добавьте в claude_desktop_config.json:

json
{  "mcpServers": {    "moysklad": {      "command": "npx",      "args": ["-y", "@theyahia/moysklad-mcp"],      "env": {        "MOYSKLAD_TOKEN": "your-bearer-token"      }    }  }}

Чтобы использовать логин и пароль вместо токена, замените блок env на:

json
"env": { "MOYSKLAD_LOGIN": "[email protected]", "MOYSKLAD_PASSWORD": "your-password" }

Claude Code

bash
claude mcp add moysklad --env MOYSKLAD_TOKEN=your-bearer-token -- npx -y @theyahia/moysklad-mcp

Cursor / Windsurf

Добавьте в настройки MCP:

json
{  "moysklad": {    "command": "npx",    "args": ["-y", "@theyahia/moysklad-mcp"],    "env": { "MOYSKLAD_TOKEN": "your-bearer-token" }  }}

Авторизация

ПеременнаяОписание
MOYSKLAD_TOKENBearer-токен (предпочтительно)
MOYSKLAD_LOGIN + MOYSKLAD_PASSWORDHTTP Basic-авторизация

Токен выдаётся в МоёмСкладе: Настройки → Пользователи → Токены доступа (также работает POST /security/token с Basic-авторизацией). Генерация нового токена отзывает предыдущий.

Нужные права: у пользователя или токена должен быть доступ к тем сущностям, с которыми вы работаете. Читающим инструментам нужны права просмотра, создающим и изменяющим — права редактирования соответствующего типа документов. Вебхуки и часть отчётов требуют платного тарифа МойСклад.

Цены

API МойСклад хранит деньги в копейках (1 рубль = 100 копеек). Сервер конвертирует автоматически:

  • На вход: передавайте цены и суммы в рублях (например, 1500.50)
  • На выход: цены и суммы возвращаются в рублях
  • (Отчёт get_dashboard проксируется как есть, поэтому денежные значения в нём остаются в копейках.)

Если у товара есть цена продажи, МойСклад требует тип цены. Сервер сам подставляет тип цены по умолчанию из вашего аккаунта (берёт из list_price_types); чтобы выбрать конкретный, передайте price_type_href.

Инструменты (60)

Товары и каталог

ИнструментОписание
search_productsПоиск товаров по названию или артикулу
get_productТовар по UUID (raw — полный объект)
create_productСоздать товар (тип цены подставляется автоматически)
update_pricesОбновить цены продажи, закупки и минимальную
search_assortmentСквозной поиск по товарам, модификациям, услугам и комплектам
list_price_typesТипы цен (первый — по умолчанию)
search_variants / search_bundles / search_servicesПоиск модификаций / комплектов / услуг
create_serviceСоздать услугу

Остатки

ИнструментОписание
get_stockТекущие остатки (количество, резерв, в пути)
get_stock_by_storeОстатки в разрезе складов
get_stock_currentБыстрый срез текущих остатков

Контрагенты

ИнструментОписание
get_counterpartiesПоиск по названию, ИНН или телефону
get_counterpartyПолная карточка (raw — полный объект)
create_counterpartyСоздать покупателя или поставщика

Заказы и отгрузки

ИнструментОписание
create_customer_order / get_orders / get_customer_order / update_customer_order_statusЖизненный цикл заказа покупателя
create_purchase_order / get_purchase_ordersЗаказы поставщикам
create_demandОтгрузка, привязанная к заказу и складу
create_supplyПриёмка (поступление от поставщика)
create_sales_return / create_purchase_returnВозвраты от покупателей и поставщикам

Складские документы

ИнструментОписание
create_move / get_movesПеремещение между складами
create_enter / get_entersОприходование
create_loss / get_lossesСписание
create_inventory / get_inventoriesИнвентаризация

Финансы

ИнструментОписание
create_payment_in / create_payment_outВходящие и исходящие банковские платежи
create_cash_in / create_cash_outПриходные и расходные кассовые ордера
create_invoice_out / create_invoice_in / get_invoices_outСчета покупателям и от поставщиков

Отчёты

ИнструментОписание
get_profit_reportПрибыль по товарам (выручка, себестоимость, маржа)
get_sales_reportПродажи по товарам (количество, выручка)
get_dashboardПоказатели дашборда за день, неделю, месяц
get_turnoverОборачиваемость товаров за период
get_money_reportТекущие остатки денег по счетам и кассам

Справочники и аудит

ИнструментОписание
list_stores / list_organizationsСклады и юрлица
list_employees / list_currencies / list_product_foldersСправочные данные
get_metadataМетаданные сущностей (статусы, атрибуты) — здесь берутся href статусов заказа
get_audit / get_entity_auditЖурнал событий аккаунта и история одной сущности

Вебхуки и универсальные инструменты

ИнструментОписание
list_webhooks / create_webhook / update_webhook / delete_webhookУправление вебхуками (CREATE/UPDATE/DELETE/PROCESSED)
get_documents / get_documentУниверсальные список и получение для любого типа сущностей, не покрытого выше

HTTP-транспорт

bash
HTTP_PORT=3000 npx @theyahia/moysklad-mcp# илиnpx @theyahia/moysklad-mcp --http 3000

Эндпоинты: POST /mcp (JSON-RPC), GET /health (статус). CORS выключен по умолчанию — HTTP-эндпоинт действует от имени вашего токена МойСклад, поэтому задавайте MOYSKLAD_HTTP_CORS_ORIGIN только если доверенному браузерному origin это действительно нужно.

Конфигурация (переменные окружения)

ПеременнаяПо умолчаниюОписание
MOYSKLAD_TOKEN—Bearer-токен
MOYSKLAD_LOGIN / MOYSKLAD_PASSWORD—Basic-авторизация
MOYSKLAD_RATE_BUCKET20Сколько запросов разрешено в трёхсекундном окне
MOYSKLAD_MAX_CONCURRENT5Максимум параллельных запросов (МойСклад допускает 5 на пользователя)
MOYSKLAD_HTTP_CORS_ORIGIN—Разрешённый CORS-origin для HTTP-транспорта
HTTP_PORT—Запустить транспорт Streamable HTTP на этом порту

Ограничение частоты запросов

МойСклад считает «вес за 3 секунды» (≈45 единиц для токена решения, меньше для логина с паролем; отчёты get_stock и get_stock_by_store стоят по 5 единиц каждый). Встроенный лимитер — token bucket, который списывается по весу запроса, и по умолчанию он консервативен (MOYSKLAD_RATE_BUCKET=20), потому что API может временно отключить доступ после серии 429. Повторы на 429/5xx идут с задержкой и учитывают заголовок X-Lognex-Retry-After. С токеном решения корзину можно поднять ближе к 45.

Решение проблем

СимптомПричина и что делать
Auth not configuredЗадайте MOYSKLAD_TOKEN (или MOYSKLAD_LOGIN + MOYSKLAD_PASSWORD).
auth error 401/403Токен недействителен или истёк, либо у пользователя нет прав на сущность. Новый токен отзывает старые.
MoySklad HTTP 412 …Не хватает обязательного поля (например, исходящему платежу может требоваться статья расходов — передайте expense_item_href). Параметр указан в тексте ошибки.
Много 429 / медленноСнизьте объём запросов или положитесь на встроенный лимитер; поднимайте MOYSKLAD_RATE_BUCKET только с токеном решения.
HTTP 415Среда выполнения не отправляет gzip — используйте Node ≥18 (его fetch делает gzip автоматически).
Вебхуки и часть отчётов не работаютТребуют платного тарифа МойСклад.

E-commerce-стек

СервисMCP-серверЧто делает
МойСклад@theyahia/moysklad-mcpСклад, товары, заказы
СДЭК@theyahia/cdek-mcpДоставка, трекинг
DaData@theyahia/dadata-mcpПроверка адресов
ЮKassa@theyahia/yookassa-mcpПлатежи

Демо-промпты

«Покажи все товары с низким остатком (меньше 10 штук) и их текущие цены»

«Создай заказ покупателя для контрагента „ООО Рога и Копыта“ на 50 штук „Widget Pro“ по 1500 рублей, потом сделай отгрузку с основного склада»

«Перемести 20 штук SKU LP15 с основного склада в магазин, затем подними отчёт по прибыли за этот месяц»

Разработка

bash
npm install        # зависимости + git-хуки (husky)npm run build      # tsc -> dist/npm run lint       # eslintnpm run typecheck  # tsc --noEmitnpm test           # vitest (требуется Node >=20)npm run coverage   # vitest с покрытием

Опубликованный рантайм поддерживает Node ≥18; тестовая оснастка требует Node ≥20.

Справочник API

Основан на JSON API 1.2 МойСклад.

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

來源：README.md，提交 d4e8202

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v3.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分