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.
Conecte-se pelo claude.ai / Claude Desktop (mais fácil — 3 cliques)
No claude.ai ou no Claude Desktop você não precisa de terminal nem de chave de API:
- Abra Settings → Connectors → "Add custom connector"
- Digite "HeatMapX" como nome e
https://heatmapx.com/api/mcpcomo URL → adicionar → "Connect" - Faça login no HeatMapX e revise a tela de consentimento (acesso de leitura / criar e iniciar / parar experimentos / registrar sites), depois clique em "Allow"
Pronto — pergunte à vontade no chat. Você pode desconectar a qualquer momento em HeatMapX Settings → Connected apps.
Conecte-se pelo Claude Code (terminal, 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.
Não é só leitura: crie e inicie testes A/B
Conecte-se com acesso de escrita e todo o ciclo acontece na conversa:
- "Crie um teste A/B na minha homepage: duas variações de copy para o CTA" → um rascunho é criado
- "Inicie" → o Claude resume o experimento e sempre pede sua confirmação → diga OK e ele entra no ar
- "Pare" → mesma confirmação, depois ele para
Segurança por design:
- A criação sempre resulta em um rascunho (nada serve tráfego sozinho)
- Iniciar / parar nunca são executados sem sua aprovação explícita (confirmação em duas etapas)
- Excluir não é possível via IA (operações irreversíveis estão fora de cogitação)
- As permissões são detalhadas na tela de consentimento e podem ser revogadas a qualquer momento em Settings → Connected apps
Ferramentas disponíveis
| 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 |
Cinco ferramentas de leitura mais cinco ferramentas de escrita (create_site / create_experiment / start·pause·stop_experiment). As ferramentas de escrita funcionam apenas nas conexões em que você aprovou explicitamente o acesso de escrita, e iniciar/parar sempre exigem confirmação durante a conversa.
Se não conectar — checklist
- Colou a chave errada? Confira se colou a string inteira começando com
hmx_live_ - 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.