ilyautov/chestny-znak-mcp-ru

API Честного знака (ГИС МТ и СУЗ) для ИИ-ассистентов: сведения о кодах маркировки, выгрузка по фильтру, маршрут товара по GTIN, заказы на эмиссию, отчёты о нанесении, проверка подлинности.
Каталог собран из первоисточника (открытые SDK True API и СУЗ) и лежит в репозитории как
crpt_mcp/endpoints.yaml: **33 метода**, из них 24 на чтение,
9 на запись и 0 необратимых. Сервер исполняет ровно этот файл,
поэтому таблица ниже не может разойтись с кодом.
> Документация ЦРПТ открыта: . Машиночитаемой спеки при этом нет, /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 или новее:
зависимости сервер доставит себе при первом запуске.
В терминале
Claude Desktop, claude_desktop_config.json:
Ключи
GET /api/v3/true-api/auth/key отдаёт случайные данные, их подписывают КЭП через КриптоПро на машине пользователя, а POST /api/v3/true-api/auth/simpleSignIn меняет подпись на токен. Токен живёт около 10 часов. Закрытый ключ в сервер не попадает.
| переменная | секрет | что это |
|---|---|---|
| CRPT_TOKEN | да | Токен ГИС МТ, выдаётся в обмен на данные, подписанные КЭП. Живёт около 10 часов. |
Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в
~/.ru-mcp/cabinets.json с правами 600, вне репозитория.
Карта методов
| раздел | методов | чтение | запись | необратимое |
|---|---|---|---|---|
| Проверка кодов | 8 | 7 | 1 | 0 |
| Коды маркировки | 6 | 5 | 1 | 0 |
| Заказы на эмиссию | 5 | 3 | 2 | 0 |
| Служебные | 4 | 4 | 0 | 0 |
| Чеки | 3 | 1 | 2 | 0 |
| Авторизация | 2 | 1 | 1 | 0 |
| Документы ГИС МТ | 2 | 2 | 0 | 0 |
| Отчёты о нанесении | 2 | 0 | 2 | 0 |
| Товары и GTIN | 1 | 1 | 0 | 0 |
| **всего** | **33** | **24** | **9** | **0** |
Как это выглядит в чате
Вы: коды маркировки в обороте
Три инструмента вместо 33 функций: агент ищет метод словами,
читает его карточку и вызывает. Запись и необратимое спрашивают подтверждение.
Что обычно просят:
- Проверить пачку кодов маркировки перед приёмкой товара.
- Посмотреть статус заказа на эмиссию кодов в СУЗ.
- Выгрузить коды, принадлежащие участнику оборота.
- Посмотреть маршрут товара по GTIN.
Безопасность