CarsXE

Uma API poderosa e fácil de usar para dados de veículos, incluindo especificações, valor de mercado, decodificação de placas e muito mais.

GitHubExperimente este MCPPatrocinado

Documentação

🚗 Servidor MCP CarsXE

Um servidor de Protocolo de Contexto de Modelo (MCP) modular e extensível para consultar e analisar dados de veículos da API CarsXE, com saída Markdown bonita e amigável para chat, projetada para LLMs e chatbots.

ℹ️ O que é o Servidor MCP CarsXE?

O servidor MCP CarsXE é um aplicativo Node.js/TypeScript que expõe um conjunto de ferramentas para consultar dados abrangentes de veículos da API CarsXE. Ele é projetado para integração perfeita com LLMs (como Anthropic Claude, OpenAI GPT, etc.), chatbots e ferramentas de desenvolvimento, fornecendo:

  • 🧩 Código limpo e modular para cada endpoint da CarsXE
  • 📝 Saída consistente e rica em Markdown para ambientes de chat/LLM
  • 🛡️ Tratamento robusto de erros e mensagens amigáveis ao usuário
  • 🔌 Extensibilidade fácil para novos endpoints e recursos

💡 Por que usar CarsXE com MCP?

Conectar a CarsXE ao seu editor de IA ou cliente de chat via MCP oferece uma experiência supercarregada de dados de veículos — diretamente dentro das ferramentas que você já usa:

BenefícioDescrição
Pergunte em linguagem simplesSem necessidade de conhecer endpoints ou parâmetros da API — basta descrever o que você quer
Respostas com contextoA IA combina dados de veículos em tempo real com sua pergunta para respostas personalizadas e acionáveis
Sem alternar de abaObtenha especificações de VIN, histórico, recalls e valores sem sair do seu editor ou chat
Encadeie solicitações sem esforçoDecodifique uma placa → obtenha especificações completas → verifique recalls → obtenha valor de mercado, tudo em uma conversa
Dados sempre em tempo realCada consulta acessa a API CarsXE em tempo real — sem cache obsoleto ou resultados desatualizados
Funciona no seu editor favoritoClaude Desktop, Cursor, VS Code, Windsurf e qualquer cliente compatível com MCP

✨ Recursos

  • 🤖 Usa Anthropic Claude para gerar respostas abrangentes e profissionais com base nos dados da API e na consulta do usuário
  • 🚙 Consulte especificações de veículos, histórico, imagens, recalls, valor de mercado e muito mais
  • 🏷️ Decodifique placas de licença e VINs (incluindo OCR a partir de imagens)
  • 🛠️ Decodifique códigos OBD (Diagnóstico de Bordo)
  • 🎨 Todos os endpoints retornam Markdown elegante, agrupado e rico em emojis
  • 🧑‍💻 Código modular: tipos, lógica de API e formatadores são separados para manutenibilidade
  • 🧪 Simples de executar, testar e estender

⚙️ Pré-requisitos

Chave da API CarsXE (obtenha uma aqui)

🖥️ Instalação por Editor

Todos os editores usam o mesmo endpoint MCP remoto. Substitua YOUR_API_KEY pela sua chave real da API CarsXE em cada configuração abaixo.

Claude Desktop

1️⃣ Baixe e instale o Claude Desktop

  • Acesse a página oficial de download do Claude Desktop
  • Baixe o instalador para o seu sistema operacional (macOS, Windows ou Linux)
  • Instale o Claude Desktop seguindo as instruções na tela

2️⃣ Configure o Claude Desktop para usar o Servidor MCP CarsXE

a. Abra as Configurações do Claude Desktop

  • Inicie o aplicativo Claude Desktop
  • Clique em Claude na barra de menus
  • Selecione Configurações
  • Na janela de Configurações, vá para a aba Desenvolvedor (talvez seja necessário rolar ou expandir opções avançadas)
  • Clique em Editar Configuração (ou Abrir Arquivo de Configuração)

b. Edite o Arquivo de Configuração

  • Isso abrirá o arquivo claude_desktop_config.json no seu editor de texto padrão.

  • Localize a seção "mcpServers". Se não existir, adicione-a conforme mostrado abaixo.

  • Adicione ou atualize a seguinte entrada para CarsXE:

    "mcpServers": {
  "carsxe": {
    "command": "npx",
    "args": [
      "mcp-remote@latest",
      "https://mcp.carsxe.com/mcp",
      "--header",
      "X-API-Key: YOUR_API_KEY"
    ]
  }
},

  • Substitua YOUR_API_KEY pela sua chave real da API CarsXE

  • Dica: Você pode adicionar vários servidores MCP em "mcpServers" se usar mais de um.

  • Salve o arquivo de configuração e feche o editor.

