# Como dar a um agente de IA acesso a dados de CPF e CNPJ com MCP

> Versão em Markdown de https://datax.plus/guias/mcp-agente-ia-consultar-cpf-cnpj/

Com o servidor MCP da DataX, o seu agente de IA consulta sócios, empresas e pessoas sozinho, a partir de um pedido em português. A conexão leva um minuto. Veja como configurar, o que pedir e que cuidados tomar.

Por [Equipe DataX](https://datax.plus/) · Publicado em 4 de novembro de 2026 · 5 min de leitura

Resposta curta

MCP (Model Context Protocol) é um protocolo aberto que permite a agentes de IA usar ferramentas externas. O servidor da DataX fica em `https://mcp.datax.plus/mcp` e recebe a sua chave de API no cabeçalho `api-key`. Depois de adicionar esse endereço ao seu cliente, como Claude Code, Cursor ou VS Code, basta pedir em português, por exemplo: "quem são os sócios deste CNPJ e qual é o contato deles?". Cada consulta consome requisições do seu plano, como pela API.

## Como conectar

1. **Pegue a chave.** [Crie a conta no portal](https://portal.datax.plus/auth/cadastro), com teste grátis de 24 horas e sem cartão, e gere a chave de API.
2. **Adicione o servidor ao seu cliente.** Veja abaixo os exemplos. A [documentação](https://datax.plus/docs/#mcp) também traz a configuração do VS Code e do Claude Desktop.
3. **Teste a conexão.** Peça ao agente: "qual é o limite do meu plano na DataX?". Esse pedido usa a ferramenta `limite_do_plano` e não consome requisições.

### Claude Code

```bash
claude mcp add --transport http datax https://mcp.datax.plus/mcp \
  --header "api-key: SUA_CHAVE"
```

### Cursor

No arquivo `~/.cursor/mcp.json`, ou em `.cursor/mcp.json` no projeto:

```json
{
  "mcpServers": {
    "datax": {
      "url": "https://mcp.datax.plus/mcp",
      "headers": { "api-key": "SUA_CHAVE" }
    }
  }
}
```

O servidor está no [registro oficial do MCP](https://registry.modelcontextprotocol.io/v0/servers?search=plus.datax) com o nome `plus.datax/datax`. Ele ainda não funciona nos conectores do claude.ai e do ChatGPT, que exigem login por OAuth.

## O que pedir ao agente

Você não precisa citar o nome da ferramenta: o agente escolhe qual usar. Estes são alguns pedidos e o que eles acionam:

| Pedido | Ferramenta | Consome |
| --- | --- | --- |
| Quem são os sócios do CNPJ 11.222.333/0001-81, e qual é o contato deles? | `socios_cnpj` | 1 por sócio retornado |
| Essa empresa é optante do Simples? Qual é a atividade principal? | `ficha_cnpj` | 1 |
| Atualize o contato deste cliente, CPF 123.456.789-09. | `contatos_cpf` | 1 |
| Veja a situação deste CPF na Receita e se há registro de óbito. | `ficha_cpf` | 1 |
| De quem é este telefone, e ele tem WhatsApp? | `reverso_telefone` | 1 |
| Quanto eu consumi nos últimos 30 dias? | `consumo_do_plano` | Não consome |

A [tabela completa](https://datax.plus/docs/#mcp) lista as 11 ferramentas. O agente também combina consultas com o restante do trabalho, como ler uma lista de CNPJs do projeto, buscar a ficha de cada um e devolver um resumo.

## Cuidados

- **Os dados pessoais passam pela sua ferramenta de IA.** A resposta de cada consulta entra na conversa do agente, e por isso também passa pelo provedor do modelo. Confira a política de dados da ferramenta e se esse uso cabe na sua base legal da LGPD. Para dados sensíveis ao seu negócio, prefira uma integração direta pela API.
- **O agente pode gastar o seu limite.** Um pedido amplo, como "enriqueça esta lista", vira muitas chamadas. Mantenha a aprovação de cada chamada ligada nas primeiras vezes, defina um número máximo no pedido e confira o consumo depois.
- **Sua chave fica no arquivo de configuração.** Não envie esse arquivo para o repositório de código. No VS Code, a configuração da documentação pede a chave na primeira vez e a guarda com segurança.
- **Confira o que o agente concluiu.** O modelo pode resumir ou interpretar errado uma resposta correta da API. Em decisões importantes, olhe o dado original.
- **Mantenha as permissões do agente restritas.** Se ele também pode executar ações no seu computador ou nos seus sistemas, não libere tudo: um texto vindo de uma consulta não deve virar uma ordem.

## Agente ou API direta?

| Situação | Melhor opção |
| --- | --- |
| Análises pontuais e perguntas sobre uma empresa ou pessoa | MCP |
| Listas pequenas, com o agente ajudando a limpar e a resumir | MCP |
| Experimentar a API antes de programar | MCP |
| Consultas pontuais, sem programar e sem agente | [Portal da DataX](https://datax.plus/#portal) |
| Fluxo recorrente em produção, como enriquecer todo lead novo | [API com automação](https://datax.plus/guias/enriquecer-crm-n8n-make-zapier/) |
| Listas grandes, com controle de custo | [Script pela API](https://datax.plus/guias/enriquecer-planilha-cnpj-api/) |
| Entrega por webhook, com até 100 itens por pedido | [Lote](https://datax.plus/api-lote-cpf-cnpj/), que não está no MCP |

## Dúvidas sobre o MCP da DataX

### O que é um servidor MCP?

É um serviço que expõe ferramentas para agentes de IA pelo Model Context Protocol, um protocolo aberto. O servidor da DataX permite que o agente consulte sócios, CNPJ e CPF sem que você escreva uma integração.

### Quais clientes funcionam com o MCP da DataX?

Claude Code, Cursor, VS Code, Claude Desktop (usando o mcp-remote) e outros clientes MCP que aceitem o transporte Streamable HTTP com cabeçalho de autenticação.

### Funciona no ChatGPT e no claude.ai?

Ainda não nos conectores desses produtos, que exigem login por OAuth. Hoje a autenticação é feita com a chave de API no cabeçalho.

### O MCP custa mais do que a API?

Não. Cada consulta consome requisições do seu plano do mesmo jeito que pela API. As ferramentas de limite e de consumo não consomem.

### Funciona com o teste grátis?

Sim. As consultas incluídas no teste funcionam pelo MCP, dentro das 20 chamadas do período. Empresas recentes é só do plano Avançado.

### O servidor guarda a minha chave?

Não. O servidor só repassa a chave para a API a cada chamada e não a guarda.

## Conecte o seu agente hoje, com o teste grátis de 24 horas, sem cartão.

[Começar teste grátis](https://portal.datax.plus/auth/cadastro) [Ver a configuração do MCP](https://datax.plus/docs/#mcp)