Connecter vos heatmaps à Claude via MCP (1 minute, une commande)

HeatMapX Engineering Team5 min read
  • how-to
  • mcp
  • claude
  • ai
  • integration

En bref

  • HeatMapX prend en charge le MCP (le standard ouvert pour connecter des outils aux assistants IA). Gratuit sur tous les plans
  • La configuration se fait en deux étapes — générer une clé API, exécuter une commande — environ une minute
  • Une fois connecté, Claude peut interroger vos heatmaps, statistiques de page et résultats de tests A/B dans la conversation

« Ouvrir le tableau de bord → copier les chiffres → les coller dans l'IA » — cet aller-retour devient vite lassant. Avec MCP, Claude récupère lui-même vos données HeatMapX, et toute l'analyse se déroule dans une seule conversation.

Qu'est-ce que le MCP ?

Le MCP (Model Context Protocol) est le standard permettant de connecter des outils externes à des assistants IA comme Claude. Imaginez une prise électrique universelle : on la branche une fois, et l'IA récupère les données dont elle a besoin, quand elle en a besoin.

Connexion depuis claude.ai / Claude Desktop (le plus simple — 3 clics)

Sur claude.ai ou Claude Desktop, vous n'avez besoin ni de terminal ni de clé API :

  1. Ouvrez Paramètres → Connectors → « Add custom connector »
  2. Saisissez « HeatMapX » comme nom et https://heatmapx.com/api/mcp comme URL → ajouter → « Connect »
  3. Connectez-vous à HeatMapX et vérifiez l'écran de consentement (accès en lecture / créer et démarrer / arrêter des expériences / enregistrer des sites), puis cliquez sur « Allow »

C'est tout — posez vos questions dans le chat. Vous pouvez vous déconnecter à tout moment dans HeatMapX Paramètres → Connected apps.

Connexion depuis Claude Code (terminal, 2 étapes)

1. Générer une clé API

Dans votre tableau de bord HeatMapX, allez dans Paramètres → Clés API et cliquez sur « Générer une nouvelle clé ». La clé n'est affichée qu'une seule fois — copiez-la immédiatement.

2. Exécuter une commande

Dans votre terminal (remplacez YOUR_API_KEY par la clé copiée) :

claude mcp add --transport http heatmapx https://heatmapx.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

C'est terminé. Redémarrez Claude Code (ou démarrez une nouvelle conversation) et les outils HeatMapX sont disponibles.

Ce que vous pouvez faire

Une fois connecté, des questions comme celles-ci fonctionnent directement :

  • « Montre-moi mes sites » → vos sites enregistrés et leurs URL
  • « Quelle page de kpop-ticket.com a le pire taux de défilement ? » → trouvé à partir des statistiques par page
  • « Résume la heatmap de /pricing » → zones de clics les plus denses et portée du défilement
  • « Où en est mon test A/B ? Puis-je déjà désigner un gagnant ? » → métriques par variante et suggestion de gagnant statistiquement fondée

HeatMapX fournit les chiffres ; Claude fait l'interprétation. Chacun fait ce qu'il fait de mieux.

Pas seulement lire : créer et lancer des tests A/B

Connectez-vous avec un accès en écriture et tout le cycle se déroule dans la conversation :

  • « Crée un test A/B sur ma page d'accueil : deux textes de CTA » → un brouillon est créé
  • « Démarre-le » → Claude résume l'expérience et demande toujours votre confirmation → dites OK et il passe en ligne
  • « Arrête-le » → même confirmation, puis il s'arrête

Sécurité intégrée par conception :

  • La création aboutit toujours à un brouillon (rien ne diffuse de trafic tout seul)
  • Démarrer / arrêter ne s'exécutent jamais sans votre approbation explicite (confirmation en deux étapes)
  • La suppression est impossible via l'IA (les opérations irréversibles sont exclues)
  • Les autorisations sont détaillées sur l'écran de consentement et révocables à tout moment dans Paramètres → Connected apps

Outils disponibles

Outil Ce qu'il retourne
list_sites Vos sites enregistrés
get_page_stats Sessions, clics et profondeur de défilement moyenne par page
get_heatmap_summary Agrégats de heatmap pour une page (avec plage temporelle)
list_experiments Vos expériences A/B
get_experiment_results Métriques par variante, amélioration, suggestion de gagnant

Cinq outils de lecture plus cinq outils d'écriture (create_site / create_experiment / start·pause·stop_experiment). Les outils d'écriture ne fonctionnent que sur les connexions pour lesquelles vous avez explicitement approuvé l'accès en écriture, et start/stop nécessitent toujours une confirmation au sein de la conversation.

Ça ne se connecte pas — liste de vérification

  • Clé mal collée ? Vérifiez que vous avez bien collé la chaîne complète commençant par hmx_live_
  • Clé révoquée ? Vérifiez dans Paramètres → Clés API qu'une clé active existe

Tarifs

L'accès MCP est gratuit sur tous les plans (avec une simple limite de rafale raisonnable). Heatmaps et tests A/B, directement depuis Claude — essayez dès maintenant.

Des heatmaps depuis Claude Code — gratuit pour commencer.

Ajoutez une balise de tracking, recevez analyses et suggestions CRO depuis la CLI.