Usar com IA (MCP)

Conecte Claude, Cursor e VS Code à NextAPI pelo servidor MCP.

O servidor MCP (Model Context Protocol) da NextAPI permite que assistentes de IA como Claude, Cursor e VS Code consultem CNPJ, Simples Nacional, CEP e os demais dados da API diretamente na conversa, sem que você escreva código de integração.

https://api.nextapi.com.br/mcp

O servidor usa o transporte Streamable HTTP. Cada ferramenta corresponde a um endpoint da API e consome créditos como a chamada REST equivalente, respeitando os mesmos limites do seu plano.

Autenticação

Clientes compatíveis com OAuth, como Claude e Cursor, abrem o login da NextAPI na primeira conexão: entre com sua conta, autorize o acesso e o cliente passa a enviar o token sozinho. Para clientes sem OAuth, envie sua chave de API no cabeçalho Authorization: Bearer SEU_TOKEN, como nas chamadas REST. Veja onde obter e guardar o token.

Claude

No Claude (web ou desktop), abra Configurações › Conectores, escolha Adicionar conector personalizado e informe o nome NextAPI e a URL do servidor. Em seguida, clique em Conectar e faça login na NextAPI.

Claude Code

No terminal, adicione o servidor e depois execute /mcp no Claude Code para fazer login:

claude mcp add --transport http nextapi https://api.nextapi.com.br/mcp

Cursor

Adicione o servidor em ~/.cursor/mcp.json (ou em .cursor/mcp.json no projeto). O Cursor pede o login na NextAPI ao conectar:

{
  "mcpServers": {
    "nextapi": {
      "url": "https://api.nextapi.com.br/mcp"
    }
  }
}

VS Code

Crie .vscode/mcp.json no projeto e inicie o servidor pela lista de servidores MCP do VS Code:

{
  "servers": {
    "nextapi": {
      "type": "http",
      "url": "https://api.nextapi.com.br/mcp"
    }
  }
}

Outros clientes, com token

Se o cliente não suportar OAuth, configure o cabeçalho com sua chave de API. Guarde o arquivo fora de repositórios públicos, porque ele passa a conter um segredo:

{
  "mcpServers": {
    "nextapi": {
      "url": "https://api.nextapi.com.br/mcp",
      "headers": {
        "Authorization": "Bearer SEU_TOKEN"
      }
    }
  }
}

Ferramentas disponíveis

Os parâmetros de cada ferramenta são os mesmos do endpoint na referência da API, incluindo toleranceDays nas consultas de CNPJ e Simples Nacional (veja atualização dos dados).

Exemplos de pedidos

• “Consulte o CNPJ 00.000.000/0001-91 e diga se a empresa está ativa.”
• “Este fornecedor é optante pelo Simples Nacional? CNPJ 00.000.000/0001-91.”
• “Qual é o endereço do CEP 01001-000?”
• “Quantos créditos ainda tenho na NextAPI?”