c. Reinicie o Claude Desktop

  • Feche e reabra o aplicativo Claude Desktop para aplicar a nova configuração.

    Pode levar um pequeno atraso para que as alterações tenham efeito.

3️⃣ Verifique se o Servidor MCP CarsXE está Disponível

  • Após reiniciar, abra o Claude Desktop.
  • Vá para a seção de ferramentas ou plugins (geralmente na barra de pesquisa ou em um menu de ferramentas).
  • Você deve ver CarsXE listado como um servidor/ferramenta MCP disponível.
  • Tente executar uma ferramenta CarsXE (por exemplo, get_vehicle_specs) para verificar se tudo está funcionando.

    Isso só funcionará se sua chave de API estiver associada a uma assinatura ativa.

Cursor

Instalar CarsXE MCP para Cursor

A caixa de diálogo de instalação abrirá pré-preenchida com:

CampoValor
NomeCarsXE
TipostreamableHttp
URLhttps://mcp.carsxe.com/mcp
CabeçalhoX-API-Key: YOUR_API_KEY

Substitua YOUR_API_KEY pela sua chave real da API CarsXE e clique em Instalar.

Visual Studio Code (GitHub Copilot)

Instalar CarsXE MCP para VS Code

Após clicar em instalar, você precisará adicionar sua chave de API manualmente:

  1. Abra a Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P)
  2. Execute MCP: Listar Servidores
  3. Encontre CarsXE na lista e clique nele
  4. Clique em Mostrar Configuração
  5. Substitua YOUR_API_KEY pela sua chave real da API CarsXE:
   "CarsXE": {
     "type": "http",
     "url": "https://mcp.carsxe.com/mcp",
     "headers": {
       "X-API-Key": "YOUR_ACTUAL_KEY_HERE"
     }
   }
  1. Salve o arquivo — o VS Code se conectará automaticamente.

Nota: Certifique-se de ter a extensão GitHub Copilot instalada e o modo agente habilitado (chat.agent.enabled nas configurações do VS Code).

Windsurf

1️⃣ Abra a Configuração MCP

  • Vá para Configurações do Windsurf → MCP (ou pressione Ctrl+, e pesquise por MCP)
  • Clique em "Editar Configuração" para abrir ~/.codeium/windsurf/mcp_config.json

2️⃣ Adicione o Servidor CarsXE

{
  "mcpServers": {
    "carsxe": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.carsxe.com/mcp",
        "--header",
        "X-API-Key: YOUR_API_KEY"
      ]
    }
  }
}

3️⃣ Reinicie o Windsurf

Recarregue a janela ou reinicie o Windsurf. Abra o painel de chat Cascade — as ferramentas CarsXE aparecerão automaticamente.

Outros Editores (Manual / Genérico)

Para qualquer outro cliente compatível com MCP, registre um servidor MCP remoto usando:

  • Endpoint: https://mcp.carsxe.com/mcp
  • Transporte: HTTP (Streamable HTTP)
  • Cabeçalho de autenticação: X-API-Key: YOUR_API_KEY

Consulte a documentação MCP do seu editor para o formato exato de configuração.

🛠️ Ferramentas Disponíveis e Exemplos de Prompts

Abaixo está uma lista de todas as ferramentas CarsXE disponíveis, seus parâmetros e exemplos de prompts. Esses prompts funcionam em qualquer cliente conectado via MCP.

1. get_vehicle_specs 🚙

  • Descrição: Obtenha especificações abrangentes do veículo por VIN

  • Parâmetros:

    • vin (string, obrigatório): Número de Identificação do Veículo com 17 caracteres

  • Exemplos de Prompts:

    Quais são as especificações completas para o VIN WBAFR7C57CC811956?

    Isso é um V6 ou V8? VIN: WBAFR7C57CC811956

    Qual é o nível de acabamento de WBAFR7C57CC811956?

  • Saída: Especificações do veículo formatadas em Markdown (ano, marca, modelo, motor, dimensões, cores, equipamentos, etc.)

2. decode_license_plate 🏷️

  • Descrição: Decodifique a placa de licença de um veículo para obter VIN e informações básicas

  • Parâmetros:

    • plate (string, obrigatório): Número da placa de licença
    • state (string, opcional): Abreviação do estado (ex.: CA)
    • country (string, obrigatório, padrão: US): Código do país

  • Exemplos de Prompts:

    Qual carro tem a placa 7XER187 na Califórnia?

    Decodifique a placa 7XER187 estado CA

    Consulte a placa ABC1234 no Texas

  • Saída: Resumo em Markdown das informações do veículo decodificado (VIN, marca, modelo, ano, etc.)

