Placa & FIPE no Gemini CLI

Como funciona

O Gemini CLI é o agente de terminal do Google. Ele lê arquivos de contexto (`GEMINI.md`) e conecta servidores MCP pelo `settings.json`.

1. Copie o pedido para o Gemini CLI

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. Adicione o servidor MCP ao ~/.gemini/settings.json (abaixo).
2. Rode gemini na pasta do projeto e confira com /mcp.
3. Cole o pedido pronto para ele integrar a API no código.
4. Adicione a regra do Placa & FIPE ao GEMINI.md do projeto.

3. Servidor MCP no Gemini CLI

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

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

No Gemini CLI o campo é httpUrl (Streamable HTTP), não url.

Dicas

• Para projetos de equipe, use .gemini/settings.json no projeto e a chave por variável de ambiente.
• O mesmo GEMINI.md é lido pelo Gemini Code Assist no VS Code.

Referências

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