Connecter Piano Analytics à Claude : les deux voies, et laquelle choisir.

Il y a aujourd'hui deux façons d'interroger Piano Analytics depuis Claude. La première est le serveur MCP de Piano lui-même : un outil, votre clé d'API, Claude Desktop ou Claude Code, et un accès encore en bêta privée, à demander à Piano. La seconde passe par un connecteur qui lit Piano par son API et le sert à Claude avec vos autres sources, comme Kyras. Si vous ne voulez interroger que Piano et que vous avez l'accès, prenez la première. Si votre question mêle Piano, vos régies et Google, la seconde vous évite de recoller les chiffres.

MCP, connecteur : de quoi parle-t-on ?

Le MCP, pour Model Context Protocol, est le protocole ouvert par lequel un assistant comme Claude appelle des outils externes. Un serveur MCP expose des outils ; Claude choisit lequel appeler, avec quels paramètres, et lit ce qu'il rend. Dans Claude, un serveur MCP ajouté à la main s'appelle un connecteur personnalisé.

Ce qui compte pour vous tient en une question : que reçoit Claude ? Des lignes brutes qu'il devra additionner lui-même, la réponse d'un outil qui a déjà interprété la question, ou des valeurs calculées et datées ? La réponse change la confiance que vous pouvez accorder au chiffre final.

Les deux voies, côte à côte

Aucune n'est meilleure dans l'absolu. Le MCP de Piano est la voie directe, maintenue par l'éditeur, sans intermédiaire. Kyras sert un autre besoin : poser une question qui traverse plusieurs outils, et retrouver les mêmes chiffres dans son rapport du lundi.

Brancher le MCP de Piano, pas à pas

Piano le range parmi ses agents, et le réserve pour l'instant aux organisations admises dans la bêta. Il faut quatre choses avant de commencer :

1. Piano AI activé pour votre organisation. Sans lui, le rôle MCP n'apparaît pas.
2. Une équipe avec le rôle MCP. Un administrateur la crée et y ajoute les utilisateurs. Retirer quelqu'un de l'équipe lui retire l'accès.
3. Votre clé d'accès et votre clé secrète, créées depuis votre profil Piano, et un site par défaut valide sur ce profil.
4. Node.js sur le poste, pour la commande npx.

Dans Claude Desktop, ouvrez Paramètres, puis Développeur, puis « Modifier la configuration », et ajoutez le serveur. Voici le bloc que publie Piano, à compléter avec vos deux clés :

{
  "mcpServers": {
    "piano-analytics-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote@0.1.18",
        "https://analytics-api-eu.piano.io/mcp/",
        "--header",
        "x-api-key:${ACCESS_KEY}_${SECRET_KEY}"
      ],
      "env": { "ACCESS_KEY": "XXXX", "SECRET_KEY": "XXXX" }
    }
  }
}

Redémarrez Claude Desktop. Dans Claude Code, une commande suffit : claude mcp add piano-analytics --scope user -- npx mcp-remote@0.1.18 https://analytics-api-eu.piano.io/mcp/ --header "x-api-key:…", avec vos clés passées en variables d'environnement. Piano décrit aussi une connexion HTTP directe, sans npx, pour les clients qui acceptent un en-tête personnalisé.

Le serveur expose un seul outil, get_web_analytics_data, qui répond à une question en langage naturel. Il travaille avec vos droits : il ne voit que les sites que vous voyez dans Piano. Piano cite aussi n8n, Zapier ou un script maison pour aller chercher des chiffres à heure fixe, sans Claude.

Si le serveur n'apparaît pas dans Claude

• « npx » introuvable : réinstallez Node.js, puis vérifiez avec npx --version.
• Erreur au démarrage : relisez la syntaxe du JSON, la présence des deux clés et le format exact de l'en-tête x-api-key.
• Aucune réponse : le réseau de votre entreprise doit laisser sortir les appels vers analytics-api-eu.piano.io.
• Refus de lecture : un site par défaut valide doit être réglé dans votre profil Piano, avec le droit de lire ses données.
• Un site sans données : vous n'y avez pas accès dans Piano, et le MCP non plus.

