Radar do Vinil
Entrar

Radar do Vinil · Integração MCP

Agentes de IA (MCP)

O Radar do Vinil expõe um servidor MCP (Model Context Protocol) público para agentes de IA e ferramentas de desenvolvedores. Conecte o Claude, o ChatGPT, o Cursor ou qualquer cliente MCP para buscar ofertas de vinis e CDs, consultar históricos de preços, receber vereditos de preço e acessar estatísticas do catálogo monitorado — sem custo.

Endpoints

Endpoint público

sem login

Aberto a qualquer cliente MCP, sem conta e sem chave de API. Cobre as consultas de leitura ao catálogo: ofertas, históricos de preço, taxonomias e estatísticas.

https://radardovinil.app/mcp

Endpoint autenticado

requer login

Requer login com a sua conta Google pelo fluxo OAuth do seu cliente MCP. É por aqui que o agente, com o seu consentimento, recebe apenas a permissão alerts:write para criar alertas de preço na sua conta.

https://radardovinil.app/mcp/auth

Ferramentas

9 ferramentas registradas pelo servidor, disponíveis via tools/list. Todas funcionam no endpoint público, exceto a que cria alertas.

  • healthcheckInformações de build do servidor: versão da aplicação e total de ferramentas registradas.
  • search_offersBusca ofertas de vinis e CDs com paginação, filtros e ordenação; preços em BRL.
  • get_itemDetalhe completo de um produto por ASIN: histórico de preços, estatísticas, faixa de qualidade e metadados musicais.
  • get_price_historyPontos do histórico de preços (BRL) de um ASIN na granularidade diária, semanal ou mensal.
  • best_offersMelhores ofertas do catálogo monitorado, com desconto calculado na janela semanal ou em todo o histórico.
  • get_statsEstatísticas ao vivo do catálogo e dos colecionadores.
  • evaluate_priceVeredito de preço: pontuação de 0 a 100 calculada a partir dos percentis de 30 e 90 dias e do histórico de preços completo.
  • create_price_alertrequer loginRegistra um alerta de preço-alvo; requer login em /mcp/auth com a permissão alerts:write.
  • get_purchase_linkURL de compra com tag de afiliado e com link canônico como alternativa.

Recursos

URIs expostos via resources/list, com os parâmetros entre chaves preenchidos pelo cliente:

  • mcp://price/{asin}/history
  • mcp://price/{asin}/detail
  • mcp://taxonomy/genres
  • mcp://taxonomy/artists
  • mcp://taxonomy/countries
  • mcp://taxonomy/decades
  • mcp://stats

Como conectar

Nos clientes que suportam OAuth, apontar para o endpoint autenticado https://radardovinil.app/mcp/auth em vez do público faz o próprio cliente executar o login na primeira utilização, concedendo apenas a permissão alerts:write.

Claude (claude.ai)

https://radardovinil.app/mcp
  • Nos planos Pro e Max: Customize > Connectors > “Add custom connector”, e cole a URL do servidor MCP remoto (copie acima).
  • Conectores remotos são intermediados pela nuvem da Anthropic, então o servidor precisa estar publicamente acessível — o endpoint público do Radar do Vinil é.
  • O arquivo claude_desktop_config.json do app Claude Desktop é um mecanismo separado, para servidores locais; não é assim que se conecta este servidor remoto.
  • A disponibilidade e a interface variam por plano e mudam com frequência; confira a documentação oficial.
Documentação oficial — Claude (claude.ai)

ChatGPT

https://radardovinil.app/mcp
  • O suporte completo a MCP está em beta para os planos Business, Enterprise e Edu.
  • Para saber onde criar um conector MCP personalizado, siga a documentação oficial vinculada neste cartão.
  • A disponibilidade e a interface variam por plano e mudam com frequência; confira a documentação oficial.
Documentação oficial — ChatGPT

Cursor

https://radardovinil.app/mcp
  • O Cursor aceita servidores MCP remotos por HTTP (transporte streamable), além de stdio e SSE.
  • Adicione o servidor remoto em Cursor Settings > MCP (ou no arquivo mcp.json) informando a URL acima; o OAuth, quando o servidor o exige, é gerenciado pelo Cursor.
  • Não fixamos aqui o formato exato das chaves do mcp.json: a interface e o formato mudam com frequência — siga a documentação oficial.
  • A disponibilidade e a interface variam por plano e mudam com frequência; confira a documentação oficial.
Documentação oficial — Cursor

Cliente MCP genérico

{
  "mcpServers": {
    "radar-do-vinil": {
      "url": "https://radardovinil.app/mcp"
    }
  }
}
  • Muitos clientes MCP com transporte HTTP aceitam uma configuração neste formato; o nome exato das chaves varia por cliente — consulte a documentação do seu cliente. “radar-do-vinil” é apenas o identificador local do servidor.

Permissões e consentimento

Todas as ferramentas de leitura funcionam no endpoint público /mcp sem conta e sem login. Apenas create_price_alert exige o endpoint autenticado https://radardovinil.app/mcp/auth, que requer a sua autorização.

  • Login: feito com a sua própria conta Google, dentro do fluxo OAuth do próprio cliente MCP que você usa. A autenticação acontece no Google; o Radar do Vinil não recebe a sua senha.
  • Consentimento sempre explícito: depois do login, a tela de consentimento é sempre exibida — nunca é pulada — mostrando o nome do cliente e a única permissão solicitada, alerts:write. Recusar é tão simples quanto aceitar.
  • Alcance: alerts:write permite ao agente criar alertas de preço apenas na sua conta. Não dá acesso à leitura de dados pessoais, não permite compras e não cobre nenhuma outra alteração.

Limites de uso

O endpoint público /mcp aceita até 60 requisições por minuto por IP — esse é o padrão do serviço e pode ser ajustado. O endpoint autenticado /mcp/auth usa cotas por cliente, definidas individualmente pelo servidor.