МойСклад MCP: Документация
Обновлено:
Подключение
npx -y @theyahia/moysklad-mcp (stdio) или HTTP_PORT=3000 npx @theyahia/moysklad-mcp (Streamable HTTP, POST /mcp). Auth: MOYSKLAD_TOKEN (Bearer, приоритетно — Настройки → Пользователи → Токены доступа) либо MOYSKLAD_LOGIN + MOYSKLAD_PASSWORD (Basic).
Что умеет
60 инструментов: товары и номенклатура (search_products, get_product, create_product, update_prices, search_assortment, search_variants/search_bundles/search_services), остатки (get_stock, get_stock_by_store, get_stock_current), контрагенты (get_counterparties, get_counterparty, create_counterparty), заказы и отгрузки (create_customer_order, create_purchase_order, create_demand, create_supply, create_sales_return/create_purchase_return), складские документы (create_move, create_enter, create_loss, create_inventory), финансы (create_payment_in/create_payment_out, create_cash_in/create_cash_out, create_invoice_out/create_invoice_in), отчёты (get_profit_report, get_sales_report, get_dashboard, get_turnover, get_money_report), справочники и аудит (get_metadata, get_audit), вебхуки (list_webhooks/create_webhook/update_webhook/delete_webhook).
Суммы везде передаются и возвращаются в рублях — конвертация в копейки (формат API) происходит внутри сервера.
Сценарий для агента
«Покажи остатки товара X по складам», «создай заказ покупателю и отгрузи со склада», «сведи прибыль по товарам за месяц».
Ограничения
Rate-limit — вес запроса за 3 секунды (по умолчанию бюджет 20 из ~45 у токена решения); при частых 429 сервер сам ждёт и повторяет. Вебхуки и часть отчётов требуют платного тарифа МоегоСклада.
Важно
Community-проект (theYahia), не официальный продукт МоегоСклада.