Integração AI

Carvox para assistentes AI

Integra o catálogo Carvox directamente no Claude, Cursor e outros clientes compatíveis com MCP.

SEM AUTENTICAÇÃODADOS EM TEMPO REALMCP STREAMABLE HTTP

O que é MCP

Model Context Protocol

O Model Context Protocol (MCP) é um standard aberto que permite a assistentes AI consultar fontes de dados externas em tempo real — sem sair da conversa.

Com o Carvox MCP, um assistente AI pode pesquisar o catálogo, obter detalhes de uma viatura específica, analisar estatísticas de preço e ler artigos editoriais — tudo com dados actualizados da base de dados.

Ferramentas

4 ferramentas disponíveis

search_cars

Pesquisa viaturas com filtros: marca, modelo, preço, KM, combustível, carroçaria e distrito.

search_cars({ make: "toyota", fuel: "HYBRID", priceMax: 25000 })

get_car_detail

Obtém detalhes completos de uma viatura: equipamentos, fotos, descrição, IUC e IPO.

get_car_detail({ slug: "toyota-corolla-hybrid-2022-abc" })

get_price_stats

Estatísticas de preço (mediana, mínimo, máximo) para qualquer marca ou modelo no catálogo.

get_price_stats({ make: "bmw", model: "serie-3", yearMin: 2020 })

search_articles

Pesquisa guias de compra, reviews, comparativos e análise de mercado automóvel.

search_articles({ category: "GUIA", limit: 5 })

ATENÇÃO

Não coles o JSON de configuração numa conversa de chat. Colar o config numa janela de chat não activa nada — o Claude vai apenas lê-lo como texto. A configuração tem de ir para o ficheiro de config do cliente (ver instruções abaixo) ou ser adicionada via interface de settings.

Como integrar

Instruções por cliente

Claude CodeMAIS RÁPIDO

Um único comando na linha de comandos — sem editar ficheiros manualmente:

claude mcp add carvox --transport http https://www.carvox.pt/api/mcp

Depois reinicia a sessão Claude Code. As tools ficam disponíveis imediatamente.

Claude DesktopRECOMENDADO

Claude Desktop suporta MCP nativamente. Edita o ficheiro de configuração (não o chat!) e adiciona este bloco dentro de mcpServers:

{
  "mcpServers": {
    "carvox": {
      "type": "http",
      "url": "https://www.carvox.pt/api/mcp"
    }
  }
}

LOCALIZAÇÃO DO FICHEIRO

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude.ai (web)

O Claude.ai suporta servidores MCP remotos. Vai a Settings → Integrations → Add integration e introduz o URL:

https://www.carvox.pt/api/mcp

Cursor

No Cursor, vai a Settings → MCP → Add server, escolhe tipo http e introduz o URL:

https://www.carvox.pt/api/mcp

ChatGPTSEM SUPORTE MCP

O ChatGPT não suporta MCP nativamente. Podes usar o Carvox colando este texto num GPT personalizado ou numa conversa:

"Consulta o catálogo Carvox em https://www.carvox.pt/viaturas para encontrar carros usados em Portugal."

Perplexity

O Perplexity indexa o Carvox directamente via llms.txt e o catálogo público. Não é necessária configuração — pergunta directamente:

"Encontra carros usados em Portugal no Carvox"

Exemplos

O que podes perguntar

01"Encontra SUVs diesel até €20.000, menos de 100 mil km, no Porto"

02"Qual o preço mediano de um Toyota Corolla Hybrid de 2020 em Portugal?"

03"Lê o guia do Carvox sobre como comprar carro usado em Portugal"

04"Compara os preços de BMWs Série 3 disponíveis agora no catálogo"

Para programadores

Endpoint técnico

Servidor MCP Streamable HTTP, sem autenticação. Cada POST é uma troca JSON-RPC 2.0 completa. Dados em tempo real da base de dados do catálogo.

ENDPOINThttps://www.carvox.pt/api/mcp

DISCOVERYhttps://www.carvox.pt/.well-known/mcp.json

PROTOCOLOMCP 2024-11-05 · JSON-RPC 2.0 · HTTP POST