chestnyznak-mcp — MCP-сервер для Claude Code: суть и установка
Проверяет коды маркировки «Честный ЗНАК» через мобильный интерфейс и True API ЦРПТ прямо в диалоге с моделью. Базовые запросы работают без регистрации и токенов.
claude mcp add chestnyznak-mcp -e API_KEY=<API_KEY> -- npx -y @theyahia/chestnyznak-mcpЧто делает chestnyznak-mcp
Сервер даёт пять инструментов для работы с национальной системой маркировки. Без авторизации запускаются одиночная проверка DataMatrix, QR или EAN-13, запрос расширенных карточек с производителем и собственником, а также пакетная сверка до 50 кодов за раз. Все три функции обращаются к публичному адресу мобильного клиента ЦРПТ.
Инструменты для поиска по GTIN и проверки кодов CIS требуют рабочий ключ True API в переменной CHESTNYZNAK_TOKEN. Сервер не умеет подписывать запросы сертификатом УКЭП по ГОСТ: процедуру авторизации придётся настроить отдельно через внешние утилиты вроде КриптоПро, причём полученный токен живёт около 10 часов.
Запросы к публичной конечной точке могут прерываться по таймауту при обращении с серверов за пределами РФ. Инструмент поддерживает режим передачи через stdio или запуск локального HTTP-сервиса с флагом --http, где входящие подключения на /mcp остаются без встроенной защиты.
Какие задачи решает
- проверить подлинность и статус кода маркировки DataMatrix
- получить название, категорию, производителя и владельца товара
- выполнить пакетную валидацию до 50 кодов за один запрос
- запросить параметры карточки товара по коду GTIN в True API
Примеры запросов агенту
- Проверь статус кода маркировки 0104600702028445
- Выясни производителя и текущего владельца для кода 010460070202844521
- Запусти пакетную проверку для кодов 0104600702028445 и 0104600702028446
Как установить chestnyznak-mcp
Командой платформы
claude mcp add chestnyznak-mcp -e API_KEY=<API_KEY> -- npx -y @theyahia/chestnyznak-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add chestnyznak-mcp --env API_KEY=<API_KEY> -- npx -y @theyahia/chestnyznak-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"chestnyznak-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/chestnyznak-mcp"
],
"env": {
"API_KEY": "<API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"chestnyznak-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/chestnyznak-mcp"
],
"env": {
"API_KEY": "<API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e API_KEY=<API_KEY> chestnyznak-mcp npx -y @theyahia/chestnyznak-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о chestnyznak-mcp
Как установить chestnyznak-mcp в Claude Code?
Выполните в терминале команду claude mcp add chestnyznak-mcp -e API_KEY=<API_KEY> -- npx -y @theyahia/chestnyznak-mcp.
Нужен ли токен для проверки кодов маркировки?
Для базовой проверки подлинности, данных о владельце и пакетов до 50 кодов авторизация не требуется. Токен CHESTNYZNAK_TOKEN обязателен только для обращений к True API по GTIN или CIS.
Можно ли найти товар по текстовому названию или марке?
Нет, текстовый поиск относится к Национальному каталогу и на этом сервере отсутствует. Инструмент search_products принимает исключительно цифровые коды GTIN.
