Para dar a um agente acesso a dados de empresas brasileiras por MCP, configure um cliente compatível para se conectar a um servidor que ofereça essas ferramentas e forneça as credenciais exigidas. Um exemplo documentado é o servidor remoto do cnpj.ia.br, em https://mcp.cnpj.ia.br. Não há um comando universal que conecte qualquer agente a qualquer base: a configuração depende do cliente e do serviço.
O que MCP faz — e o que ele não faz
O Model Context Protocol (MCP) padroniza a conexão entre aplicações de IA e ferramentas oferecidas por sistemas externos. A documentação oficial o define como “MCP (Model Context Protocol) is an open-source standard for connecting AI applications to external systems.” (documentação oficial do MCP).
![Year book of American Chamber of Commerce for Brazil and American business directory ... Volume 1920 1920 [Leather Bound]](https://m.media-amazon.com/images/I/41lEh+adxtL._SL160_.jpg)
As an Amazon Associate I earn from qualifying purchases.
MCP não é uma base de dados de empresas. Para consultar informações, o agente precisa de um cliente MCP, de um servidor que exponha ferramentas de consulta e de uma credencial aceita por esse servidor. O exemplo abaixo usa o serviço de terceiros cnpj.ia.br; ele não é uma integração governamental.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Scan for outdated or missing drivers - takes under a minute3Repair Windows errors before they cause bigger problemsComo configurar o cnpj.ia.br no Codex CLI
O fornecedor documenta a configuração do Codex CLI com um servidor remoto e uma chave de conta enviada como token Bearer. Crie a chave no portal do serviço antes de executar os comandos.
#1 Best Overall
-
No terminal, defina a variável de ambiente com sua chave real. Substitua o texto entre aspas; o exemplo não contém uma chave funcional:
export CNPJIA_KEY="sua_chave" -
Registre o servidor MCP no Codex CLI:
codex mcp add cnpjia --url https://mcp.cnpj.ia.br --bearer-token-env-var CNPJIA_KEY -
Abra uma conversa com o agente e peça uma consulta compatível com as ferramentas disponíveis. O serviço documenta o envio da chave no cabeçalho
Authorization: Bearerem cada chamada.Recommended Free Tools
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Esses comandos e o endereço do servidor são os publicados pelo fornecedor para o Codex CLI. Consulte a documentação atual do cnpj.ia.br e do seu cliente MCP caso as opções ou os nomes de configuração tenham mudado.
Outros clientes
O fornecedor também documenta uma configuração para Claude Code:
claude mcp add --transport http cnpjia https://mcp.cnpj.ia.br --header "Authorization: Bearer $CNPJIA_KEY"
Rank #3
Para Claude Desktop, a documentação indica o uso da ponte mcp-remote; também há orientações para Cursor, Windsurf e agentes criados com a Responses API da OpenAI. Os passos não são intercambiáveis: use a configuração correspondente ao cliente escolhido.
Que consultas o agente pode fazer
Segundo a documentação do serviço, o servidor expõe quatro ferramentas:
consultar_cnpj: consulta o cadastro de uma empresa pelo CNPJ.buscar_empresas: pesquisa empresas com filtros. Para essa busca, o fluxo documentado usagerar_filtroantes debuscar_empresas.gerar_filtro: transforma uma descrição em linguagem natural em filtros estruturados.ver_uso: informa créditos e consumo.
Você pode formular pedidos como “Qual é a situação cadastral e o CNAE principal do CNPJ [número]?” ou “Me dá o telefone e os sócios do [nome da empresa]”. Para uma consulta segmentada, experimente “Quantas empresas de [setor] ativas existem em [cidade]?”; para verificar o saldo, “Quantos créditos ainda tenho este mês?”. São exemplos de perguntas apresentados pelo fornecedor, não uma garantia de que todo resultado estará disponível.
Créditos, custos e limites documentados
Os valores abaixo refletem a documentação do cnpj.ia.br atualizada em 23 de setembro de 2026. São condições comerciais do serviço nessa data, não preços ou limites permanentes.
| Ferramenta ou limite | Condição documentada |
|---|---|
| Plano Free | 60 créditos por mês |
Consulta basic |
1 crédito por consulta |
Consulta full |
6 créditos por consulta |
gerar_filtro |
1 crédito |
ver_uso |
0 créditos |
| Busca de empresas | Disponível em planos pagos; 1 crédito por empresa retornada, com até 20 resultados por página |
| Requisições por minuto | O limite depende do plano; quando houver limitação, a documentação recomenda respeitar o cabeçalho Retry-After |
Confirme os termos e limites vigentes na documentação do serviço antes de planejar consultas recorrentes ou segmentações amplas.
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Os dados não são necessariamente atuais em tempo real
O cnpj.ia.br descreve os dados como uma fotografia mensal dos dados abertos do CNPJ da Receita Federal, acrescida de enriquecimentos da Oportunidados. Cada resposta de consulta ou busca informa meta.data_as_of, a data da fotografia usada. A documentação consultada identificava a base como agosto de 2026; uma alteração cadastral feita depois da carga pode não aparecer até a atualização mensal seguinte. Confira essa data antes de tratar um resultado como atual.
Campos oficiais, enriquecidos e estimados
De acordo com o fornecedor, cadastro, situação cadastral, CNAE, endereço, porte, contatos declarados e dados societários vêm dos dados abertos da Receita Federal. Site e contatos adicionais são enriquecimentos da Oportunidados. A faixa de funcionários é estimada por um modelo estatístico próprio; a faixa de faturamento é derivada do porte informado e não representa faturamento apurado. Não interprete esses campos estimados como dados contábeis confirmados.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.MCP comercial e API governamental são caminhos diferentes
A Receita Federal administra o CNPJ. O catálogo oficial Conecta descreve três APIs de consulta, com conjuntos de campos distintos, e informa que o acesso se destina a órgãos públicos elegíveis, conforme o processo de adesão à plataforma (catálogo Conecta). Esse é um caminho institucional; o catálogo não apresenta o cnpj.ia.br como serviço governamental nem como servidor MCP.
| Caminho | Quem pode acessar | Como se integra | O que considerar |
|---|---|---|---|
| Servidor MCP do cnpj.ia.br | Usuários do serviço com as credenciais exigidas por ele | Configuração MCP no cliente compatível | Oferece consulta por CNPJ e busca segmentada; a busca está disponível em planos pagos segundo a documentação consultada. Os resultados indicam a data da fotografia mensal. |
| APIs do Conecta | Órgãos públicos elegíveis, segundo o catálogo | Acesso pela plataforma e integração direta conforme o serviço | O catálogo lista três APIs com conjuntos de campos diferentes. Ele não estabelece aqui uma comparação quantitativa de preços com o serviço comercial. |
Se você desenvolve uma aplicação própria e prefere integração direta, o fornecedor também documenta alternativas para além de MCP. Para escolher entre os caminhos, considere sua elegibilidade, o tipo de consulta, os campos necessários, o método de autenticação e a frequência de atualização exigida.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Uso responsável e restrições
O fornecedor informa que CPFs de sócios são mascarados e que contatos podem ser suprimidos a pedido. Seus termos proíbem contornar essa supressão, identificar pessoas físicas a partir dos dados, revender parte substancial da base enriquecida e enviar mensagens em massa não solicitadas sem observar a legislação e as regras do canal. Consulte os termos do serviço e siga a legislação aplicável e as regras da plataforma usada para qualquer contato comercial.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
