Аналитика МойСклад с MCP-эндпоинтом

Установка

npx skillfoxx add mcp/moysklad-analytics

claude mcp add --transport http moysklad https://your-deployment.example.com/api/mcp --header 'Authorization: Bearer <ваш AUTHORIZATION>'

{
  "mcpServers": {
    "moysklad": {
      "type": "http",
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <ваш AUTHORIZATION>"
      }
    }
  }
}

{
  "mcpServers": {
    "moysklad": {
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <ваш AUTHORIZATION>"
      }
    }
  }
}

code --add-mcp '{"name":"moysklad","type":"http","url":"https://your-deployment.example.com/api/mcp","headers":{"Authorization":"Bearer <ваш AUTHORIZATION>"}}'

{
  "servers": {
    "moysklad": {
      "type": "http",
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <ваш AUTHORIZATION>"
      }
    }
  }
}

[mcp_servers.moysklad]
url = "https://your-deployment.example.com/api/mcp"
http_headers = { Authorization = "Bearer <ваш AUTHORIZATION>" }

{
  "mcpServers": {
    "moysklad": {
      "httpUrl": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <ваш AUTHORIZATION>"
      }
    }
  }
}

{
  "mcpServers": {
    "moysklad": {
      "serverUrl": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <ваш AUTHORIZATION>"
      }
    }
  }
}

{
  "mcpServers": {
    "moysklad": {
      "type": "streamableHttp",
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <ваш AUTHORIZATION>"
      }
    }
  }
}

{
  "mcpServers": {
    "moysklad": {
      "type": "streamable-http",
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <ваш AUTHORIZATION>"
      }
    }
  }
}

{
  "mcp": {
    "moysklad": {
      "type": "remote",
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <ваш AUTHORIZATION>"
      }
    }
  }
}

{
  "context_servers": {
    "moysklad": {
      "url": "https://your-deployment.example.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <ваш AUTHORIZATION>"
      }
    }
  }
}

pnpm setup && cp .env.example .env

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект это полноценный дашборд на NestJS и React поверх JSON API 1.2 МойСклад: продажи и прибыль по товарам, остатки и потребность в закупке, клиенты и каналы, тренды по периодам. Отдельная команда pnpm probe проверяет токен и права доступа перед тем, как доверять любой цифре: показывает, какие отчеты реально доступны аккаунту и не скрыты ли себестоимость и прибыль правами пользователя. Встроенный ИИ-ассистент на DeepSeek отвечает на вопросы по тем же данным через семь инструментов только для чтения. Для внешних агентов есть эндпоинт POST /api/mcp по Streamable HTTP с теми же семью аналитическими инструментами, плюс семь бизнес-инструментов (документы, деньги, закупки, взаиморасчеты, контрагенты, обороты) и один инструмент moysklad_api для чтения произвольного пути API. Вся денежная логика (минорные единицы, разница между наценкой и маржой) обработана один раз в сервисе статистики, поэтому дашборд, встроенный ассистент и внешний MCP не могут разойтись в определении «выручки».

Для кого. Для владельцев магазинов на МойСклад, которым мало чата с агентом и нужен полноценный self-hosted дашборд с проверенными цифрами и MCP в довесок.

Пример запроса к агенту

Какие товары нужно закупить в ближайшую неделю и кто наши крупнейшие клиенты за квартал

Ограничения

Это не легковесный MCP-сервер, а полноценное self-hosted приложение (NestJS + React), для деплоя нужен Docker или свой сервер. Встроенный ИИ-ассистент работает только с платным ключом DeepSeek. МойСклад ограничивает API 45 запросами за 3 секунды и 5 одновременными соединениями. Если токен принадлежит ограниченному пользователю, столбцы прибыли и маржи приходят пустыми, а не с ошибкой.

Как отключить. Остановите Docker-контейнер или процесс сервера и удалите запись MCP-подключения из клиента (claude mcp remove moysklad или аналогичная команда).

MCP

Транспорт

http

Авторизация

OAuth

Проверка безопасности

• MCP-инструменты структурно только читают данные, но открывают полный обзор денег и клиентов при слабой авторизации
• Дашборд показывает себестоимость и прибыль по каждому товару и клиенту, требует обязательного Basic auth в продакшене

Коротко о README

README подробно документирует нюансы API МойСклад, подтвержденные на живом аккаунте (деньги в минорных единицах, разница margin и salesMargin, разные форматы href в разных отчетах), объясняет выбор модели DeepSeek для встроенного ассистента и почему локальные модели не подошли, и отдельно описывает MCP-эндпоинт: набор из 15 инструментов, два способа авторизации (статический Bearer и полноценный OAuth по спецификации MCP) и обязательный Basic auth в продакшене.

Похожие