Do these 3 things before closing this tab:
1Repair Windows errors before they cause bigger problems2Scan for outdated or missing drivers - takes under a minute3Clear out junk files and repair common Windows errorsiTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more
É possível conectar um agente de IA a dados de empresas brasileiras com um comando de configuração, mas não existe um comando universal que, sozinho, conceda acesso a qualquer base. Você precisa de um cliente compatível com MCP, de um servidor que ofereça as ferramentas de consulta e das credenciais desse serviço. Um exemplo documentado é o servidor remoto do cnpj.ia.br: https://mcp.cnpj.ia.br.
O que você precisa antes de configurar
- Um cliente MCP: o aplicativo ou agente de IA que se conecta às ferramentas.
- Um servidor MCP: neste exemplo, o serviço de terceiros cnpj.ia.br.
- Uma credencial válida: a chave de conta criada no portal do serviço.
MCP, ou Model Context Protocol, é um padrão aberto para conectar aplicações de IA a sistemas externos, não uma base de dados específica. A documentação oficial do protocolo o descreve como um padrão aberto para conectar aplicações de IA a sistemas externos. O servidor e os dados disponíveis dependem do serviço escolhido.
Conectar o Codex CLI ao servidor MCP
O exemplo a seguir é o comando documentado pelo cnpj.ia.br para Codex CLI. Substitua sua_chave pela chave real obtida no portal do serviço; o texto entre aspas é apenas um marcador de posição.
- Defina a chave no terminal:
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
O cliente usa a variável de ambiente para enviar a chave no cabeçalho Authorization: Bearer ao servidor. Não publique a chave nem a inclua em um repositório. Os nomes das opções e o procedimento podem mudar; confira as instruções atuais do cnpj.ia.br e do cliente que você usa.
#1 Best Overall
- More for the money with this high quality Product
- Offers premium quality at outstanding saving
- Excellent product
- 100% satisfaction
Claude Code
O fornecedor documenta este comando para Claude Code:
claude mcp add --transport http cnpjia https://mcp.cnpj.ia.br --header "Authorization: Bearer $CNPJIA_KEY"
Defina CNPJIA_KEY no ambiente do terminal antes de executar o comando. Para Claude Desktop, o fornecedor descreve uma configuração que usa a ponte mcp-remote; as instruções também incluem Cursor, Windsurf e agentes construídos com a Responses API da OpenAI. Consulte a documentação do serviço e do cliente para obter o formato correspondente, em vez de reutilizar o comando do Codex CLI sem alterações.
The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →O que o agente consegue consultar
De acordo com a documentação do servidor, ele oferece quatro ferramentas:
consultar_cnpj: consulta um cadastro pelo CNPJ.buscar_empresas: pesquisa empresas com filtros; o fluxo descrito usagerar_filtropara transformar um pedido em linguagem natural em filtros estruturados e, em seguida,buscar_empresas.gerar_filtro: converte uma descrição em linguagem natural em filtros estruturados.ver_uso: mostra créditos e consumo.
Depois da configuração, você pode fazer perguntas como “Qual é a situação cadastral e o CNAE principal do CNPJ 00.000.000/0001-91?” ou “Quantas empresas de software ativas existem em Florianópolis?”. A documentação também exemplifica pedidos de telefone e sócios de uma empresa e perguntas sobre créditos restantes. O que o agente pode responder depende das ferramentas, dos dados disponíveis e das permissões da conta.
Créditos e limites documentados
Os valores abaixo são os publicados pelo cnpj.ia.br em sua documentação MCP atualizada em 23 de setembro de 2026. São condições comerciais do fornecedor nessa data, não garantias permanentes.
Rank #3
- Product type: Screw kit
- Made by Super Micro
- Manufacturer part number: MCP-410-00005-0N
- Supermicro MCP-410-00005-0N Screw Bag(100PCS) and Label for 24x Hot swap
- Mfr Part Number: MCP-410-00005-0N
| Operação | Custo ou disponibilidade 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 por geração. |
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. |
| Limite de requisições | Depende do plano. Se houver limitação, a documentação recomenda respeitar o cabeçalho Retry-After. |
Use ver_uso para acompanhar o consumo. Como a busca custa por empresa retornada, uma página com vários resultados consome mais créditos do que uma leitura de uso; verifique o plano e os limites atuais antes de automatizar consultas.
O que os dados representam — e o que não representam
O fornecedor descreve o serviço como uma fotografia mensal de dados abertos do CNPJ da Receita Federal, combinada com enriquecimentos da Oportunidados. As respostas de consulta e busca incluem meta.data_as_of, que indica a data da base usada; a documentação consultada identificava a base como agosto de 2026. Uma mudança feita no cadastro hoje pode não aparecer até uma carga mensal posterior. Confira essa data antes de tratar uma resposta como atual.
Segundo o fornecedor, cadastro, situação cadastral, CNAE, endereço, porte, contatos declarados e dados societários vêm de 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 equivale a faturamento apurado.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.O MCP comercial não é a API governamental do CNPJ
O servidor MCP do cnpj.ia.br é um serviço de terceiros. Ele não é apresentado como um servidor MCP governamental. Já o catálogo oficial Conecta descreve APIs de consulta administradas no contexto da Receita Federal, com conjuntos diferentes de campos e acesso destinado a órgãos públicos elegíveis conforme o processo de adesão à plataforma. A elegibilidade e o modo de acesso, portanto, são distintos.
O MCP oferece uma configuração pronta para clientes compatíveis; uma integração direta por API REST é outro caminho técnico. A documentação disponível não permite comparar quantitativamente os preços dos dois caminhos. Para saber se a API Conecta atende a uma necessidade institucional, consulte o catálogo oficial Conecta e os requisitos de adesão aplicáveis.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Uso responsável e restrições
Os termos do fornecedor dizem que CPFs de sócios são mascarados e que contatos podem ser suprimidos a pedido. Também proíbem contornar supressões, 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 lei e as regras do canal.
Em prospecção B2B, trate a disponibilidade de um contato como dado, não como autorização irrestrita para abordá-lo. Siga os termos do serviço, a legislação aplicável e as regras da plataforma ou do canal usado.
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.
