Serveur MCP

1. Ce qu’un agent peut faire

Connectez un client Model Context Protocol au point de terminaison ; il pourra poser des questions comme « quelle page produit le plus de clics de rage ce mois-ci » ou « montrez-moi trois sessions d’Allemagne de plus de deux minutes », puis vous fournir un lien pour relire la session.

Outil	Réponses fournies
mp_projects	les projets que cette clé peut lire
mp_overview	sessions, personnes, pages vues, durée et signaux de frustration
mp_sessions	sessions récentes avec liens de relecture, filtrées par pays, appareil ou durée
mp_session	une session : pages dans l’ordre, événements, source et appareil
mp_pages	pages par nombre de vues, avec visiteurs uniques
mp_frustration	clics de rage, clics morts et erreurs JavaScript regroupés par page
mp_goals	vos objectifs et le nombre de fois où chacun a été atteint

2. Connexion

Le point de terminaison accepte les requêtes POST à l’adresse /mcp et utilise Streamable HTTP, version du protocole 2026-07-28.

L’authentification utilise une clé API de lecture MousePlayer ordinaire, du même type que celles créées sous Paramètres, Clés API et utilisées par l’API REST. Aucune seconde donnée d’authentification n’est nécessaire. Révoquer la clé révoque immédiatement l’accès de l’agent.

Activez ensuite le projet

Une clé API donne accès à tout votre espace de travail. Ce point de terminaison fait volontairement exception : chaque projet possède son propre commutateur sur la page des intégrations, désactivé par défaut. Un projet non activé n’apparaît pas dans mp_projects et ne peut pas être lu même si l’agent devine son identifiant.

Ce n’est pas de la bureaucratie. Une clé API dans un script de déploiement reste à un endroit que vous contrôlez ; dans un fichier de configuration d’agent, elle alimente le contexte d’un modèle, ce qui en rend la maîtrise bien moins stricte. Autoriser un projet à la fois est le contrôle adapté.

3. Lecture seule, et pourquoi cela ne changera pas

Aucun des sept outils n’écrit quoi que ce soit. Aucun effacement, export ou changement de configuration n’est possible via ce point de terminaison. Ce choix ne vient pas d’un manque de temps : un outil qu’un agent peut appeler peut aussi être appelé par erreur.

Ce qui n’est pas renvoyé

Ni les enregistrements eux-mêmes, ni les captures du DOM, ni les adresses IP. L’agent reçoit ce qu’une personne voit dans l’interface, plus le lien pour regarder le reste.

Limites de fréquence et de période

Soixante requêtes par minute et par clé, comme pour l’API REST. Une période est limitée à 365 jours et une liste de résultats à 200 lignes. Une réponse tronquée le signale, car une liste raccourcie sans avertissement ressemble exactement à une liste complète.

4. Pour les développeurs du client

Trois méthodes : server/discover, tools/list, tools/call. Aucune session, aucun flux GET, aucun Last-Event-ID - ces éléments appartiennent aux versions du protocole jusqu’à 2025-11-25 et ne font pas partie de celle-ci. Un appel GET ou DELETE reçoit 405.

Chaque requête POST contient MCP-Protocol-Version, Mcp-Method et, pour tools/call, Mcp-Name, et chacun doit correspondre au corps. Une incohérence renvoie 400 avec l’erreur JSON-RPC -32020 ; une version non prise en charge renvoie 400 avec -32022 et la liste des versions acceptées, pour que votre client puisse en choisir une et réessayer.

Deux catégories d’erreurs, volontairement

Une requête mal formée ou un outil inconnu produit une erreur JSON-RPC. « Ce projet n’est pas autorisé » ou « cette session n’existe pas » revient comme un résultat normal avec isError: true - un modèle peut se remettre du second type en demandant mp_projects puis en réessayant, mais pas du premier.

Les résultats contiennent à la fois structuredContent et les mêmes données sérialisées dans un bloc de texte, pour que les anciens clients reçoivent aussi un contenu utile.