Carpedia

브라질 차량 카탈로그: 사양, 장비, 정비, 등록, FIPE 가격 및 소유 비용 추정. OAuth를 사용한 원격 MCP를 통한 16개의 읽기 전용 도구.

문서

Conecte em um comando.

Adicione o servidor ao seu agente e autentique por OAuth, ou use a chave da API: o acesso é o mesmo.

$ claude mcp add --transport http carpedia https://mcp.carpedia.com.br/mcp

Numa sessão, rode /mcp e escolha autenticar.

Prefere chave fixa? Serve em CI, onde não há navegador para o OAuth:

Terminal, com a chave da API

$ claude mcp add --transport http carpedia https://mcp.carpedia.com.br/mcp \
  --header "Authorization: Bearer cpk_SUA_CHAVE"

Prefere https://www.carpedia.com.br/api/mcp direto, como nos exemplos da documentação? É o mesmo servidor, com a mesma autenticação e o mesmo saldo.

OAuth

Claude

Abra Configurações, depois Conectores, e adicione um conector personalizado. Cole a URL, clique em Vincular, entre com o e-mail da sua conta e autorize. A tela mostra o que o app poderá ler. Sem chave e sem header.

OAuth

Claude Code

Adicione o servidor com claude mcp add. Numa sessão, rode /mcp e escolha autenticar. O cliente cuida do login e você não guarda segredo.

Chave da API

Qualquer cliente, com a chave

Funciona em qualquer cliente que aceite header: Codex CLI, OpenAI, Cursor, VS Code e Hermes Agent.

Authorization: Bearer cpk_SUA_CHAVE

Ainda não tem chave? Gere a chave grátis, sem cartão.

16 ferramentas, todas de leitura.

O que a autorização não concede

  • Alterar, publicar ou apagar conteúdo do catálogo (no site, o acesso é só de leitura)
  • Gerar cobrança ou comprar crédito. Isso só existe no painel e na API v1, nunca pelo agente
  • Ver seus dados pessoais
  • Ver ou criar suas chaves de API, ou entrar no painel administrativo

O agente decide quando chamar cada uma. A carpedia_buscar_versoes aceita termo livre, como “corolla xei”, e leva direto ao fipeId.

  • carpedia_buscar_marcas Listar as marcas do catálogo
  • carpedia_buscar_modelos Listar os modelos de uma marca
  • carpedia_buscar_versoes Buscar versões de veículo por nome ou filtro
  • carpedia_preco_fipe Consultar o preço FIPE vigente de uma versão
  • carpedia_historico_preco Ver o histórico de preço FIPE, com variação e projeção de depreciação
  • carpedia_ficha_tecnica Ler a ficha técnica (motor, dimensões, consumo), o selo PBEV-Inmetro e o porte Carpedia
  • carpedia_imagem_veiculo Ver a imagem do veículo (foto, logo da marca ou monograma)
  • carpedia_acessorios Consultar itens de série e opcionais por versão
  • carpedia_plano_manutencao Ler o plano de manutenção (revisões programadas por km) de uma versão
  • carpedia_resumo Ler o resumo editorial de um modelo ou versão
  • carpedia_marca Ler o verbete da marca (origem, fundação, chegada ao Brasil)
  • carpedia_custo_uso Estimar o custo anual de uso (depreciação, IPVA da sua UF, combustível ou energia)
  • carpedia_vendas Consultar emplacamentos 0km do mês: ranking, por marca ou por modelo

Da sua conta

  • carpedia_consumo Ver o saldo e o uso da sua conta de API. Não cobra.
  • carpedia_relatorio_consumo Ver o relatório de uso da sua conta de API por período. Não cobra.
  • carpedia_status_credito Consultar o status de uma cobrança Pix de crédito da sua conta. Não cobra.

Mesmo saldo da API.

Sem plano. Você recarrega o saldo por Pix ou cartão e ele não expira.

Quando a oferta estiver habilitada, contas novas elegíveis podem receber até R$ 100,00 de saldo para os dados próprios, sem cartão (R$ 100,00 para CNPJ e R$ 50,00 para CPF). Ativar a API, por si só, não garante o benefício: veja as condições completas de boas-vindas.

Uma chave, um saldo

API REST a mesma chave

MCP a mesma chave, ou OAuth

Um saldo Pix ou cartão, não expira

13 ferramentas de dadocatálogo, preço FIPE, ficha, custo de uso, vendas e imagem

saem do saldo

3 ferramentas da conta carpedia_consumo, carpedia_relatorio_consumo e carpedia_status_credito

não cobram

Conecte o seu agente ao catálogo.

Entre por OAuth ou gere uma chave da API.