‍Étape 1 — Récupérer ton token API Clarity

Dans ton tableau de bord Clarity, va dans Settings → Data Export → Generate new API token.

Copie le token généré et garde-le sous la main.

⚠️ Ne partage jamais ce token publiquement. Il donne accès à toutes tes données Clarity. Si tu l'as exposé par erreur, génère-en un nouveau immédiatement.

Étape 2 — Trouver ou créer le fichier de config de Claude Desktop

Claude Desktop lit sa configuration depuis un fichier JSON. Il n'existe pas toujours par défaut. Ouvre le Terminal et colle cette commande :

mkdir -p ~/Library/Application\ Support/Claude && touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

Puis ouvre-le dans un éditeur de texte :

open -e ~/Library/Application\ Support/Claude/claude_desktop_config.json

💡 Dans Claude Desktop, tu peux aussi aller dans Claude → Settings → Developer → Edit Config pour ouvrir directement le fichier.

Étape 3 — Ajouter le serveur MCP Clarity dans le fichier de config

Colle ce contenu dans le fichier. Remplace TON_TOKEN_ICI par le token récupéré à l'étape 1.

{
 "mcpServers": {
   "@microsoft/clarity-mcp-server": {
     "command": "npx",
     "args": [
       "@microsoft/clarity-mcp-server",
       "--clarity_api_token=TON_TOKEN_ICI"
     ]
   }
 }
}


⚠️ Attention si tu as déjà d'autres MCPs configurés : ne crée pas un deuxième objet {} à la racine. Fusionne le bloc "@microsoft/clarity-mcp-server" dans ton "mcpServers" existant.

Étape 4 — Redémarrer Claude Desktop

Ferme complètement Claude Desktop (⌘+Q) et relance-le. Les serveurs MCP sont chargés au démarrage.

Claude va télécharger et installer automatiquement le package via npx, assure-toi d'avoir Node.js installé sur ton Mac. Pas de Node.js ? Installe-le depuis nodejs.org (version LTS).

Étape 5 — Tester la connexion

Ouvre une nouvelle conversation et pose cette question :

"Donne-moi le trafic total et le temps d'engagement des 3 derniers jours sur mon site Clarity."

Si tout est bien configuré, Claude interroge directement ton projet Clarity et te répond avec tes vraies données.

Ce que tu peux demander à Claude

• Quel est le scroll depth sur /ma-page cette semaine ?
• Combien de sessions sur mobile vs desktop les 7 derniers jours ?
• Y a-t-il des rage clicks sur ma page de vente ?
• Quelle est ma principale source de trafic cette semaine ?
• Donne-moi les sessions avec dead clicks sur /checkout
• Combien de nouveaux vs returning users ce mois-ci ?

Limites à connaître

• 10 requêtes API par jour maximum
• 3 jours de données maximum par requête
• 3 dimensions maximum par requête
• Fonctionne uniquement dans Claude Desktop (pas sur claude.ai)

Microsoft a annoncé une augmentation des limites dans les prochaines versions du MCP.

Connecter Contentsquare à Claude Desktop — Guide étape par étape

Ce que tu vas faire

Connecter le MCP officiel de Contentsquare à Claude Desktop pour interroger tes données analytics comportementales en langage naturel, heatmaps, taux de rebond, taux d'activité, funnels, sans ouvrir l'interface Contentsquare.

Avant de commencer

Deux prérequis :

• Tu dois être Admin sur ton compte Contentsquare (seuls les admins peuvent configurer le MCP)
• Tu dois avoir Claude Desktop installé sur ton Mac

Étape 1 — Générer l'URL du serveur MCP depuis Contentsquare

Contrairement à Clarity qui utilise un token à coller manuellement, Contentsquare gère l'authentification en OAuth, tout se fait depuis leur interface.

Dans Contentsquare, clique sur Analysis setup dans le menu principal, puis sur Model Context Protocol (MCP).

Sélectionne Claude Desktop comme agent cible. Contentsquare te génère une URL de serveur MCP et te guide pas à pas directement sur l'interface.

💡 L'URL ressemble à : https://api.contentsquare.com/mcp

Étape 2 — Ajouter le serveur MCP dans le fichier de config de Claude Desktop

Ouvre le fichier de configuration de Claude Desktop. Si tu ne sais pas où il est, ouvre le Terminal et colle :

open -e ~/Library/Application\ Support/Claude/claude_desktop_config.json

Ajoute le bloc suivant dans la section "mcpServers" :

{
 "mcpServers": {
   "contentsquare": {
     "command": "npx",
     "args": [
       "-y",
       "mcp-remote",
       "https://api.contentsquare.com/mcp"
     ]
   }
 }
}


⚠️ Si tu as déjà d'autres MCPs configurés (GA4, Clarity…), fusionne simplement ce bloc dans ton "mcpServers" existant, ne crée pas un deuxième objet {} à la racine.

