Documentação Minha CNH
Portal de documentação B2B do Minha CNH — a API REST e o Servidor MCP para consulta programática de diagnósticos de CNH.
A documentação B2B do Minha CNH cobre duas soluções complementares para consultar diagnósticos de CNH programaticamente, sobre a mesma base de dados, autenticação e cobrança:
- API REST — a integração server-to-server tradicional: autenticação por Bearer key, entrega via webhook HMAC-SHA256 ou polling, e cobrança pós-paga por relatório.
- Servidor MCP — o mesmo dado exposto via Model Context Protocol, para que agentes de IA e clientes desktop (Claude Desktop, ChatGPT) consumam relatórios como tools nativas.
Escolha a API REST para backends e ETLs; o MCP quando um agente de IA precisa descobrir e chamar as ferramentas sozinho. As duas compartilham a mesma API key, o mesmo billing e os mesmos rate limits.
Acesso por aprovação
O acesso é habilitado manualmente pelo time Minha CNH após aprovação comercial. Veja Contratar a API para entender o processo.
Comece por aqui
| Etapa | O que você vai fazer |
|---|---|
| 1. Contratar | Entender o processo comercial, o modelo de crédito e o lead time de ativação |
| 2. Autenticação | Gerar sua API key e configurar o webhook |
| 3. Primeira chamada | Fazer o primeiro POST /api/v1/reports e receber o resultado |
Antes de integrar
- Introdução — para quem é a API e o que ela faz.
- Conceitos — terminologia de CNH e da API que aparece em toda a documentação.
Referência completa
A API documenta todos os endpoints, o shape do
payload, idempotência, webhooks, limites e o catálogo de erros. A especificação
OpenAPI interativa (Scalar) está em /api/docs.
O Servidor MCP documenta o endpoint, as duas formas de conectar (API key e OAuth) e as dez ferramentas disponíveis para agentes de IA.