Аналитика МойСклад с MCP-эндпоинтом
MoySklad Analytics
Self-hosted дашборд аналитики МойСклад (продажи, остатки, клиенты) с MCP-эндпоинтом, который отдает агенту те же проверенные цифры, что видны на экране
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- MCP-инструменты структурно только читают данные, но открывают полный обзор денег и клиентов при слабой авторизации
- Дашборд показывает себестоимость и прибыль по каждому товару и клиенту, требует обязательного Basic auth в продакшене
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/moysklad-analyticsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- MCP-инструменты структурно только читают данные, но открывают полный обзор денег и клиентов при слабой авторизации
- Дашборд показывает себестоимость и прибыль по каждому товару и клиенту, требует обязательного Basic auth в продакшене
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект это полноценный дашборд на NestJS и React поверх JSON API 1.2 МойСклад: продажи и прибыль по товарам, остатки и потребность в закупке, клиенты и каналы, тренды по периодам. Отдельная команда pnpm probe проверяет токен и права доступа перед тем, как доверять любой цифре: показывает, какие отчеты реально доступны аккаунту и не скрыты ли себестоимость и прибыль правами пользователя. Встроенный ИИ-ассистент на DeepSeek отвечает на вопросы по тем же данным через семь инструментов только для чтения. Для внешних агентов есть эндпоинт POST /api/mcp по Streamable HTTP с теми же семью аналитическими инструментами, плюс семь бизнес-инструментов (документы, деньги, закупки, взаиморасчеты, контрагенты, обороты) и один инструмент moysklad_api для чтения произвольного пути API. Вся денежная логика (минорные единицы, разница между наценкой и маржой) обработана один раз в сервисе статистики, поэтому дашборд, встроенный ассистент и внешний MCP не могут разойтись в определении «выручки».
Для кого. Для владельцев магазинов на МойСклад, которым мало чата с агентом и нужен полноценный self-hosted дашборд с проверенными цифрами и MCP в довесок.
Подходит, если
- Нужен визуальный дашборд продаж, остатков и клиентов, а не только чат с агентом
- Важно перепроверить права токена перед тем, как доверять цифрам прибыли и маржи
- Нужен MCP-доступ к тем же проверенным данным для Claude, Cursor или коннекторов ChatGPT
Не подходит, если
- Нужен только MCP-сервер без деплоя целого дашборда: это self-hosted приложение с NestJS-бэкендом и React-фронтендом, легковесного варианта нет
- Не готовы разворачивать через Docker и настраивать Basic auth: в продакшене сервер откажется стартовать без заданных учетных данных
- Нужна запись в МойСклад: moysklad_api и остальные MCP-инструменты структурно только читают
Пример запроса к агенту
Какие товары нужно закупить в ближайшую неделю и кто наши крупнейшие клиенты за кварталMCP
- Транспорт
- http
- Авторизация
- OAuth
Переменные окружения
MOYSKLAD_TOKENобязательная, секрет- Токен JSON API МойСклад
MCP_TOKENсекрет- Включает MCP-эндпоинт, минимум 24 символа, используется и как статический Bearer, и как ключ подписи OAuth
DASHBOARD_USERобязательная- Логин Basic auth дашборда, обязателен в продакшене
DASHBOARD_PASSWORDобязательная, секрет- Пароль Basic auth дашборда, обязателен в продакшене
DEEPSEEK_API_KEYсекрет- Включает встроенного ИИ-ассистента дашборда
Ограничения
Это полноценное self-hosted приложение на NestJS и React, заметно тяжелее обычного MCP-сервера: для деплоя нужен Docker или свой сервер. Встроенный ИИ-ассистент работает только с платным ключом DeepSeek. МойСклад ограничивает API 45 запросами за 3 секунды и 5 одновременными соединениями. Если токен принадлежит ограниченному пользователю, столбцы прибыли и маржи приходят пустыми, а не с ошибкой.
Как отключить. Остановите Docker-контейнер или процесс сервера и удалите запись MCP-подключения из клиента (claude mcp remove moysklad или аналогичная команда).
Частые вопросы
Может ли MCP-инструмент изменить данные в МойСклад?
Нет, и семь бизнес-инструментов, и универсальный moysklad_api структурно только читают, клиент API использует исключительно GET.
Как подключиться из мобильного приложения Claude или ChatGPT?
Через OAuth: добавьте кастомный коннектор по адресу /api/mcp, приложение само найдет эндпоинты авторизации и попросит войти с учетными данными дашборда.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
МойСклад — все инструментыMCP для МойСклад: товары, остатки, заказы
mcp-moysklad
MCP-сервер для МойСклад: поиск товаров и остатков, контрагенты по ИНН, создание и чтение заказов, сводка по продажам одним пакетом npx
МойСклад MCP
moysklad-mcp
MCP-сервер МойСклад на 60 инструментов: товары, остатки, заказы, отгрузки, приемки, платежи, отчеты по прибыли
MCP для производства в МоемСкладе
moysklad-production-mcp
MCP-сервер только для чтения по модулю производства МоегоСклада: техкарты, производственные задания и прибыль по товарам
MCP-сервер для JSON API 1.2 МойСклад: остатки, заказы, отчеты о прибыли и создание документов за двумя уровнями защиты
MCP-сервер МоегоСклада с двумя гейтами на запись: остатки, прибыль, отчеты и черновики документов через JSON API 1.2
MCP-сервер МойСклад от партнера Kaya
MCP-сервер МойСклад (Kaya)
Платное приложение из маркетплейса МойСклад: после установки агент ищет товары, контрагентов и заказы и создает документы диалогом
Коротко о README
README подробно документирует нюансы API МойСклад, подтвержденные на живом аккаунте (деньги в минорных единицах, разница margin и salesMargin, разные форматы href в разных отчетах), объясняет выбор модели DeepSeek для встроенного ассистента и почему локальные модели не подошли, и отдельно описывает MCP-эндпоинт: набор из 15 инструментов, два способа авторизации (статический Bearer и полноценный OAuth по спецификации MCP) и обязательный Basic auth в продакшене.