Comment configurer et utiliser le Model Context Protocol (MCP)

Qu'est-ce que le Model Context Protocol

Le Model Context Protocol (MCP) est un cadre standardisé conçu pour permettre aux modèles d'IA, en particulier les grands modèles de langage (LLM), de se connecter à des données, outils et services externes tels que des bases de données, API et systèmes de fichiers. Il agit comme un pont, permettant aux agents d'IA d'accéder et d'utiliser ces ressources efficacement.

Qu'est-ce que l'intégration du Model Context Protocol

Le serveur MCP agit comme un pont sécurisé entre les agents d'IA et vos données Contentsquare. 
L'intégration du Model Context Protocol (MCP) Server vous permet d'accéder et d'analyser vos données Contentsquare directement via des agents d'IA comme ChatGPT, Claude, Microsoft Copilot, et plus encore. Vous pouvez exploiter des requêtes en langage naturel dans vos outils basés sur l'IA préférés pour obtenir des insights à partir de vos données.
 

Comprendre les limites d'appels d'outil

Votre offre Contentsquare inclut une allocation d'appels d'outil spécifiquement pour l'intégration MCP Server. Cela détermine combien de requêtes analytiques vous pouvez exécuter via l'intégration MCP.

Les limites d'appels d'outil sont suivies au niveau du compte, pas par utilisateur ni par projet. Tous les utilisateurs connectés à votre serveur MCP partagent le même pool d'appels d'outil.

Qu'est-ce qu'un appel d'outil ?

Un « Appel d'outil » signifie une exécution unique d'un outil fourni par le serveur MCP.

Limites d'appels d'outil par offre

Comment les appels d'outil sont comptés

Les requêtes simples utilisent 1 appel d'outil :

Exemple : « Quel était le rebond sur la page hier pour le projet 1234 ? »

• Effectue 1 appel à l'outil d'analytics (ComputeSiteMetrics)
• Compte comme : 1 appel d'outil

Les requêtes complexes peuvent utiliser plusieurs appels, mais seuls les appels analytiques sont comptabilisés :

Exemple : "Comparer le rebond sur la page de mes PDPs à celui de mes PLPs pour le segment paid social"
Effectue 3 appels au total :

• GetPageGroupsForMapping (configuration - ne compte pas)
• SearchSegments (configuration - ne compte pas)
• ComputePageComparison (analytics - compte)
• Compte comme : 1 appel d’outil

Que se passe-t-il lorsque vous atteignez votre limite d’appels d’outil ?

Lorsque vous atteignez votre limite mensuelle de requêtes, le serveur MCP cesse de traiter les nouvelles requêtes jusqu’à :

• La réinitialisation de votre limite au début du mois suivant ou
• L’achat d’une capacité supplémentaire (Pro et Enterprise uniquement) pour
   

Comment installer l’intégration Model Context Protocol

Avant de commencer

Assurez-vous de disposer des éléments suivants avant de configurer l’intégration :

• Accès au projet : Permissions pour accéder aux projets Contentsquare que vous souhaitez interroger via l’agent IA
• Agent IA compatible : Un outil IA compatible MCP tel que Claude Desktop, ChatGPT (avec support MCP), Microsoft Copilot, ou d’autres agents IA compatibles MCP.
• Connaissance du volume d’appels d’outil : Consultez les limites d’appels d’outil ci-dessus pour comprendre votre allocation mensuelle. Les clients Pro et Enterprise peuvent acheter une capacité supplémentaire si nécessaire. 

1. Cliquez sur Configuration d’analyse dans le menu principal.
    

2. Cliquez sur Model Context Protocol (MCP).

   
    

3. Sélectionnez votre agent IA et suivez les étapes de configuration directement sur l’interface.

Les jetons d’accès expirent après 1 heure et seront automatiquement Actualisés par votre agent IA. Vous ne pouvez accéder qu’aux projets pour lesquels vous avez déjà des permissions dans Contentsquare. Tous les transferts de données sont sécurisés via l’authentification OAuth.

