Collega le tue heatmap a Claude via MCP (1 minuto, un comando)
- how-to
- mcp
- claude
- ai
- integration
In breve
- HeatMapX supporta MCP (lo standard aperto per collegare strumenti agli assistenti AI). Gratuito su ogni piano
- La configurazione richiede due passaggi — genera una chiave API, esegui un comando — circa un minuto
- Una volta connesso, Claude può consultare le tue heatmap, le statistiche delle pagine e i risultati dei test A/B nella conversazione
"Apri la dashboard → copia i numeri → incollali nell'AI" — questo andirivieni stanca presto. Con MCP, Claude recupera da solo i dati di HeatMapX, e l'intera analisi avviene in un'unica conversazione.
Cos'è MCP?
MCP (Model Context Protocol) è lo standard per collegare strumenti esterni agli assistenti AI come Claude. Pensalo come una presa di corrente universale: la colleghi una volta, e l'AI recupera i dati di cui ha bisogno, ogni volta che ne ha bisogno.
Collegati da claude.ai / Claude Desktop (il più semplice — 3 clic)
Su claude.ai o Claude Desktop non ti serve un terminale né una chiave API:
- Apri Impostazioni → Connettori → "Aggiungi connettore personalizzato"
- Inserisci "HeatMapX" come nome e
https://heatmapx.com/api/mcpcome URL → aggiungi → "Connetti" - Accedi a HeatMapX e rivedi la schermata di consenso (accesso in lettura / crea e avvia / interrompi esperimenti / registra siti), poi clicca su "Consenti"
Tutto qui — fai pure le tue domande in chat. Puoi disconnetterti in qualsiasi momento da HeatMapX Impostazioni → App connesse.
Collegati da Claude Code (terminale, 2 passaggi)
1. Genera una chiave API
Nella tua dashboard HeatMapX, vai su Impostazioni → Chiavi API e clicca su "Genera nuova chiave". La chiave viene mostrata una sola volta — copiala subito.
2. Esegui un comando
Nel terminale (sostituisci YOUR_API_KEY con la chiave copiata):
claude mcp add --transport http heatmapx https://heatmapx.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"
Fatto. Riavvia Claude Code (o apri una nuova conversazione) e gli strumenti di HeatMapX saranno disponibili.
Cosa puoi fare
Una volta connesso, domande come queste funzionano subito:
- "Mostrami i miei siti" → i tuoi siti registrati e i relativi URL
- "Qual è la pagina di kpop-ticket.com con lo scroll depth peggiore?" → individuata dalle statistiche per pagina
- "Riassumi la heatmap di /pricing" → punti caldi dei click e profondità di scroll raggiunta
- "Come sta andando il mio test A/B? Posso già dichiarare un vincitore?" → metriche delle varianti più un suggerimento del vincitore basato su fondamenti statistici
HeatMapX fornisce i numeri; Claude si occupa dell'interpretazione. Ognuno fa ciò in cui è più bravo.
Non solo lettura: crea e avvia test A/B
Connettiti con accesso in scrittura e l'intero ciclo avviene nella conversazione:
- "Crea un test A/B sulla mia homepage: due varianti di copy per la CTA" → viene creata una bozza
- "Avvialo" → Claude riassume l'esperimento e chiede sempre la tua conferma → rispondi OK e va live
- "Fermalo" → stessa conferma, poi si ferma
Sicurezza per design:
- La creazione produce sempre una bozza (nulla serve traffico da solo)
- Avvio / arresto non vengono mai eseguiti senza la tua approvazione esplicita (conferma in due passaggi)
- L'eliminazione non è possibile tramite AI (le operazioni irreversibili sono escluse)
- I permessi sono indicati chiaramente nella schermata di consenso e revocabili in qualsiasi momento da Impostazioni → App connesse
Strumenti disponibili
| Tool | Cosa restituisce |
|---|---|
| list_sites | I tuoi siti registrati |
| get_page_stats | Sessioni, click e scroll depth medio per pagina |
| get_heatmap_summary | Aggregati della heatmap per una pagina (con intervallo temporale) |
| list_experiments | I tuoi esperimenti A/B |
| get_experiment_results | Metriche delle varianti, uplift, suggerimento del vincitore |
Cinque strumenti di lettura più cinque strumenti di scrittura (create_site / create_experiment / start·pause·stop_experiment). Gli strumenti di scrittura funzionano solo sulle connessioni per cui hai approvato esplicitamente l'accesso in scrittura, e avvio/arresto richiedono sempre una conferma nella conversazione.
Se non si connette — checklist
- Chiave incollata male? Assicurati di aver incollato l'intera stringa che inizia con
hmx_live_ - Chiave revocata? Controlla in Impostazioni → Chiavi API che ci sia una chiave attiva
Prezzi
L'accesso MCP è gratuito su ogni piano (con solo un limite ragionevole per le richieste in rapida successione). Heatmap e test A/B, direttamente da Claude — provalo.