Честный знак MCP (RU) — коды маркировки, ГИС МТ, СУЗ

chestny-znak-mcp-ru

API Честного знака (ГИС МТ и СУЗ) для ИИ-ассистентов: сведения о кодах маркировки, выгрузка по фильтру, маршрут товара по GTIN, заказы на эмиссию, отчёты о нанесении, проверка подлинности.

[PyPI] [CI] [License: MIT] [Методов] [Сайт] [Звёзды]

[Install in VS Code] [Install in Cursor]

[chestny-znak-mcp-ru: API Честного знака (ГИС МТ) в ИИ-ассистенте. 33 метода, поиск метода словами, гейт безопасности перед записью]

Каталог собран из первоисточника (открытые SDK True API и СУЗ) и лежит в репозитории как crpt_mcp/endpoints.yaml: 33 метода, из них 24 на чтение, 9 на запись и 0 необратимых. Сервер исполняет ровно этот файл, поэтому таблица ниже не может разойтись с кодом.

Документация ЦРПТ открыта: https://docs.crpt.ru/gismt/True_API/. Машиночитаемой спеки при этом нет, /api/v3/true-api/swagger.json отдаёт 401, поэтому каталог не сгенерирован из спеки, а собран по открытым SDK, и у каждой записи стоит verified: false. Это карта для разведки: пути надёжные, глаголы и параметры сверяются с документацией и на живом контуре. Сервер показывает этот статус в describe_method, чтобы агент не выдавал догадку за факт.

Установка

Два пути, выбирайте по тому, есть ли у вас терминал.

Без терминала: файл .mcpb

Скачайте chestny-znak-mcp-ru-vX.Y.Z.mcpb со страницы релизов и откройте двойным щелчком. Claude Desktop поставит сервер сам и спросит ключи в отдельном окне, в конфиг лезть не придётся. Нужен Python 3.10 или новее: зависимости сервер доставит себе при первом запуске.

В терминале

uvx chestny-znak-mcp-ru

Claude Desktop, claude_desktop_config.json:

{  "mcpServers": {    "crpt-mcp": {      "command": "uvx",      "args": ["chestny-znak-mcp-ru"],      "env": { "CRPT_TOKEN": "..." }    }  }}

Ключи

GET /api/v3/true-api/auth/key отдаёт случайные данные, их подписывают КЭП через КриптоПро на машине пользователя, а POST /api/v3/true-api/auth/simpleSignIn меняет подпись на токен. Токен живёт около 10 часов. Закрытый ключ в сервер не попадает.

Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в ~/.ru-mcp/cabinets.json с правами 600, вне репозитория.

Карта методов

Как это выглядит в чате

Вы: коды маркировки в обороте

crpt_search_methods("коды маркировки в обороте")  crpt_gis_cises_my      GET  /api/v3/true-api/cises/my  чтение  crpt_gis_cis_outcheck  GET  /api/v1/cis/outCheck       чтение  crpt_suz_codes         GET  /api/v3/codes              чтение
crpt_describe_method("crpt_gis_cises_my")  Коды маркировки, принадлежащие участнику оборота  GET markirovka.crpt.ru/api/v3/true-api/cises/my  параметры: нет  класс доступа: чтение
crpt_call_method("crpt_gis_cises_my", {})

Три инструмента вместо 33 функций: агент ищет метод словами, читает его карточку и вызывает. Запись и необратимое спрашивают подтверждение.

Что обычно просят:

• Проверить пачку кодов маркировки перед приёмкой товара.
• Посмотреть статус заказа на эмиссию кодов в СУЗ.
• Выгрузить коды, принадлежащие участнику оборота.
• Посмотреть маршрут товара по GTIN.

Безопасность

Сервер работает на машине пользователя, ключи наружу не уходят. У методов три класса доступа: чтение идёт сразу, запись и необратимые действия требуют подтверждения. Заголовок авторизации не покидает домены сервиса даже при вызове произвольного пути.

Проверить установку

uvx chestny-znak-mcp-ru doctor

Печатает, сколько методов загрузилось, найдены ли ключи и откуда. Секреты не показывает. С --live делает один дешёвый реальный вызов на чтение.

Родня

Ядро вынесено в schema-mcp-core. Соседние серверы: vk-mcp-ru, diadoc-mcp-ru, sbis-mcp-ru. Маркетплейсы живут отдельно: marketplaces-mcp-ru.

MIT. Автор Илья Утов.

Все проекты одним списком, разобранные по назначению: ilyautov.github.io.

Privacy Policy

chestny-znak-mcp-ru не собирает и не передаёт ваши данные: ключи лежат локально в ~/.ru-mcp/cabinets.json, запросы идут только в API Честный знак (ГИС МТ и СУЗ), телеметрии нет. Полный текст: PRIVACY_POLICY.md.