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.

MCP de CPF e CNPJ: dê acesso aos dados a um agente de IA

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

Pegue a chave. Crie a conta no portal, com teste grátis de 24 horas e sem cartão, e gere a chave de API.
Adicione o servidor ao seu cliente. Veja abaixo os exemplos. A documentação também traz a configuração do VS Code e do Claude Desktop.
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

Terminal

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:

mcp.json

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

O servidor está no registro oficial do MCP 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:

Exemplos de pedidos ao agente e as ferramentas usadas
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 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?

Quando usar o MCP e quando usar a 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
Fluxo recorrente em produção, como enriquecer todo lead novo	API com automação
Listas grandes, com controle de custo	Script pela API
Entrega por webhook, com até 100 itens por pedido	Lote, que não está no MCP

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