SkillFoxx
Telegram

МойСклад для Claude Code: чтение и запись по API 1.2

claude-moysklad-mcp

Локальный коннектор на Python и FastMCP: поиск товаров, остатки, контрагенты и заказы покупателей в МойСклад, плюс сырой запрос к любому методу API

  • 0 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Создает и меняет заказы и документы, а через `api_request` может удалять данные
  • Токен МойСклад дает права его пользователя на товары, остатки и контрагентов
Все причины и проверки
Российский стек

stepan-cloud/claude-moysklad-mcpАвтор:stepan-cloud

Установка

Сервисы

Ручная установка

git clone https://github.com/stepan-cloud/claude-moysklad-mcp
cd claude-moysklad-mcp
python setup.py

Команда из README: установщик создает окружение и регистрирует коннектор `moysklad` в `~/.claude.json`.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Создает и меняет заказы и документы, а через `api_request` может удалять данные
  • Токен МойСклад дает права его пользователя на товары, остатки и контрагентов

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

Что делает

Локальный MCP-сервер на Python и FastMCP открывает Claude Code JSON API 1.2 сервиса МойСклад. Он ищет товары, модификации, услуги и комплекты по имени, коду, артикулу или штрихкоду, отдает остатки по всем складам или по каждому складу с фильтрами вроде «ниже неснижаемого остатка», читает контрагентов, заказы и документы. Заказ покупателя создается из человеческих данных: контрагент по имени или ИНН, товары по коду или артикулу, цены в рублях. Всего двенадцать инструментов: чтение сущностей и позиций, создание и изменение любых объектов, массовое создание до 1000 за раз и `api_request` для отчетов, статусов и удаления. Списки возвращаются таблицей `header` и `rows`, которую можно одним вызовом записать в Google Таблицу. Токен уходит только на `api.moysklad.ru`.

Для кого. Владельцам небольших магазинов и кладовщикам на МойСклад, которым надо быстро спросить остатки, найти контрагента или оформить заказ из чата.

Подходит, если

  • Утром надо увидеть остатки по складам и товары ниже неснижаемого остатка
  • Из сообщения клиента оформляется заказ: контрагент по ИНН, позиции по артикулам, цены в рублях
  • Остатки выгружают таблицей и записывают в Google Таблицу
  • Разовому отчету или статусу документа не хватает готового инструмента, и берут сырой запрос

Не подходит, если

  • Нужна работа без записи: токен дает права пользователя, и коннектор умеет создавать и менять документы
  • Среда без Python 3.10 или без права поставить виртуальное окружение
  • Нужен облачный коннектор в панели Connectors: этот работает только локально

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

Покажи товары, у которых остаток на складе ниже неснижаемого, и выгрузи их таблицей

MCP

Транспорт
stdio
Авторизация
API-ключ

Ограничения

Коннектор локальный, работает только в Claude Code и не виден в панели Connectors, статус смотрят командой `/mcp`. Для установки нужен Python 3.10 или новее и клон репозитория, который должен остаться на месте. Токен создается вручную в МойСклад и сохраняется скриптом `authorize.py`. Суммы в API идут в копейках, суффикс `:rub` переводит их в рубли. Перед созданием и изменением документов агенту велено подтверждать действие у пользователя, но технически ничто не мешает правке: удаление доступно через `api_request`. Звезд нет, автор один.

Как отключить. Запустите `uninstall.bat` на Windows или удалите запись `moysklad` из `~/.claude.json`, а токен отзовите в настройках МойСклад.

Частые вопросы

Как получить токен?

В МойСклад откройте Настройки, затем Токены и создайте токен. Он получает права того пользователя, для которого создан, поэтому безопаснее завести отдельного сотрудника.

Куда сохраняется токен?

Скрипт `authorize.py` открывает Блокнот, вы вставляете токен и закрываете файл, связь проверяется сама. Из чата токен не запрашивается.

Какие ограничения у выдачи данных?

Страница читается по 1000 записей, с `expand` по 100, дальше пагинация идет сама. На ответ 429 коннектор ждет и повторяет запрос.

Что с деньгами в ответах?

API отдает суммы в копейках. Суффикс `:rub` у колонки переводит их в рубли, а при создании заказа цены задаются в рублях.

Как проверить установку?

Перезапустите Claude Code полностью, вызовите `ping`, затем `search_assortment` с `max_rows=5`.

Обсуждение

Вопросов и отзывов пока нет.

МойСклад — все инструменты
Российский стек

MCP-сервер МойСклад на 60 инструментов: товары, остатки, заказы, отгрузки, приемки, платежи, отчеты по прибыли

MCP-серверШирокий доступ10
Российский стек

MCP-сервер для МойСклад: поиск товаров и остатков, контрагенты по ИНН, создание и чтение заказов, сводка по продажам одним пакетом npx

MCP-серверШирокий доступ
Российский стек

MCP-сервер МоегоСклада с двумя гейтами на запись: остатки, прибыль, отчеты и черновики документов через JSON API 1.2

MCP-серверШирокий доступ
Российский стек

MCP-сервер для JSON API 1.2 МойСклад: остатки, заказы, отчеты о прибыли и создание документов за двумя уровнями защиты

MCP-серверШирокий доступ3
Российский стек

MCP-сервер только для чтения по модулю производства МоегоСклада: техкарты, производственные задания и прибыль по товарам

MCP-серверРасширенный доступ

MCP-сервер МойСклад от партнера Kaya

MCP-сервер МойСклад (Kaya)

Российский стек

Платное приложение из маркетплейса МойСклад: после установки агент ищет товары, контрагентов и заказы и создает документы диалогом

MCP-серверШирокий доступ

Коротко о README

README открывается инструкцией для самого Claude по шагам установки, затем перечисляет возможности: ассортимент, остатки, контрагенты, документы, сырой запрос, табличный режим. Дальше требования, ручная установка и получение токена. Отдельный файл `CLAUDE.md` повторяет порядок установки и предупреждает про суммы в копейках и подтверждение записи.

Бейдж для README

Сообщить о проблеме