Collega le tue heatmap a Claude via MCP (1 minuto, un comando)

HeatMapX Engineering Team5 min read
  • 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:

  1. Apri Impostazioni → Connettori → "Aggiungi connettore personalizzato"
  2. Inserisci "HeatMapX" come nome e https://heatmapx.com/api/mcp come URL → aggiungi → "Connetti"
  3. 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.

Heatmap da Claude Code — inizia gratis.

Incolla un tag di tracking, ricevi analisi e suggerimenti CRO dalla CLI.

Collega le tue heatmap a Claude via MCP (1 minuto, un comando)