Connecter Claude (MCP)

Interrogez Claude sur votre trafic, vos sessions, vos heatmaps et vos funnels, et laissez-le gérer vos goals, pixels publicitaires et conversions, avec vos propres droits Klickbee.

Klickbee Tracking dispose d'un serveur MCP. Une fois connecté, Claude (claude.ai, Claude Desktop ou Claude Code) peut répondre en langage naturel à vos questions sur vos statistiques : trafic, sessions, heatmaps, funnels, signaux de frustration, qui est sur votre site en ce moment. Il peut aussi créer et modifier vos goals, pixels publicitaires et conversions à votre place. Vous vous connectez avec votre propre compte Klickbee : Claude ne voit que les sites dont vous êtes membre, avec les droits que vous avez sur chacun.

L'adresse du serveur est :

https://tracking.klickbee.com/api/mcp

Sites Pro uniquement, et les modifications sont journalisées

Claude peut lire et modifier les sites Pro. Sur un site Free, ou sur un site suspendu, il est refusé avec une explication (la seule exception est la liste de vos sites, qui fonctionne sur toutes les offres). Les modifications sont réservées aux propriétaires et aux admins : un viewer peut poser des questions mais ne peut rien modifier. Les modifications effectuées via votre connexion sont journalisées, et les plus récentes sont listées dans Settings → Connections.

Se connecter

Vous trouverez l'adresse et la commande ci-dessous dans l'application, sous Settings → Connections, dans la carte Connect an assistant.

Depuis claude.ai ou Claude Desktop

Dans les réglages de Claude, ajoutez un connecteur personnalisé (les noms exacts des menus dépendent de votre application Claude et de sa version).
Collez l'URL https://tracking.klickbee.com/api/mcp.
Claude vous envoie vers Klickbee. Connectez-vous si vous ne l'êtes pas déjà.
Sur l'écran d'autorisation, vérifiez ce que l'application demande et cliquez sur Authorize.

Le connecteur Klickbee apparaît ensuite dans Claude avec ses outils. Une seule connexion couvre tous les sites dont vous êtes membre.

Depuis Claude Code

claude mcp add --transport http klickbee https://tracking.klickbee.com/api/mcp

