Como funciona
O Claude Code lê o repositório, roda comandos e edita arquivos no terminal. Ele segue o guia em Markdown do Placa & FIPE, escreve o cliente no servidor e testa sem gastar créditos.
1. Copie o pedido para o Claude Code
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.
Pedido para colar
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
- Abra o terminal na pasta do projeto e rode
claude. - Cole o pedido pronto (botão "Copiar instruções para a IA").
- Quando ele pedir, coloque a chave em
.env.localcomoPLACAEFIPE_API_KEY. - Revise o diff: o cliente deve estar só em código de servidor.
- Opcional: salve a skill em
.claude/skills/placaefipe/SKILL.mdpara as próximas tarefas.
3. Servidor MCP no Claude Code
Com o MCP, o Claude Code consulta placas reais na conversa (ferramentas consultar_placa e consultar_saldo). Troque pf_live_sua_chave pela chave do seu painel.
Terminal
claude mcp add --transport http placaefipe https://api.placaefipe.com.br/mcp \ --header "Authorization: Bearer pf_live_sua_chave"
Use --scope user para valer em todos os projetos. claude mcp list confirma a conexão.
Dicas
- Adicione a regra do Placa & FIPE ao
CLAUDE.mddo projeto para o Claude lembrar da integração. - Peça "consulte a placa ABC1D23 e preencha o seed do banco com esses dados" depois de conectar o MCP.