Como consultar placas e veículos pelo Claude Code, Cursor e n8n com MCP

Agentes de IA já escrevem código, respondem clientes e automatizam processos. Com o servidor MCP da Simples API, eles também leem placas em fotos e consultam os dados do veículo pela placa, sem você escrever uma linha de integração.

Neste tutorial você conecta o Claude Code, o Cursor e o n8n à Simples API e faz a primeira consulta.

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto para ligar agentes de IA a ferramentas externas. O agente se conecta a um servidor MCP, descobre as ferramentas que ele oferece e decide sozinho quando usar cada uma.

O servidor da Simples API fica em https://api.simplesapi.com.br/mcp e oferece três ferramentas:

O preço é o mesmo da API REST, e cada chamada aparece no histórico do painel.

Antes de começar

1. Crie sua conta em simplesapi.com.br/register. Você ganha R$ 5 em créditos grátis.
2. Copie a sua API key no painel. Ela começa com sk_live_.

Nos exemplos abaixo, troque SUA_API_KEY pela sua chave.

Claude Code

No terminal, na pasta do seu projeto, rode:

claude mcp add--transport http simples-api https://api.simplesapi.com.br/mcp --header"Authorization: Bearer SUA_API_KEY"

Abra o Claude Code e digite /mcp: o servidor simples-api deve aparecer conectado. Depois, peça:

Qual é o meu saldo na Simples API?

A consulta de saldo é grátis e confirma que tudo funciona.

Cursor

Crie o arquivo ~/.cursor/mcp.json (vale para todos os projetos) com:

{"mcpServers":{"simples-api":{"url":"https://api.simplesapi.com.br/mcp","headers":{"Authorization":"Bearer SUA_API_KEY"}}}}

Nas configurações do Cursor, na seção de MCP, confira que simples-api aparece com as três ferramentas e faça o mesmo teste do saldo no chat.

n8n

No n8n você monta o fluxo sem programar:

1. Adicione um nó AI Agent com um modelo de chat.
2. Ligue ao AI Agent um nó MCP Client Tool.
3. Em Endpoint, cole https://api.simplesapi.com.br/mcp e deixe o transporte HTTP Streamable.
4. Em Authentication, escolha Bearer Auth e crie uma credencial com a sua API key no campo Bearer Token.
5. Teste o fluxo com a mensagem "Qual é o meu saldo na Simples API?".

A partir daí, o agente do fluxo consegue ler as placas das fotos que chegam por e-mail ou WhatsApp e registrar os veículos.

Fazendo a primeira consulta

Com o agente conectado, peça em português:

Quais placas aparecem nesta foto e de que carros são? https://upload.wikimedia.org/wikipedia/commons/2/28/Placa_de_ve%C3%ADculo_Brasil_Pernambuco-Jaboat%C3%A3o_dos_Guararapes_KLV-8465_atr%C3%A1s.jpg

O agente chama read_plates_from_image com a URL da foto, lê a placa KLV-8465 e, com os dados do veículo, responde que é um VW Gol 16V, ano 2000, registrado em Custódia/PE. Custo: R$ 0,15 (uma placa lida e um veículo consultado).

E o meu saldo?

As ferramentas pagas vêm marcadas para o cliente pedir sua confirmação antes de usá-las, e Claude Code, Cursor e VS Code pedem por padrão. O saldo é pré-pago, então o gasto nunca passa do que você recarregou, e você pode ligar o alerta de saldo baixo no painel.

Outros clientes

O passo a passo para VS Code, Windsurf (Devin Desktop), API da Anthropic, API da OpenAI e o SDK do MCP está na página Integração com IA (MCP). Logado, a aba IA (MCP) do painel mostra os trechos de configuração com a URL certa e, logo depois do cadastro ou de gerar uma nova chave, com a sua chave preenchida.

Os conectores do ChatGPT e do Claude.ai ainda não são suportados, porque exigem login por OAuth, que está em desenvolvimento.