chestny-znak-mcp-ru

chestny-znak-mcp-ru

API do Cheстный знак (GIS MT e SUZ) para assistentes de IA: informações sobre códigos de marcação, exportação por filtro, rota do produto por GTIN, pedidos de emissão, relatórios de aplicação, verificação de autenticidade.

O catálogo foi montado a partir da fonte original (SDKs abertos do True API e SUZ) e está no repositório como crpt_mcp/endpoints.yaml: 33 métodos, sendo 24 de leitura, 9 de escrita e 0 irreversíveis. O servidor executa exatamente esse arquivo, portanto a tabela abaixo não pode divergir do código.

A documentação do CRPT só é aberta após login com assinatura digital qualificada (КЭП), não há especificação pública: /api/v3/true-api/swagger.json retorna 401. Os caminhos aqui foram retirados dos SDKs abertos, e cada registro do catálogo tem um verified: false. Este é um mapa para exploração: os caminhos são confiáveis, verbos e parâmetros precisam ser confirmados no ambiente real. O servidor mostra esse status em describe_method, para que o agente não apresente suposição como fato.

Instalação

uvx chestny-znak-mcp-ru

Claude Desktop, claude_desktop_config.json:

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

Chaves

GET /api/v3/true-api/auth/key retorna dados aleatórios, que são assinados com КЭП via CryptoPro na máquina do usuário, e POST /api/v3/true-api/auth/simpleSignIn troca a assinatura por um token. O token dura cerca de 10 horas. A chave privada não chega ao servidor.

variável	segredo	o que é
CRPT_TOKEN	sim	Token GIS MT, emitido em troca de dados assinados com КЭП. Dura cerca de 10 horas.

As chaves não precisam ficar no ambiente: o servidor gerencia contas e as armazena em ~/.ru-mcp/cabinets.json com permissões 600, fora do repositório.

Mapa de métodos

seção	métodos	leitura	escrita	irreversível
Verificação de códigos	8	7	1	0
Códigos de marcação	6	5	1	0
Pedidos de emissão	5	3	2	0
Serviços	4	4	0	0
Recibos	3	1	2	0
Autorização	2	1	1	0
Documentos GIS MT	2	2	0	0
Relatórios de aplicação	2	0	2	0
Produtos e GTIN	1	1	0	0
total	33	24	9	0

Como fica no chat

Você: códigos de marcação em circulação

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

Três ferramentas em vez de 33 funções: o agente busca o método por palavras, lê o cartão dele e chama. Escrita e ações irreversíveis pedem confirmação.

O que costumam pedir:

• Verificar um lote de códigos de marcação antes de receber a mercadoria.
• Consultar o status de um pedido de emissão de códigos no SUZ.
• Exportar códigos pertencentes a um participante da circulação.
• Ver a rota do produto por GTIN.

Segurança

O servidor roda na máquina do usuário, as chaves não saem para fora. Os métodos têm três classes de acesso: leitura é imediata, escrita e ações irreversíveis exigem confirmação. O cabeçalho de autorização não sai dos domínios do serviço mesmo ao chamar um caminho arbitrário.

Verificar instalação

uvx chestny-znak-mcp-ru doctor

Mostra quantos métodos foram carregados, se as chaves foram encontradas e de onde. Segredos não são exibidos. Com --live faz uma chamada real barata de leitura.

Relacionados

O núcleo está extraído em schema-mcp-core. Servidores vizinhos: hh-mcp-ru, vk-mcp-ru, diadoc-mcp-ru, sbis-mcp-ru. Marketplaces ficam separados: marketplaces-mcp-ru.

MIT. Autor Ilya Utov.

Todos os projetos em uma lista, organizados por finalidade: ilyautov.github.io.