Lancez ensuite /mcp dans Claude Code pour finaliser la connexion (même page de connexion et même écran d'autorisation).

L'écran d'autorisation

Lorsqu'une application demande l'accès, Klickbee affiche un écran d'autorisation dont le titre est le nom de l'application suivi de « wants access ». Il apparaît à chaque fois qu'une application demande à être autorisée, jamais ignoré en silence. Il vous indique ce que l'application pourra faire :

lister tous vos sites avec leur offre et leur statut ;
lire les statistiques, les sessions, les heatmaps et les visiteurs en direct sur vos sites Pro ;
créer, modifier et supprimer des goals, des pixels publicitaires (Meta, Google Ads, LinkedIn) et des conversions sur les sites dont vous êtes propriétaire ou admin.

Il précise aussi ce que l'application ne peut pas faire : ajouter du code personnalisé à votre site, voir des sites dont vous n'êtes pas membre, ou modifier la facturation ou les réglages d'équipe.

N'autorisez qu'une application que vous avez lancée vous-même

Le nom de l'application affiché sur cet écran est fourni par l'application elle-même, et Klickbee ne l'a pas vérifié. Contrôlez la destination indiquée sous « Authorization will be sent to », et cliquez sur Deny si vous ne la reconnaissez pas ou si ce n'est pas vous qui venez de lancer la connexion.

Ce que vous pouvez demander

Claude enchaîne les outils lui-même : il liste vos sites, choisit le bon, puis exécute les requêtes dont il a besoin. Quelques exemples à adapter :

Questions

« Le tracker est-il installé sur mon site, et quand les dernières données sont-elles arrivées ? »
« Combien de visiteurs et de sessions avons-nous eus ces 30 derniers jours, et d'où venaient-ils ? »
« Quelles pages cumulent le plus de rage clicks ou de dead clicks ? »
« Montre-moi les sessions de visiteurs mobiles qui ont déclenché un signal de frustration cette semaine. »
« Construis un funnel de /pricing jusqu'à l'événement d'inscription et dis-moi où les gens décrochent. »
« Compare /landing-a et /landing-b pour le goal "Booked a call". »
« Où les visiteurs arrêtent-ils de faire défiler la page /pricing ? »
« Qui est sur le site en ce moment, et depuis quels pays ? »

Modifications (propriétaires et admins)

« Crée un goal pour la page /thank-you. »
« Crée un goal pour l'événement signup_completed et envoie-le à Meta comme un Lead. »
« Liste mes pixels et désactive celui de LinkedIn. »
« Ajoute un pixel Meta avec cet identifiant : ... »

Ce que Claude peut lire

Vous pouvez désigner les sites par leur nom ; Claude trouve le bon. Les périodes disponibles sont 24 heures, 7 jours, 30 jours ou 90 jours (7 jours par défaut).

Thème	Ce que Claude peut obtenir
Vos sites	La liste de vos sites avec leur offre et leur statut, et, pour un site donné, un contrôle de santé : la balise est-elle installée, quand le dernier événement est-il arrivé, le SDK est-il à jour. Pratique pour « pourquoi n'ai-je pas de données ? ».
Trafic	Vue d'ensemble (pageviews, événements, sessions, visiteurs, tendance, pages et événements les plus fréquents), acquisition (canaux, sources, mediums, campagnes, termes, réseaux sociaux) et pages les plus vues.
Visiteurs et sessions	Une liste filtrable de sessions (canal, pays, appareil, frustration, durée, pages vues, page consultée) et le détail d'une session : parcours, chronologie des événements, localisation, appareil et frustration. Les visiteurs en direct sur le site à l'instant.
Comportement	Heatmaps de clics et tranches de défilement/attention pour une page, et totaux de frustration (rage clicks, dead clicks, retours rapides, error clicks, rage scrolls).
Analyses	Funnels (étapes de pageview ou d'événement), parcours de navigation, cohortes de rétention, et comparaison de deux pages d'atterrissage, éventuellement par rapport à un goal.
Votre configuration	Vos goals, vos pixels publicitaires et vos mappings de conversion.

Pour les mêmes questions dans le dashboard, voir Visite du dashboard, Sessions et heatmaps et Funnels, parcours et rétention.

Ce que Claude peut modifier

Les modifications se limitent à trois éléments, sur les sites dont vous êtes propriétaire ou admin :

Quoi	Ce que Claude peut faire
Goals	Créer, modifier (nom, règle, description) et supprimer des goals. Il refuse de créer un second goal avec le même type et la même règle. Un goal de pageview exige un chemin commençant par `/`.
Pixels publicitaires	Créer des pixels Meta, Google Ads et LinkedIn (l'identifiant est vérifié), les renommer, les activer ou les désactiver, changer leur identifiant et les supprimer. Un nouveau pixel commence à se charger dès la prochaine page vue.
Conversions	Envoyer un goal à un pixel comme conversion (avec valeur et devise facultatives), et arrêter de l'envoyer.

Deux conséquences à garder en tête :

Supprimer un goal ou un pixel supprime aussi ses mappings de conversion. C'est irréversible. Vos événements enregistrés sont conservés.
Modifier la règle d'un goal change aussi les chiffres passés, car les accomplissements d'un goal sont recalculés à partir des événements stockés.

Les pixels de code personnalisé restent dans le dashboard

Claude ne peut ni créer, ni modifier, ni supprimer un pixel de code personnalisé, et il ne peut pas voir le code. C'est volontaire : le code personnalisé s'exécute sur les pages de vos visiteurs. Ajoutez-les et modifiez-les vous-même depuis Optimize → Pixels. Les pixels personnalisés apparaissent dans la liste que Claude lit, sans leur code.

Une conversion Google Ads créée depuis Claude est envoyée depuis les serveurs de Klickbee : elle ne prend donc effet qu'une fois Google Ads connecté sur la page Pixels. Voir Conversions.

Ce que Claude ne peut pas faire

Modifier la facturation ou les offres, gérer votre équipe ou les invitations, créer, renommer ou supprimer un site, renouveler sa clé publique, ou modifier ses origines autorisées.
Connecter ou déconnecter vos comptes Meta ou Google Ads.
Toucher aux expériences ou aux funnels enregistrés, générer des résumés IA, lire un replay de session (il n'obtient que l'identifiant du replay), ou modifier le snippet d'installation.
Voir un site dont vous n'êtes pas membre, ou lire un site Free ou suspendu.

Rôles, offres et sites suspendus

Situation	Ce qui se passe
Site Free	Claude peut le lister, mais toute autre demande est refusée avec « MCP access is a Pro feature for this site », accompagné d'un lien pour passer en Pro.
Site suspendu	Refusé avec « This site is suspended », accompagné d'un lien vers Settings → Billing. Voir Facturation.
Vous êtes viewer	Claude peut tout lire sur ce site, mais toute modification est refusée : demandez à un propriétaire ou à un admin du site d'effectuer la modification ou de changer votre rôle. Voir Inviter votre équipe.
Vous êtes propriétaire ou admin	Claude peut lire et effectuer les modifications ci-dessus.
Site dont vous n'êtes pas membre	Même réponse que pour un site inconnu : « Project not found or not accessible ».

La connexion elle-même n'exige pas le plan Pro : l'offre est vérifiée à chaque requête, de sorte qu'un utilisateur Free peut se connecter et obtenir une explication plutôt qu'une erreur au moment de la connexion.

Limites

Claude peut les atteindre sur de gros sites. Dans ce cas, la réponse indique ce qui a été tronqué ou lui dit d'attendre, et Claude vous l'explique généralement. Les limites de débit ci-dessous correspondent aux réglages par défaut actuels.

Les requêtes lourdes sont limitées par compte : funnels, parcours, rétention, comparaisons de pages et heatmap d'une page donnée se partagent un budget de 20 par minute, et 2 au maximum peuvent s'exécuter en même temps (une requête de visiteurs en direct occupe aussi l'une de ces 2 places pendant son exécution). Si Claude en demande trop à la fois, il reçoit l'instruction d'attendre une minute et de les lancer une par une.
Débit global de requêtes : environ 300 requêtes par minute et par utilisateur. Au-delà, les requêtes sont refusées pendant un court moment avant d'être de nouveau acceptées.
Les listes sont plafonnées. Par défaut, une liste renvoie jusqu'à 50 lignes et 200 au maximum. Les listes de sessions renvoient 100 lignes au plus par page. Les listes de pages couvrent 100 pages au maximum. La heatmap conserve les 200 cellules les plus denses d'une page et liste 50 pages au maximum. Un funnel accepte de 1 à 10 étapes. Les visiteurs en direct s'observent sur une fenêtre de 1 à 60 minutes, et 50 visiteurs au maximum sont listés.
Les résultats tronqués sont signalés. Lorsqu'un résultat est tronqué, Claude en est informé, ainsi que du fait que le total n'est qu'une borne inférieure le cas échéant. Demandez une période plus courte ou un filtre plus étroit pour obtenir des chiffres complets.
Les heatmaps de défilement et d'attention couvrent tous les appareils. Seules les heatmaps de clics peuvent être filtrées par ordinateur ou mobile.
Les listes de goals affichent la règle et les mappings de chaque goal, pas ses accomplissements. Pour obtenir un chiffre, Claude compare des pages par rapport au goal ou construit un funnel.

Ces valeurs peuvent évoluer avec Klickbee.

Settings → Connections

Ouvrez Settings → Connections pour voir et contrôler ce que vos assistants ont fait.

Connected apps : chaque application que vous avez autorisée, avec son nom, un badge Active ou Expired, l'endroit vers lequel elle vous renvoie, la date de sa première autorisation et la date à laquelle elle a reçu un jeton pour la dernière fois. Cliquez sur Revoke pour couper l'accès à une application. Elle cesse de fonctionner à sa prochaine requête ; pour la réutiliser, vous devez la reconnecter et l'approuver de nouveau.
Recent changes through MCP : les modifications effectuées via vos propres connexions (pas celles de vos collègues), avec l'heure (UTC), le site, l'action, sa cible et le résultat : Done, ou Refused avec le motif. Elle liste vos 20 entrées les plus récentes et ne couvre que les modifications, pas les questions. Une modification refusée parce que le goal ou le pixel est introuvable, ou existe déjà, est listée. Une requête refusée à cause de l'offre du site ou de votre rôle (par exemple viewer) n'est pas listée : Claude vous explique simplement pourquoi. Le journal est conservé 180 jours.

Pour être certain qu'une application n'a plus aucun accès, révoquez-la ici, même si vous avez aussi supprimé le connecteur dans les réglages de Claude.

Rester connecté

Claude renouvelle son accès automatiquement en arrière-plan. Après une longue période sans utilisation (environ une semaine), il peut vous être demandé de vous reconnecter et de réautoriser l'accès.

En cas de problème

« MCP access is a Pro feature for this site » : le site est sur l'offre Free. Passez-le en Pro dans Settings → Billing.
« This site is suspended » : l'abonnement du site n'est pas actif. Réactivez-le dans Settings → Billing.
« Your role on this site is viewer (read-only) » : vous pouvez poser des questions mais rien modifier sur ce site. Demandez à un propriétaire ou à un admin.
« Project not found or not accessible » : le site n'existe pas, ou vous n'en êtes pas membre. Demandez à Claude de lister vos sites.
« Heavy queries … are limited to 20 per minute » ou « Another heavy query is still running » : attendez une minute et demandez une seule analyse à la fois.
Claude répond « no data » : demandez-lui de contrôler la santé du site. Voir Dépannage.
Le connecteur ne se connecte pas : vérifiez que l'URL est exactement https://tracking.klickbee.com/api/mcp et que vous êtes connecté à Klickbee avec le bon compte.
Un outil est absent ou une application semble bloquée : révoquez l'application sous Settings → Connections et reconnectez-la.

Toujours bloqué ? Contactez-nous.

Sur cette page