# Servidor MCP

import Seo from "../src/Seo";

<Seo {...frontmatter} path="/servidor-mcp" />

Com o **servidor MCP da FIPE API**, você consulta a tabela FIPE em linguagem natural, no assistente de IA que já usa para programar. Você escreve a pergunta, o assistente consulta a API e mostra a resposta na conversa. Você não escreve requisições HTTP nem procura códigos de marca e modelo.

O [Model Context Protocol](https://modelcontextprotocol.io) (MCP) é o padrão que liga assistentes de IA a serviços externos. Claude Code, Cursor e VS Code têm suporte ao protocolo.

![Claude Code mostra o resultado de uma consulta por placa feita pelo servidor MCP da FIPE API, com marca, modelo, ano, cor, cidade, código FIPE e preço FIPE](/mcp-usage.png)

*Consulta por placa no Claude Code. O assistente consultou a FIPE API e montou a tabela com a resposta.*

## O que você pode perguntar

- "Qual é o preço FIPE de um Honda Civic EXL 2020?"
- "Consulte a placa ABC1D23."
- "Mostre o histórico de preços desse modelo."
- "Quanto esse carro valia em junho de 2026?"
- "Compare o preço do Onix e do HB20, os dois de 2023."
- "Liste os modelos de motos da Yamaha."

O servidor responde a consultas sobre carros, motos e caminhões:

- **Preço FIPE** de um veículo, por marca, modelo e ano.
- **Preço por código FIPE**, quando você já tem o código.
- **Consulta por placa**, com os dados do veículo e o preço FIPE.
- **Histórico de preços** de um veículo, mês a mês.
- **Meses anteriores**, para saber o valor de um veículo em outra data.
- **Listas** de marcas, modelos e anos disponíveis.

## Antes de começar

Você precisa de uma conta em [fipe.api.br](https://fipe.api.br/register). O cadastro é gratuito.

O endereço do servidor é o mesmo em todos os clientes:

```
https://mcp.fipe.api.br/mcp
```

## Conectar o servidor

### Claude Code

1. Execute o comando abaixo no terminal:

   ```bash
   claude mcp add --transport http fipe https://mcp.fipe.api.br/mcp
   ```

2. Abra o Claude Code e execute o comando `/mcp`.
3. Selecione o servidor `fipe` e inicie a autenticação. O navegador abre a página da FIPE API.
4. Entre com a sua conta e selecione **Autorizar**.

### Cursor

1. Abra o arquivo `~/.cursor/mcp.json`. Para configurar um só projeto, use `.cursor/mcp.json` na raiz do projeto.
2. Adicione o servidor:

   ```json
   {
     "mcpServers": {
       "fipe": {
         "url": "https://mcp.fipe.api.br/mcp"
       }
     }
   }
   ```

3. Quando o Cursor abrir o navegador, entre com a sua conta e selecione **Autorizar**.

### VS Code

1. Crie o arquivo `.vscode/mcp.json` na raiz do projeto:

   ```json
   {
     "servers": {
       "fipe": {
         "type": "http",
         "url": "https://mcp.fipe.api.br/mcp"
       }
     }
   }
   ```

2. Inicie o servidor `fipe` no VS Code.
3. Quando o VS Code abrir o navegador, entre com a sua conta e selecione **Autorizar**.

### Outros clientes

Use o mesmo endereço em qualquer cliente com suporte a servidores MCP remotos. Na primeira conexão, o cliente abre o login no navegador.

## Primeira consulta

1. Escreva a pergunta na conversa. Exemplo: "Qual é o preço FIPE de um Honda Civic EXL 2020?"
2. Se o cliente pedir a sua confirmação para usar o servidor `fipe`, confirme.
3. Leia a resposta. Os preços são do mês de referência mais recente da tabela FIPE.

A conversa mantém o contexto. Depois da primeira resposta, você pode pedir o histórico de preços ou uma comparação com outro modelo, sem repetir os dados do veículo.

:::tip

Para respostas mais precisas, informe a versão, o ano e o combustível do veículo. Se você sabe o código FIPE, informe o código: a consulta é mais rápida e usa menos requisições do seu plano.

:::

## Consulta por placa

Informe a placa na pergunta, no formato antigo (`ABC1234`) ou no formato Mercosul (`ABC1D23`). A resposta traz marca, modelo, ano, cor, combustível, cidade, UF, código FIPE e preço FIPE, como na imagem no início desta página.

A consulta por placa está em fase Alpha e pode mudar.

## Limites e planos

As consultas pelo assistente usam os limites do plano da sua conta. Uma pergunta pode usar mais de uma requisição. Por exemplo, a consulta por marca, modelo e ano usa quatro.

| Recurso | Token gratuito | Premium |
| --- | --- | --- |
| Requisições | 1.000 por dia (24h) | Ilimitado |
| Histórico de preços | Últimos 3 meses | 1 ano |
| Consulta por placa (Alpha) | 10 consultas com sucesso por mês | 500 consultas com sucesso por mês |

Os planos estão em [fipe.api.br](https://fipe.api.br).

## Conectar sem login no navegador

Se o seu cliente não abre o login no navegador, conecte com o token da sua conta. É o mesmo token das requisições da API.

```bash
claude mcp add --transport http fipe https://mcp.fipe.api.br/mcp \
  --header "X-Subscription-Token: SEU_TOKEN"
```

Em outros clientes, adicione o header `X-Subscription-Token` na configuração do servidor.

:::caution

Não versione arquivos de configuração que contêm o seu token. Se o arquivo fica no repositório do projeto, use o login.

:::

## Problemas comuns

### O assistente não consulta a FIPE

Confira se o servidor está conectado. No Claude Code, o comando `/mcp` mostra o estado do servidor `fipe`. Na pergunta, cite a tabela FIPE ou o preço FIPE.

### O cliente pede o login de novo

A autorização expirou. Faça a autenticação outra vez. No Claude Code, execute `/mcp` e selecione `fipe`.

### Limite de requisições atingido

Você atingiu o limite do plano. O limite diário reinicia a cada 24 horas. A cota de consulta por placa reinicia a cada mês.

### Veículo ou placa não encontrados

Confira a placa. Para consultas por modelo, informe mais detalhes: versão, ano e combustível.

## Próximos passos

- [Casos de uso práticos](/docs/ideas-de-uso-pratico): aplicações da API em avaliação, comparação e financiamento de veículos.
- [Consultando a API](/docs/consultando-a-api): as mesmas consultas por requisição HTTP.
- [Referência da API](/docs/api): especificação completa de endpoints, parâmetros e schemas.
