Placa & FIPE no Cursor

Como funciona

No modo Agent, o Cursor edita vários arquivos e usa ferramentas MCP. Com o servidor conectado, ele consulta placas reais enquanto monta telas e testes.

1. Copie o pedido para o Cursor

O pedido aponta para o guia oficial para agentes, que explica onde guardar a chave, como escrever o cliente no servidor, como mostrar a FIPE e como tratar cada erro.

Integre a API Placa & FIPE (consulta de veículo pela placa com valor FIPE) neste projeto.
Leia e siga o guia oficial para agentes: https://placaefipe.com.br/guia-ia.md

Resumo: GET https://api.placaefipe.com.br/v1/placas/{placa}
Cabeçalho: Authorization: Bearer <PLACAEFIPE_API_KEY>
A chamada deve ficar só no servidor; a chave vem da variável de ambiente PLACAEFIPE_API_KEY.

Antes de escrever código, identifique a stack do projeto.
No fim, me diga onde colocar a chave e como testar.

2. Passo a passo

1. Crie .cursor/mcp.json com a configuração abaixo (ou use Settings → MCP → Add new MCP server).
2. Abra o chat em modo Agent e cole o pedido pronto.
3. Coloque a chave em .env.local e confira se o .env.local está no .gitignore.
4. Crie a regra .cursor/rules/placaefipe.mdc com o resumo da integração.

3. Servidor MCP no Cursor

Com o MCP, o Cursor consulta placas reais na conversa (ferramentas consultar_placa e consultar_saldo). Troque pf_live_sua_chave pela chave do seu painel.

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

Dicas

• Não faça commit do .cursor/mcp.json com a chave. Use ~/.cursor/mcp.json para guardar fora do projeto.
• Em Settings → MCP, o ponto verde ao lado de "placaefipe" indica que as duas ferramentas carregaram.

Referências

• Documentação da API
• Servidor MCP em todas as ferramentas
• llms-full.txt e openapi.json