Conecte Seus Heatmaps ao Claude via MCP (1 Minuto, Um Comando)
- how-to
- mcp
- claude
- ai
- integration
Resumo
- O HeatMapX fala MCP (o padrão aberto para conectar ferramentas a assistentes de IA). Gratuito em todos os planos
- A configuração tem dois passos — emitir uma chave de API, executar um comando — cerca de um minuto
- Depois de conectado, o Claude pode consultar seus heatmaps, estatísticas de página e resultados de testes A/B na conversa
"Abrir o painel → copiar os números → colar na IA" — esse vai e vem cansa rápido. Com o MCP, o Claude busca os dados do HeatMapX por conta própria, e toda a análise acontece em uma única conversa.
O que é o MCP?
MCP (Model Context Protocol) é o padrão para conectar ferramentas externas a assistentes de IA como o Claude. Pense nele como uma tomada universal: conecte uma vez, e a IA busca os dados de que precisa, sempre que precisar.
Configuração (2 passos)
1. Emita uma chave de API
No seu painel do HeatMapX, acesse Settings → API keys e clique em "Issue new key". A chave é exibida apenas uma vez — copie-a imediatamente.
2. Execute um comando
No seu terminal (substitua YOUR_API_KEY pela chave que você copiou):
claude mcp add --transport http heatmapx https://heatmapx.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"
Pronto. Reinicie o Claude Code (ou inicie uma nova conversa) e as ferramentas do HeatMapX estarão disponíveis.
O que você pode fazer
Depois de conectado, perguntas como estas simplesmente funcionam:
- "Mostre meus sites" → seus sites cadastrados e URLs
- "Qual página do kpop-ticket.com tem a pior profundidade de rolagem?" → encontrado a partir das estatísticas por página
- "Resuma o heatmap de /pricing" → pontos de maior concentração de cliques e alcance da rolagem
- "Como está meu teste A/B? Já dá para declarar um vencedor?" → métricas das variantes mais uma sugestão de vencedor com embasamento estatístico
O HeatMapX fornece os números; o Claude faz a interpretação. Cada um fazendo o que faz de melhor.
Ferramentas disponíveis (somente leitura)
| Ferramenta | O que retorna |
|---|---|
| list_sites | Seus sites cadastrados |
| get_page_stats | Sessões, cliques e profundidade média de rolagem por página |
| get_heatmap_summary | Agregados do heatmap de uma página (com janela de tempo) |
| list_experiments | Seus experimentos A/B |
| get_experiment_results | Métricas das variantes, uplift e sugestão de vencedor |
Não há ferramentas de escrita — tudo é somente leitura, então a IA nunca pode alterar seus dados acidentalmente.
Se não conectar — checklist
- Colou a chave errada? Confira se colou a string inteira começando com
hmx_live_ - Suporte do cliente: você precisa de um cliente MCP que suporte cabeçalhos personalizados (Claude Code, Cursor, etc.). Conectores personalizados do Claude Desktop (OAuth) estão no nosso roteiro
- Chave revogada? Verifique em Settings → API keys se há uma chave ativa
Preços
O acesso via MCP é gratuito em todos os planos (com apenas um limite razoável de burst). Heatmaps e testes A/B, direto do Claude — experimente.