Что ИИ-агент делает с Честным знаком
MCP-серверы для ГИС МТ в каталоге отличаются глубиной доступа, от проверки одного кода до заказа эмиссии.
- Проверяет подлинность кода DataMatrix, QR или EAN13. MCP-сервер Честного знака возвращает название товара, категорию, производителя и владельца. Регистрация для этого не нужна.
- Проверяет партию до 50 кодов за один вызов. Пакетная проверка входит в тот же сервер и тоже работает без токена.
- Ищет товар по GTIN и получает данные кода идентификации CIS. Эти два инструмента того же сервера уже требуют токен True API, выданный на вашу организацию.
- Показывает документы и их состав, остатки кодов и виртуального склада, чеки выбытия. Это 10 инструментов сервера woyax с песочницей и продуктивным контуром.
- Проверяет по ИНН, зарегистрирован ли поставщик или покупатель в системе маркировки, до того как вы примете от него партию или отгрузите ему товар.
- Заказывает эмиссию кодов и отправляет отчеты о нанесении через СУЗ. MCP для ГИС МТ и СУЗ знает 33 метода, из них 24 на чтение и 9 на запись.
Как получить токен True API
Токен выдают в два шага. Учетная система вызывает метод /auth/key и получает UUID и строку данных. Строку подписывают УКЭП через КриптоПро, а подпись вместе с UUID отправляют в /auth/simpleSignIn. В ответе приходит токен.
Сам он не продлевается. Когда срок жизни истек, запрос повторяют с новой подписью. Описания серверов в каталоге называют срок около 10 часов. Подпись ни один сервер за вас не ставит. Сервер chestny-znak-mcp-ru просит подписывать КЭП на вашей машине и закрытый ключ не видит. Сервер woyax получение JWT не включает, зато подхватывает новый токен из файла без перезапуска, так что обновление можно повесить на отдельный скрипт с КриптоПро.
Полное описание True API ЦРПТ в открытый доступ не выкладывает. Документ лежит в личном кабинете продуктивного контура, в разделе «Помощь» и подразделе «API», после выбора товарной группы. В демо-контуре его нет.
Сервер ставится командой из карточки, например npx skillfoxx add mcp/chestnyznak-mcp. Токен держите в переменных окружения.
X-API-KEY и проверка на кассе
X-API-KEY — токен разрешительного режима, через который касса проверяла коды. По базе знаний ЦРПТ, с 1 октября 2026 года поддержка этого способа прекращается. Переход идет поэтапно. Вместо ключа нужен модуль ТС ПИоТ, обязательный с 28 декабря 2025 года для продажи маркированных товаров в разрешительном режиме.
MCP-серверам каталога X-API-KEY не нужен. Им хватает публичной проверки или токена True API.
Какой сервер выбрать
Своего MCP-сервера у ЦРПТ в каталоге нет. Все серверы выпустили сторонние разработчики, и запускаются они из России напрямую, без VPN.
- Товароведу и закупщику хватит chestnyznak-mcp. Доступ минимальный, публичные инструменты ничего не меняют в системе.
- Учет документов и остатков закрывает сервер woyax с расширенным доступом. Ему нужен JWT-токен личного кабинета компании в системе маркировки.
- Эмиссия и отчеты о нанесении есть только в chestny-znak-mcp-ru, доступ широкий. Он действует под учетными данными участника оборота.
- Учет ведется в 1С — инструменты для учетных систем собраны на странице 1С.
Ограничения и безопасность
Карту методов chestny-znak-mcp-ru автор собрал по открытым SDK, потому что машиночитаемой спецификации у ЦРПТ нет. У каждого метода в этой карте стоит пометка verified: false. Пути надежные. Глаголы и параметры перед первой операцией записи сверьте с документацией из личного кабинета, иначе агент может отправить неверный вызов в регуляторный API.
Токен песочницы не работает в продуктиве. Обратное тоже верно. Отлаживайте сценарий в песочнице сервера woyax. Его версия пока 0.1.0, а лицензия MIT с Commons Clause.
HTTP-режим chestnyznak-mcp по умолчанию слушает только localhost и своей аутентификации не имеет. Поиска по названию или бренду нет ни в одном сервере. Для этого нужен API Национального каталога.