Pular para o conteúdo

Servidor MCP

O Placa & FIPE tem um servidor MCP (Model Context Protocol) remoto. Com ele, o seu assistente de IA consulta placas direto na conversa ("qual o valor FIPE da placa ABC1D23?") e usa os dados reais enquanto escreve o seu código.

  • URL: https://api.placaefipe.com.br/mcp
  • Transporte: Streamable HTTP
  • Autenticação: cabeçalho Authorization: Bearer pf_live_...

Ferramentas

FerramentaO que fazCusto
consultar_placaRecebe placa e devolve veículo + FIPE (mesmo JSON da API)1 crédito se encontrar
consultar_saldoMostra os créditos restantesGrátis

Claude Code

bash
claude mcp add --transport http placaefipe https://api.placaefipe.com.br/mcp \
  --header "Authorization: Bearer pf_live_sua_chave"

Confira com claude mcp list. Para valer em todos os projetos, adicione --scope user.

Cursor

Arquivo .cursor/mcp.json no projeto (ou ~/.cursor/mcp.json para todos):

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

Gemini CLI

Arquivo ~/.gemini/settings.json (ou .gemini/settings.json no projeto):

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

Dentro do Gemini CLI, /mcp mostra o servidor conectado e as ferramentas.

Google Antigravity

No painel do agente, abra ⋯ → MCP Servers → Manage MCP Servers → View raw config e adicione ao mcp_config.json:

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

OpenAI Codex

Arquivo ~/.codex/config.toml:

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

E exporte a chave no terminal: export PLACAEFIPE_API_KEY=pf_live_sua_chave.

Windsurf

Arquivo ~/.codeium/windsurf/mcp_config.json:

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

VS Code (GitHub Copilot)

Arquivo .vscode/mcp.json:

json
{
  "servers": {
    "placaefipe": {
      "type": "http",
      "url": "https://api.placaefipe.com.br/mcp",
      "headers": { "Authorization": "Bearer ${input:placaefipe-key}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "placaefipe-key", "description": "Chave Placa & FIPE", "password": true }
  ]
}

Claude Desktop

O Claude Desktop conecta servidores remotos com cabeçalho pelo mcp-remote. Em Settings → Developer → Edit Config:

json
{
  "mcpServers": {
    "placaefipe": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://api.placaefipe.com.br/mcp",
        "--header", "Authorization: Bearer ${PLACAEFIPE_API_KEY}"
      ],
      "env": { "PLACAEFIPE_API_KEY": "pf_live_sua_chave" }
    }
  }
}

Testar sem IA

bash
curl https://api.placaefipe.com.br/mcp \
  -H "Authorization: Bearer $PLACAEFIPE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

MCP ou API?

  • MCP: para a IA consultar placas enquanto conversa ou programa com você.
  • API REST: para o seu sistema consultar placas em produção. O MCP não substitui a integração no código.