3. decode_international_vin 🌍

  • Descrição: Decodifique um VIN internacional para informações detalhadas

  • Parâmetros:

    • vin (string, obrigatório): VIN com 17 caracteres

  • Exemplos de Prompts:

    Decodifique este VIN europeu: WF0MXXGBWM8R43240

    Que carro é WAUZZZ8K9AA123456? É um VIN alemão.

  • Saída: Markdown com detalhes do veículo internacional (fabricante, especificações, emissões, etc.)

4. get_market_value 💰

  • Descrição: Obtenha o valor estimado de mercado para um veículo por VIN

  • Parâmetros:

    • vin (string, obrigatório): VIN com 17 caracteres
    • state (string, opcional): Abreviação do estado dos EUA
    • mileage (número, opcional): Quilometragem atual do veículo para ajustar o valor de mercado
    • condition (string, opcional): Condição geral do veículo — excellent, clean, average ou rough

  • Exemplos de Prompts:

    Quanto vale WBAFR7C57CC811956?

    Estou pensando em comprar o VIN WBAFR7C57CC811956 — qual é um preço justo?

    Qual é o valor de troca para WBAFR7C57CC811956 na Flórida com 45.000 milhas em condição limpa?

  • Saída: Markdown com detalhamento do valor de mercado (varejo, troca, preço sugerido, etc.)

5. get_vehicle_history 🕓

  • Descrição: Obtenha um relatório abrangente do histórico do veículo por VIN

  • Parâmetros:

    • vin (string, obrigatório): VIN com 17 caracteres
    • format (string, opcional): Formato da resposta (json ou xml)

  • Exemplos de Prompts:

    O WBAFR7C57CC811956 já sofreu algum acidente?

    Mostre-me o histórico completo do VIN WBAFR7C57CC811956

    Quantos proprietários o WBAFR7C57CC811956 teve?

  • Saída: Markdown com registros do histórico (sucata/indenização, seguro, marcas, títulos, odômetro, etc.)

6. get_vehicle_images 🖼️

  • Descrição: Obtenha imagens do veículo por marca, modelo e filtros

  • Parâmetros:

    • make (string, obrigatório)
    • model (string, obrigatório)
    • year, trim, color, transparent, angle, photoType, size, license, format (todos opcionais)

  • Exemplos de Prompts:

    Mostre-me fotos de uma Toyota Tacoma azul 2018

    Obtenha imagens de um Ford Mustang GT vermelho 2022

    Como é um Tesla Model 3 branco 2020?

  • Saída: Markdown com até 5 imagens (links, miniaturas, detalhes)

7. get_vehicle_recalls 🚨

  • Descrição: Obtenha informações de recall do veículo por VIN

  • Parâmetros:

    • vin (string, obrigatório): VIN com 17 caracteres

  • Exemplos de Prompts:

    O 1C4JJXR64PW696340 tem algum recall em aberto?

    Acabei de comprar o VIN 1C4JJXR64PW696340 — devo me preocupar com recalls?

    Verifique recalls de segurança para WBAFR7C57CC811956

  • Saída: Markdown com detalhes do recall (data, descrição, risco, correção, status, etc.)

8. read_license_plate_from_image 🏷️

  • Descrição: Reconheça e extraia placa(s) de licença de uma URL de imagem de veículo

  • Parâmetros:

    • imageUrl (string, obrigatório): URL direta para uma imagem da placa de licença de um veículo

  • Exemplos de Prompts:

    Qual é o número da placa nesta imagem? https://api.carsxe.com/img/apis/plate_recognition.JPG

    Leia a placa de licença desta foto: [image URL]

  • Saída: Markdown com placas detectadas, pontuações de confiança, caixas delimitadoras, tipo de veículo, etc.

9. extract_vin_from_image 🔍

  • Descrição: Extraia o VIN de uma imagem de veículo usando OCR

  • Parâmetros:

    • imageUrl (string, obrigatório): URL direta para uma imagem do VIN de um veículo

  • Exemplos de Prompts:

    Extraia o VIN desta imagem: https://user-images.githubusercontent.com/5663423/30922082-64edb4fa-a3a8-11e7-873e-3fbcdce8ea3a.png

    Qual é o VIN nesta foto? https://res.cloudinary.com/carsxe/image/upload/q_auto/f_auto/v1713204144/base/images/vin-ocr/vin.jpg

  • Saída: Markdown com VIN detectado, confiança, caixa delimitadora e candidatos