Étape 3 — Redémarrer Claude Desktop

Ferme complètement Claude Desktop (⌘+Q) et relance-le. Les serveurs MCP sont chargés au démarrage.

Étape 4 — Authentification OAuth

Au premier appel à Contentsquare depuis Claude, une fenêtre de connexion OAuth s'ouvre dans ton navigateur. Connecte-toi avec ton compte Contentsquare.

Le token est valide 1 heure, puis se rafraîchit automatiquement. Tu n'as pas à t'en occuper.

💡 Tu ne vois que les projets auxquels tu as déjà accès dans Contentsquare, les droits existants sont respectés.

Étape 5 — Tester la connexion

Ouvre une nouvelle conversation dans Claude Desktop et pose cette question :

Quels projets Contentsquare sont disponibles pour moi ?

Si tout est bien configuré, Claude liste tes projets Contentsquare. Tu peux ensuite mentionner le nom d'un projet dans chaque question pour cibler les bonnes données.

Ce que tu peux demander à Claude

Précise toujours ton projet dans la question pour des résultats fiables.

• "Quel est le taux de rebond des 3 derniers mois sur le projet X ?"
• "Montre-moi le taux d'activité sur la page produit pour les visiteurs Chrome"
• "Compare le taux de conversion des PDP vs PLP pour le segment paid social"
• "Quels sont les principaux points de friction dans le tunnel de commande la semaine dernière ?"
• "Liste tous les groupes de pages disponibles dans le mapping de référence"
• "Quel est le taux de scroll moyen sur la homepage ce mois-ci ?"

Limites à connaître

Les tool calls analytics sont comptabilisés selon ton plan :

• Free : 300 tool calls / mois
• Growth : 36 000 tool calls / an
• Pro : 72 000 tool calls / an
• Enterprise : 108 000 tool calls / an

Les appels de configuration (lister les projets, chercher des segments, etc.) ne sont pas comptés. Seuls les appels qui retournent des données analytics sont décomptés.

Différence clé avec Clarity

Clarity = token API statique à coller manuellement dans le fichier de config.

Contentsquare = OAuth géré par leur interface, aucun token à manipuler. Plus simple à setup, plus sécurisé, mais nécessite d'être admin sur le compte.

Guide d'analyse — Session Recordings & Heatmaps

Avant de commencer

Avant d'ouvrir un seul recording, prends 10 minutes pour poser le contexte : quelles pages tu vas analyser, sur quel device, et quelle question tu veux répondre. Sans ça, tu regardes des vidéos sans savoir quoi chercher.

Rappel de structure : commence large (50-100 recordings "random" pour sentir les patterns), puis affine avec des filtres ciblés sur ce que tu as observé. Clarity et Contentsquare te permettent tous les deux d'appliquer des filtres par device, durée de session, page visitée, segment d'utilisateur.

1. Navigation et découvrabilité

Heatmaps / scrollmap

Quelle proportion d'utilisateurs voit le contenu sous la ligne de flottaison ? Si moins de 50% scrollent jusqu'à un élément important (CTA, preuve sociale, info clé), c'est un problème de positionnement. Note le pourcentage d'exposition pour chaque bloc majeur.

Heatmaps / clickmap

Est-ce que les utilisateurs cliquent sur des éléments non cliquables ? (images sans lien, textes qui ressemblent à des boutons, icônes décoratives) C'est le signal le plus direct d'une confusion UX. Chaque "faux clic" est une frustration.

Est-ce que les clics se concentrent sur les bons éléments ? Compare la hiérarchie visuelle de la page avec la carte de chaleur : si le CTA principal ne reçoit pas plus de clics que les éléments secondaires, il n'est pas assez visible.

Session recordings

Les utilisateurs utilisent-ils la recherche interne comme substitut à la navigation ? Si tu vois beaucoup de sessions où les gens arrivent sur la homepage, ignorent le menu et tapent directement dans le search bar, c'est un signal fort que la navigation n'est pas intuitive. Sur Contentsquare, tu peux filtrer les sessions par interaction avec le moteur de recherche.

Les utilisateurs font-ils des allers-retours fréquents entre les pages ? (back/forward, retour au listing depuis une fiche produit, puis retour au listing, etc.) C'est le symptôme d'une aide à la décision insuffisante : ils ne trouvent pas ce qu'il leur faut pour choisir.

2. Engagement avec les éléments clés

Heatmaps / clickmap

Le CTA principal reçoit-il des clics en proportion cohérente avec sa taille et sa position ? Si le bouton est above the fold et bien visible, il devrait concentrer une part significative des clics de la zone. Un CTA under-cliqué par rapport à des éléments secondaires adjacents est un signal à tester.

