Placa & FIPE no Windsurf

Como funciona

O Cascade, agente do Windsurf, usa ferramentas MCP configuradas no `mcp_config.json` do usuário.

1. Copie o pedido para o Windsurf

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. Abra Settings → Cascade → MCP Servers → View raw config.
2. Adicione o bloco abaixo e clique em Refresh.
3. Cole o pedido pronto no Cascade.
4. Crie uma regra em .windsurf/rules com o resumo da integração.

3. Servidor MCP no Windsurf

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

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

Dicas

• Depois do Refresh, as ferramentas consultar_placa e consultar_saldo aparecem na lista do Cascade.

Referências

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