MCP (Model Context Protocol)

Qu'est-ce que le MCP (Model Context Protocol) ?

Le MCP permet à vos outils IA (Claude, Cursor, etc.) d'accéder directement à vos données Piano Analytics via des requêtes en langage naturel. Au lieu de naviguer dans les tableaux de bord, demandez simplement : "Combien de visiteurs avons-nous eu la semaine dernière ?" ou "Quelles sont nos pages les plus performantes ce mois-ci ?"

Outil disponible : get_web_analytics_data - récupère les données analytiques basées sur vos questions en langage naturel.

Cas d'usage concrets :

Analyse de données analytiques : Importez vos données Piano Analytics directement dans votre LLM pour analyse et insights. Demandez "Analysez mes tendances de trafic et suggérez des stratégies d'optimisation" ou "Quels patterns voyez-vous dans mes données de conversion ?"

Workflows automatisés : Intégrez le MCP dans des plateformes d'automatisation comme N8N, Zapier, ou des scripts personnalisés pour récupérer périodiquement des données analytiques pour des rapports, alertes, ou pipelines de données sans intervention manuelle.

Agents augmentés : Créez des agents IA spécialisés qui exploitent vos données Piano Analytics pour vous assister dans des tâches spécifiques - comme un agent marketing qui surveille les performances de campagne ou un agent contenu qui suit l'engagement des pages.

Rejoindre le Programme Bêta

Pour participer à cette bêta privée :

Contactez votre CSM/KAM et demandez l'accès à la bêta Piano Analytics MCP
Spécifiez si vous avez besoin d'un accès pour des utilisateurs spécifiques ou toute votre organisation
Notre équipe vous ajoutera à la liste blanche dans 2-3 jours ouvrables
Envoyez nous vos retours après 30 jours de test par email

Limitations de la bêta :

Un seul outil disponible (get_web_analytics_data)
Aucun support dédié - documentation uniquement
Les fonctionnalités peuvent changer selon les retours
L'accès peut être révoqué à tout moment

Ce guide vous aide à connecter votre outil IA (ex. Claude Desktop) à Piano Analytics via le Model Context Protocol (MCP), permettant des requêtes sécurisées et en temps réel sur vos données analytiques.

Prérequis

Un compte Piano Analytics avec clé d'accès API personnelle et clé secrète. Disponible ici.
Node.js installé pour exécuter les scripts MCP locaux. Téléchargez l'installateur pour votre OS : https://nodejs.org/fr/download .
Vérifiez que npx est disponible dans votre terminal : npx --version.

Recommandé : STDIO (Serveur Local)

Idéal pour Claude Desktop et la plupart des clients MCP qui supportent un serveur local via npx.

Ouvrez votre outil IA (ex. Claude Desktop) → Paramètres → Développeur → Modifier la config.
Ajoutez la configuration ci-dessous à votre fichier de config MCP (ex. claude_desktop_config.json) et remplacez les placeholders par vos identifiants.

JSON

{
  "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"
      }
    }
  },
  "isUsingBuiltInNodeForMcp": true
}

Sauvegardez le fichier, fermez-le, puis redémarrez votre outil IA.

Sur Windows, après avoir installé le serveur MCP sur Claude Desktop, fermer Claude ne suffit pas. Vous devez arrêter le processus dans le Gestionnaire des tâches.

Retournez dans Développeur : le serveur devrait apparaître et démarrer automatiquement comme piano-analytics-mcp-server.
Ouvrez un nouveau chat et exécutez des requêtes IA sur vos données Piano Analytics.

Endpoint MCP officiel : Piano Analytics MCP ↗.

Connexion HTTP (si votre client le supporte)

Certains clients MCP vous permettent de déclarer un serveur HTTP distant et d'attacher des headers. Si le vôtre supporte les headers personnalisés au niveau MCP, utilisez l'URL ci-dessus et ajoutez le header x-api-key formaté comme ACCESS_KEY_SECRET_KEY (joints par un underscore) dans la configuration de votre client. Si les headers ne sont pas supportés, préférez STDIO.

Claude Code

Vous pouvez aussi installer notre serveur MCP dans Claude Code depuis le terminal :

BASH

export ANALYTICS_ACCESS_KEY="XXXX" 
export ANALYTICS_SECRET_KEY="XXXX"  

claude mcp add piano-analytics --scope user -- npx mcp-remote@0.1.18 https://analytics-api-eu.piano.io/mcp/ --header "x-api-key:${ANALYTICS_ACCESS_KEY}_${ANALYTICS_SECRET_KEY}"

Bonnes pratiques de sécurité

Stockez les clés API dans des variables d'environnement ou un coffre-fort sécurisé.
Limitez les permissions au minimum requis et ne partagez jamais les secrets.
Faites la rotation/révoquez les clés si vous suspectez une exposition.

Dépannage

npx introuvable : réinstallez Node.js et vérifiez npx --version.
Erreur de démarrage MCP : vérifiez la syntaxe JSON, la présence des clés, et le format du header x-api-key:${ACCESS_KEY}_${SECRET_KEY}.
Réseau : autorisez l'accès sortant vers analytics-api-eu.piano.io.
Le client ne supporte pas les serveurs distants : STDIO via npx mcp-remote est largement compatible.