chestny-znak-mcp-ru

chestny-znak-mcp-ru

API Честного знака (ГИС МТ и СУЗ) para asistentes de IA: información sobre códigos de marcado, descarga por filtro, ruta del producto por GTIN, pedidos de emisión, informes de marcado, verificación de autenticidad.

El catálogo se recopila de la fuente original (SDK abiertos de True API y СУЗ) y se encuentra en el repositorio como crpt_mcp/endpoints.yaml: 33 métodos, de los cuales 24 de lectura, 9 de escritura y 0 irreversibles. El servidor ejecuta exactamente este archivo, por lo que la tabla siguiente no puede diferir del código.

La documentación de ЦРПТ solo se abre después de iniciar sesión con КЭП, no hay especificación pública: /api/v3/true-api/swagger.json devuelve 401. Las rutas aquí se toman de los SDK abiertos, y cada entrada del catálogo tiene verified: false. Es un mapa para exploración: las rutas son fiables, los verbos y parámetros deben confirmarse en el circuito real. El servidor muestra este estado en describe_method, para que el agente no presente una suposición como un hecho.

Instalación

uvx chestny-znak-mcp-ru

Claude Desktop, claude_desktop_config.json:

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

Claves

GET /api/v3/true-api/auth/key devuelve datos aleatorios, que se firman con КЭП mediante КриптоПро en la máquina del usuario, y POST /api/v3/true-api/auth/simpleSignIn cambia la firma por un token. El token dura unas 10 horas. La clave privada no llega al servidor.

variable	secreto	qué es
CRPT_TOKEN	sí	Token de ГИС МТ, se emite a cambio de datos firmados con КЭП. Dura unas 10 horas.

Las claves no tienen que estar en el entorno: el servidor sabe gestionar cuentas y las guarda en ~/.ru-mcp/cabinets.json con permisos 600, fuera del repositorio.

Mapa de métodos

sección	métodos	lectura	escritura	irreversible
Verificación de códigos	8	7	1	0
Códigos de marcado	6	5	1	0
Pedidos de emisión	5	3	2	0
Servicio	4	4	0	0
Recibos	3	1	2	0
Autorización	2	1	1	0
Documentos de ГИС МТ	2	2	0	0
Informes de marcado	2	0	2	0
Productos y GTIN	1	1	0	0
total	33	24	9	0

Cómo se ve en el chat

Usted: códigos de marcado en circulación

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", {})

Tres herramientas en lugar de 33 funciones: el agente busca el método con palabras, lee su tarjeta y lo llama. La escritura y lo irreversible piden confirmación.

Lo que suelen pedir:

• Verificar un lote de códigos de marcado antes de aceptar la mercancía.
• Ver el estado de un pedido de emisión de códigos en СУЗ.
• Descargar códigos que pertenecen a un participante de la circulación.
• Ver la ruta del producto por GTIN.

Seguridad

El servidor funciona en la máquina del usuario, las claves no salen al exterior. Los métodos tienen tres clases de acceso: la lectura va de inmediato, la escritura y las acciones irreversibles requieren confirmación. El encabezado de autorización no sale de los dominios del servicio incluso al llamar una ruta arbitraria.

Verificar la instalación

uvx chestny-znak-mcp-ru doctor

Imprime cuántos métodos se cargaron, si se encontraron las claves y de dónde. No muestra secretos. Con --live hace una llamada real de lectura barata.

Familia

El núcleo está extraído en schema-mcp-core. Servidores vecinos: hh-mcp-ru, vk-mcp-ru, diadoc-mcp-ru, sbis-mcp-ru. Los marketplaces viven aparte: marketplaces-mcp-ru.

MIT. Autor Илья Утов.

Todos los proyectos en una lista, clasificados por propósito: ilyautov.github.io.