Comment ajouter et gérer l’accès MCP des utilisateurs

Par défaut, la configuration MCP accorde aux Administrateurs client un accès complet à l’intégration MCP. Les administrateurs peuvent également accorder aux membres non administrateurs de l’équipe l’accès pour interroger les données Contentsquare via leurs agents IA.

1. Accéder à Paramètres du compte.
    
2. Ouvrir Applications connectées.
    

3. Sélectionnez l’onglet Accès utilisateur. Cet onglet liste toutes les personnes qui ont actuellement accès à MCP, y compris ce qu’elles peuvent faire et qui les a ajoutées.

   

   Remarque

   Les Administrateurs client conservent toujours leur propre accès MCP et ne peuvent pas le retirer eux-mêmes. C’est pourquoi chaque Administrateur client apparaît dans la liste même si personne ne leur a explicitement accordé l’accès.
    

4. Cliquez sur Ajouter un accès utilisateur.

   

5. Sélectionnez le niveau de permission :
   • Lecture : interroger et analyser les données Contentsquare existantes via les outils MCP.
   • Écriture : réservé aux futurs outils MCP qui pourront créer ou modifier des données (par ex. créer un segment ou un objectif via un agent IA). Ces outils ne sont pas encore disponibles, donc sélectionner Écriture n’a actuellement aucun effet, mais vous pouvez l’ajouter à l’avance, prêt pour quand ce sera disponible.
      
6. Sélectionnez à qui vous souhaitez donner l’accès.

L’accès au compte est uniquement accordé aux personnes qui sont utilisateurs de votre compte Contentsquare (vos propres membres de l’équipe). 

Comment utiliser l’intégration serveur MCP

Une fois la configuration terminée, vous pouvez commencer à poser des questions à votre agent IA en langage naturel. L’agent utilisera automatiquement les outils MCP de Contentsquare pour récupérer et analyser vos données.

Comment structurer vos requêtes d’analyse

Pour demander une analyse via l’intégration serveur MCP, vous devez spécifier le projet Contentsquare que l’agent IA doit interroger. Cela garantit que la requête fait référence aux bonnes données du projet.

Voici quelques exemples de questions courantes que vous pouvez poser :

Configuration d’analyse

• « À quels projets Contentsquare ai-je accès ? »
• « Trouve un groupe de pages dans le mapping de référence décrivant la page produit. »
• « Liste toutes les métriques possibles du site et des pages. »

Fonctionnalités de groupement et de filtrage :

• « Montre-moi le rebond sur la page des 3 derniers mois, groupé par pays de l’UE et par semaine »
• « Montre-moi le Taux d'activité sur une page produit pour les visiteurs utilisant Google Chrome »

Analyse de Funnel

• "Quel est le taux de conversion de notre Funnel de paiement cette semaine ?"
• "Montre-moi où les utilisateurs abandonnent dans le flux d'inscription"

Journey Analysis

• "Quels sont les chemins d’utilisateur les plus courants vers la page produit ?"
• "Comment les utilisateurs naviguent-ils de la page d'accueil à l'achat ?"

Page Performance

• "Comparer le rebond sur la page entre nos pages d'entrée"
• "Quelles pages ont les taux d’erreur les plus élevés ?"

Impact Analysis

• "Comparer les taux de conversion entre les utilisateurs mobile et desktop"
• "Quel est l’Impact sur le revenu de nos récents changements sur la page d'accueil ?"

Error Analysis

• Quelles sont les principales erreurs impactant mon site web ?
• Quel est l’Impact de l’erreur 'XXX' ?

Metrics and Reporting

• "Montre-moi le rebond sur la page d’hier et les pages les plus performantes"
• "Quelles sont les changements significatifs dans nos métriques comparé à la semaine dernière ?"
   

Le serveur MCP supporte les Fonctionnalités d’analyse Contentsquare suivantes :

• Funnels Analysis
• Journey Analysis
• Impact Analysis
• Metrics API
• Page Comparator
• Error Analysis (nécessite Experiencing Monitoring)
   

FAQ