# 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

| Ferramenta | O que faz | Custo |
|---|---|---|
| `consultar_placa` | Recebe `placa` e devolve veículo + FIPE (mesmo JSON da API) | 1 crédito se encontrar |
| `consultar_saldo` | Mostra os créditos restantes | Grá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.