# Usar com IA (MCP)

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

Fonte: https://www.nextapi.com.br/docs/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](https://www.nextapi.com.br/docs/autenticacao).

## 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:

```bash
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:

```json
{
  "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:

```json
{
  "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:

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

## Ferramentas disponíveis

| Ferramenta | O que consulta |
| --- | --- |
| `Cnpj_Get` | [Dados cadastrais do CNPJ](https://www.nextapi.com.br/docs/api/get-v1-cnpj-cnpj) |
| `Cnpj_GetSimples` | [Simples Nacional e MEI do CNPJ](https://www.nextapi.com.br/docs/api/get-v1-cnpj-cnpj-simples) |
| `Cnpj_GetInscricoesEstaduais` | [Inscrições Estaduais do CNPJ](https://www.nextapi.com.br/docs/api/get-v1-cnpj-cnpj-ie) |
| `Cnpj_PostBatch` | [CNPJs em lote](https://www.nextapi.com.br/docs/api/post-v1-cnpj-batch) |
| `Cnpj_PostSimplesBatch` | [Simples Nacional em lote](https://www.nextapi.com.br/docs/api/post-v1-cnpj-batch-simples) |
| `Empresas_Get` | [Busca de empresas por filtros](https://www.nextapi.com.br/docs/api/get-v1-empresas) |
| `Ceps_GetByCep` | [Consulta de CEP por número](https://www.nextapi.com.br/docs/api/get-v1-ceps-cep) |
| `Ceps_Search` | [Pesquisa avançada de CEPs](https://www.nextapi.com.br/docs/api/get-v1-ceps) |
| `Ceps_GeoSearch` | [CEPs próximos de uma latitude/longitude](https://www.nextapi.com.br/docs/api/get-v1-ceps-geo) |
| `Ceps_GeoSearchByCep` | [CEPs próximos de um CEP](https://www.nextapi.com.br/docs/api/get-v1-ceps-geo-cep) |
| `Cnaes_GetAll` | [Lista de CNAEs](https://www.nextapi.com.br/docs/api/get-v1-cnaes) |
| `Estados_GetAll` | [Lista de estados](https://www.nextapi.com.br/docs/api/get-v1-estados) |
| `Municipios_GetAll` | [Lista de municípios](https://www.nextapi.com.br/docs/api/get-v1-municipios) |
| `Municipios_GetById` | [Município por ID](https://www.nextapi.com.br/docs/api/get-v1-municipios-id) |
| `Credits_Get` | [Saldo de créditos e limites](https://www.nextapi.com.br/docs/api/get-v1-credits) |

Os parâmetros de cada ferramenta são os mesmos do endpoint na [referência da API](https://www.nextapi.com.br/docs/referencia), incluindo `toleranceDays` nas consultas de CNPJ e Simples Nacional (veja [atualização dos dados](https://www.nextapi.com.br/docs/atualizacao-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?”

> O assistente decide quando chamar cada ferramenta, e cada chamada consome créditos. Em tarefas com muitos registros, peça consultas em lote e acompanhe o saldo com `Credits_Get`.