Placa & FIPE no OpenAI Codex

Como funciona

O Codex lê o `AGENTS.md` do projeto e conecta servidores MCP declarados no `~/.codex/config.toml`, inclusive remotos com token Bearer por variável de ambiente.

1. Copie o pedido para o OpenAI Codex

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 ao ~/.codex/config.toml (abaixo).
2. Exporte a chave: export PLACAEFIPE_API_KEY=pf_live_sua_chave.
3. Rode codex no projeto e cole o pedido pronto.
4. Adicione a regra do Placa & FIPE ao AGENTS.md.

3. Servidor MCP no OpenAI Codex

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

[mcp_servers.placaefipe]
url = "https://api.placaefipe.com.br/mcp"
bearer_token_env_var = "PLACAEFIPE_API_KEY"

Dicas

• O AGENTS.md também é lido por outras ferramentas (Cursor, Jules, Amp), então a regra vale para todas.
• No ChatGPT (web), use a especificação OpenAPI em um GPT com Actions.

Referências

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