Avant de brancher, Piano demande aussi de vérifier deux choses : que votre fournisseur d'IA générative n'entraîne pas ses modèles sur vos données, et que votre politique interne couvre ce type d'usage. C'est valable pour toute voie, Kyras compris.

Passer par Kyras

Kyras lit Piano par son API de données, avec la même paire de clés, saisie une fois dans Kyras et stockée chiffrée (brancher Piano Analytics à Kyras). Il lit des agrégats : visites, visiteurs, pages vues, taux de rebond, durée de visite, événements et conversions de votre data model, par page, chapitre, appareil, pays et source. Les transactions et le chiffre d'affaires ne sont lus que si Sales Insights est activé sur votre site.

Côté Claude, aucune clé à poser. Ouvrez Personnaliser, puis Connecteurs, ajoutez un connecteur personnalisé avec l'adresse https://app.kyras.ai/api/mcp/mcp, connectez-vous à Kyras et choisissez l'espace. Claude reçoit cinq outils en lecture seule : la carte de l'espace, la question en français, les valeurs vérifiées d'une période, le classement par dimension, et le dossier d'un rapport. L'accès s'ouvre avec l'abonnement : pendant l'aperçu avant paiement, l'autorisation est refusée. Le pas à pas complet est dans le centre d'aide.

Que demander à Piano depuis Claude ?

Les questions qui marchent le mieux nomment la métrique, la ventilation et la période. Trois exemples, et pourquoi ils tiennent :

• « Quels chapitres ont perdu des visites ce mois-ci, par rapport au mois dernier ? » Le chapitre est la propriété de rubrique de Piano. Une question qui le nomme évite que l'assistant découpe par page, ligne par ligne.
• « D'où viennent les visites qui convertissent, par type de source ? » Une question de classement, sur une seule métrique et une seule ventilation : le format où un assistant se trompe le moins.
• « Les pages qui gagnent des clics dans Google gagnent-elles aussi des conversions ? » Celle-ci demande deux sources, la Search Console et Piano. Le MCP de Piano ne voit que Piano.

Une question, une métrique, une période.

C'est notre règle. « Analyse mon trafic » donne un commentaire. « Visites par chapitre, septembre contre août » donne un chiffre que vous pouvez vérifier dans Piano en deux minutes.

Cinq pièges qui faussent un chiffre

1. Comparer une visite Piano à une session GA4. Les deux outils ne découpent pas le temps de la même façon. Si vous avez les deux, lisez chacun dans sa tendance, et ne cherchez pas l'égalité au chiffre près.
2. Oublier le mode éco. Le MCP de Piano rend des valeurs exactes. Data Query et les tableaux de bord peuvent, eux, activer le mode éco, qui accélère le calcul au prix de petites différences. Un écart de quelques visites entre Claude et votre tableau de bord vient souvent de là.
3. Poser la question au mauvais site. Sans site nommé, le MCP de Piano interroge le site par défaut de votre profil. Nommez le site dans la question dès que vous en avez plusieurs.
4. Laisser l'assistant refaire le calcul. Un assistant qui additionne des moyennes, arrondit un taux ou compare deux périodes de longueurs différentes produit un chiffre qu'aucun outil n'a calculé. Demandez la valeur brute et sa période, puis vérifiez une fois dans Piano.
5. Partager une clé personnelle. La clé reprend les droits de la personne qui l'a créée. Posée en en-tête fixe dans un connecteur d'équipe, elle donne ces droits à tous ceux qui utilisent le connecteur.

Ce que Kyras ne fait pas avec Piano

Trois limites, dites avant que vous ne branchiez. Kyras ne prend pas en charge les filtres par expression régulière sur Piano. Il ne sait pas dire par quelle page une visite a commencé, faute de page d'entrée dans les agrégats qu'il lit. Et ses alertes Piano surveillent les visites et les conversions jour par jour, sans ventilation. L'intégration Piano Analytics détaille le reste.