10. get_year_make_model 📅

  • Descrição: Obtenha informações abrangentes do veículo por ano, marca, modelo e acabamento opcional

  • Parâmetros:

    • year (string, obrigatório)
    • make (string, obrigatório)
    • model (string, obrigatório)
    • trim (string, opcional)

  • Exemplos de Prompts:

    Quais são as especificações de um Toyota Camry 2020?

    Fale-me sobre o acabamento Honda Civic Sport 2019

    Quais cores estavam disponíveis no Ford F-150 2021?

  • Saída: Markdown com detalhes do veículo, cores, recursos, opções e pacotes

11. decode_obd_code 🛠️

  • Descrição: Decodifique um código OBD e obtenha informações de diagnóstico

  • Parâmetros:

    • code (string, obrigatório): Código OBD (ex.: P0115)

  • Exemplos de Prompts:

    A luz de verificação do motor está acesa com o código P0115 — o que isso significa?

    Decodifique o código OBD P0300

    Tenho um código C1234 no painel — é grave?

  • Saída: Markdown com código, diagnóstico e data

12. check_lien_and_theft 🔒

  • Descrição: Obtenha informações de gravame e roubo para um veículo pelo VIN

  • Parâmetros:

    • vin (string, obrigatório): Número de Identificação do Veículo com 17 caracteres

  • Exemplos de Prompts:

    Existe um gravame sobre WBAFR7C57CC811956?

    Estou comprando um carro usado com VIN WBAFR7C57CC811956 — verifique se foi roubado

    Verifique se o título está limpo para WBAFR7C57CC811956

  • Saída: Markdown com informações do credor, registros de roubo, datas de recuperação e status

🔗 Encadeando Ferramentas — Exemplos para Usuários Avançados

O verdadeiro poder do MCP CarsXE vem de encadear ferramentas em uma única conversa:

Cenário 1 — Due diligence pré-compra:

  1. Decodifique a placa 7XER187 na Califórnia

  2. Agora obtenha o histórico completo dela

  3. Ela tem algum recall em aberto?

  4. Quanto vale se eu comprar hoje?

Cenário 2 — Viu um carro na rua:

  1. Leia a placa desta imagem: [photo URL]

  2. Consulte essa placa no Texas

  3. Mostre-me fotos desse modelo de carro

Cenário 3 — Mecânico / oficina:

  1. Decodifique este VIN da foto do painel: [image URL]

  2. Obtenha as especificações completas

  3. Meu cliente diz que o código de verificação do motor é P0300 — o que isso significa para este veículo?

🔐 OAuth 2.1 (conector personalizado do Claude.ai)

O servidor hospedado em https://mcp.carsxe.com/mcp suporta dois métodos de autenticação:

  1. Chave de API (inalterada) — cabeçalho X-API-Key, Authorization: Bearer <api-key> ou parâmetro de consulta ?key=. Usada pelo Claude Desktop / mcp-remote e clientes locais.
  2. OAuth 2.1 — usado por clientes MCP hospedados, como o conector personalizado do Claude.ai. Clicar em Conectar no Claude.ai executa um fluxo padrão de Authorization Code + PKCE: registro dinâmico de cliente (RFC 7591), login no navegador na página de consentimento da CarsXE e, em seguida, troca de token. Tokens de acesso (mcp_at_*, 1 h) são mapeados para a chave de API do usuário na CarsXE; tokens de atualização (mcp_rt_*, 90 d) são rotacionados a cada atualização.

Requisições sem credenciais recebem 401 com um desafio WWW-Authenticate, que é o que leva o Claude.ai a iniciar o fluxo.

Variáveis de ambiente

VariávelPadrãoFinalidade
OAUTH_ISSUERhttps://mcp.carsxe.comEmissor / base do endpoint nos metadados de descoberta
OAUTH_WEB_BASEhttps://api.carsxe.comAplicativo web da CarsXE que hospeda a lógica OAuth
MCP_OAUTH_INTERNAL_SECRET(não definido)Definido no ambiente do host, nunca commitar. Quando não definido, tokens de portador OAuth são rejeitados, mas a autenticação por chave de API continua funcionando.

A implantação do Cloudflare Workers (src/index.ts) não atende à superfície OAuth — apenas a implantação do GCP Cloud Run (src/index.gcp.ts) por trás de mcp.carsxe.com atende.