Les images produit sont-elles cliquées ? Un fort taux de clic sur les images indique que les utilisateurs cherchent à zoomer ou à voir plus de visuels. Si cette interaction n'est pas possible ou pas fluide, c'est un frein.

Contentsquare spécifiquement

Utilise le rapport "Attraction rate" (taux d'attraction) pour savoir quelle proportion de visiteurs a vu un élément, et le "Engagement rate" pour savoir combien ont interagi avec. Un élément avec un fort taux d'attraction mais un faible engagement suggère que le contenu est vu mais ne convainc pas. Un élément avec un faible taux d'attraction n'est tout simplement pas vu : problème de position ou de hiérarchie visuelle.

3. Friction dans les formulaires et le tunnel

Session recordings

Les utilisateurs abandonnent-ils au milieu d'un formulaire ? Note à quel champ ils s'arrêtent. Un abandon systématique sur un champ spécifique indique que ce champ pose problème : trop d'info demandée, libellé flou, format attendu pas clair.

Combien de tentatives font-ils avant de soumettre ? Des allers-retours répétés sur les mêmes champs signalent des messages d'erreur insuffisants ou une validation mal placée.

Funnel analysis (Contentsquare / Clarity)

Quelle est la chute entre chaque étape du tunnel de conversion ? Clairement visible dans les deux outils. Une chute anormalement haute sur une étape spécifique indique un problème à investiguer en recording.

4. Comportement spécifique au mobile

Heatmaps (mobile séparé du desktop)

Toujours analyser mobile et desktop séparément. Les patterns sont souvent radicalement différents. Sur mobile, vérifie :

• Les éléments cliqués sont-ils assez grands pour être touchés confortablement ? (zones de tap trop petites = rage clicks)
• Les menus hamburger ou dropdowns sont-ils utilisés, ou les utilisateurs les évitent-ils ?
• Y a-t-il du contenu important qui n'est visible qu'en scrollant beaucoup sur mobile ?

Session recordings

Les utilisateurs sur mobile doivent-ils scroller excessivement pour accomplir une action simple ? Note les sessions où la même zone est scrollée de haut en bas plusieurs fois : souvent le signe que les options de variation (couleur, taille, etc.) sont trop éloignées de l'image produit ou du CTA.

5. Pages de sortie et abandons

Heatmaps sur les pages à fort taux d'exit

Quelle est la dernière zone visible avant que l'utilisateur parte ? Utilise la scrollmap combinée à l'exit rate pour identifier si les sorties se produisent principalement above the fold (manque d'accroche immédiate) ou après avoir scrollé (l'utilisateur a cherché quelque chose qu'il n'a pas trouvé).

Session recordings sur les sessions avec abandon

Filtre sur les sessions qui incluent la page cible mais ne vont pas à l'étape suivante. Cherche :

• Est-ce qu'ils repartent immédiatement ? (bounce : problème de pertinence ou de première impression)
• Est-ce qu'ils ont scrollé et interagi avant de partir ? (problème d'aide à la décision, info manquante, obstacle identifiable)
• Est-ce qu'ils ont tenté une action qui a échoué ? (bug, erreur, élément non fonctionnel)

6. Preuves sociales et éléments de réassurance

Heatmaps + session recordings

Les avis clients, badges de sécurité, labels et garanties sont-ils vus ? Vérifie leur taux d'exposition via la scrollmap. Vérifie si les utilisateurs cliquent dessus pour chercher plus d'information (ex : clic sur une note vers les avis détaillés). Un taux d'interaction bas sur ces éléments peut signifier qu'ils ne sont pas visibles, pas crédibles, ou pas à la bonne place dans le parcours.

7. Rage clicks et signaux de frustration

Session recordings (Clarity notamment)

Clarity détecte automatiquement les rage clicks, les dead clicks et les excessive scrolling. Ces signaux automatiques sont ton point d'entrée le plus rapide pour identifier les zones de frustration sans avoir à regarder des dizaines de vidéos.

Rage click : l'utilisateur clique plusieurs fois de suite sur le même élément. Souvent une confusion sur ce qui est cliquable, un bouton qui ne répond pas assez vite, ou un élément décoratif qui ressemble à un lien.

Dead click : clic qui n'entraîne aucune action. Même logique.

8. Ce que les heatmaps ne te diront pas seules

Les heatmaps donnent la tendance de groupe, pas le "pourquoi". Une zone chaude n'est pas forcément bonne (ça peut être des utilisateurs confus qui cliquent dans le vide). Une zone froide n'est pas forcément un problème (si personne n'a besoin de ce bloc, c'est peut-être normal).

Toujours croiser : une observation en heatmap, vérifier en recording, valider avec la donnée quantitative (analytics, funnel). Un insight issu d'une seule source reste une hypothèse. Deux sources qui pointent dans le même sens, c'est une piste solide. Trois ou plus, c'est un insight à prioriser.

‍