O Model Context Protocol (MCP) é um padrão aberto para conectar agentes de IA a ferramentas externas. Com o servidor MCP da Simples API, o agente descobre sozinho as ferramentas de leitura de placas e consulta de veículos e decide quando usá-las, sem você escrever código de integração.

Funciona no ChatGPT e no Claude.ai?

Ainda não. Os conectores do ChatGPT e do Claude.ai exigem login por OAuth, que está em desenvolvimento. Hoje funcionam os clientes que aceitam a API key no header: Claude Code, Cursor, VS Code, Windsurf, n8n e agentes próprios feitos com as APIs da Anthropic e da OpenAI ou com o SDK do MCP.

Não. No n8n você monta o fluxo arrastando nós e só cola a URL do servidor e a sua API key. Nos agentes de código, basta um comando ou um arquivo de configuração.

O mesmo que a API REST: R$ 0,05 por placa lida, R$ 0,10 por consulta de veículo (com ou sem dados retornados) e nada para consultar o saldo. Erros, como placa inválida ou imagem sem placa lida, não são cobrados. Ao criar a conta, você recebe R$ 5 em créditos grátis.

O agente pode gastar meu saldo sem eu saber?

As ferramentas pagas vêm marcadas para que o cliente peça 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. Toda chamada aparece no histórico de requisições.

Qual a diferença para a API REST?

Nenhuma no resultado nem no preço: cada ferramenta chama o endpoint REST correspondente com a sua API key. A diferença é quem decide a chamada: com MCP, o agente de IA escolhe a ferramenta e monta os parâmetros a partir do seu pedido em português.

As imagens ficam guardadas?

Não. As imagens, enviadas por URL ou em base64, são processadas em memória e descartadas logo depois. Nada é armazenado.

Novo · MCP

Placas e dados de veículos direto no seu agente de IA

Conecte Claude Code, Cursor, VS Code, n8n ou o seu próprio agente à Simples API pelo Model Context Protocol. O agente lê placas em fotos e consulta veículos sozinho, com a mesma API key e o mesmo preço da API REST.

ferramentas

1 comando

para conectar

Mesmo preço

da API REST

Começar com R$ 5 grátis Ver como conectar

Na prática

Peça em português

Quais placas aparecem nesta foto e de que carros são? foto da placa KLV-8465

Ferramenta da Simples API

read_plates_from_image({ "image_url": "https://upload.wikimedia.org/.../KLV-8465_atrás.jpg", "include_vehicle_info": true
})

1 placa lida, 1 veículo consultado: R$ 0,15

Encontrei uma placa na foto:

KLV-8465: VW Gol 16V, ano 2000, branco, gasolina, registrado em Custódia/PE.

Ferramentas

O que o agente pode fazer

lookup_vehicle_by_plate

Consultar veículo pela placa

Marca, modelo, versão, ano, cor, combustível, município e UF a partir da placa em texto.

POST /v1/vehicle/plate

R$ 0,10 por consulta, com ou sem dados

read_plates_from_image

Ler placas de uma imagem

Lê as placas de uma foto enviada por URL https ou em base64 e, se pedido, traz os dados de cada veículo.

POST /v1/ocr/plate

R$ 0,05 por placa lida, mais R$ 0,10 por placa consultada

get_balance

Ver o saldo

Saldo pré-pago da conta e o limite do alerta de saldo baixo.

GET /v1/billing/balance

Grátis

Passo a passo

Como conectar

Troque SUA_API_KEY pela sua API key. Na aba IA (MCP) do painel, os trechos vêm com a sua chave preenchida logo depois do cadastro ou de gerar uma nova chave.

Claude Code

Cursor

VS Code

Windsurf / Devin Desktop

n8n

API da Anthropic

API da OpenAI

SDK do MCP

Agente de código

Abra o terminal na pasta do seu projeto.
Rode o comando abaixo para adicionar o servidor da Simples API.
Abra o Claude Code e digite /mcp: o servidor "simples-api" deve aparecer conectado.
Peça ao agente: "Qual é o meu saldo na Simples API?". A consulta de saldo é grátis.

Terminal

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

Para usar em todos os projetos, acrescente --scope user logo depois de --transport http.

Documentação do Claude Code

Passo a Passo

Como funciona

Crie a conta

Cadastre-se, ganhe R$ 5 em créditos e copie a sua API key.

Conecte o agente

Um comando no Claude Code ou um arquivo de configuração nos outros clientes.

Peça em português

O agente escolhe a ferramenta certa e monta os parâmetros sozinho.

Pague só o que usar

Cada chamada é cobrada como na API REST e aparece no seu histórico.

Aplicações

Casos de Uso

Devs integrando a API

Teste a leitura de placas e a consulta de veículos no próprio editor, pedindo em português, antes de escrever a integração.

Operação e logística no n8n

Leia as placas das fotos que chegam por e-mail ou WhatsApp e registre os veículos sem digitar nada.

Atendimento de locadoras e seguradoras

Dê ao seu agente de atendimento a consulta do veículo pela placa ou pela foto enviada pelo cliente.

Conferência de fotos e documentos

Peça ao agente para conferir em lote as placas de fotos de vistoria e solicitações.

Agentes próprios da empresa

Ligue a Simples API ao agente que você já tem na API da Anthropic, na da OpenAI ou com o SDK do MCP.

Segurança

Segurança e controle

Confirmação antes de gastar

As ferramentas pagas vêm marcadas para o cliente pedir sua confirmação antes de usá-las.

A chave fica com você

A API key fica na configuração do seu cliente e vai só no header de cada chamada.

Saldo pré-pago

O gasto nunca passa do que você recarregou, e o alerta de saldo baixo avisa antes de acabar.

URLs de imagem protegidas

O download aceita só https para endereços públicos, então ninguém usa o servidor para acessar redes internas.

Nada armazenado

As imagens são processadas em memória e descartadas logo depois.

Tudo no histórico

Cada chamada aparece no histórico de requisições do painel, igual às chamadas da API REST.

FAQ

Perguntas Frequentes

Comece agora com R$ 5 grátis

Crie sua conta, copie a API key e conecte o seu agente em minutos. Sem cartão de crédito.

Criar conta grátis