Traduit de l'anglais à l'aide de l'IA
Veuillez noter que cet article a été traduit à l'aide de la technologie IA. Bien que nous travaillions à maintenir l'exactitude, certains détails peuvent ne pas refléter parfaitement le texte original. Si vous avez un doute sur une information, veuillez vous référer à la version anglaise.
Ce serveur MCP vous permet de connecter des agents et outils IA tiers à vos données Contentsquare. Avant d'activer un tel outil, vous êtes responsable de le vérifier et de confirmer qu'il respecte les politiques de sécurité, confidentialité et gestion des données de votre entreprise.
Utilisez cet article pour connecter un agent IA à l'intégration MCP de Contentsquare. La plupart des agents IA se connectent via OAuth. Certains outils, comme Gemini Enterprise, nécessitent que vous créiez une Application et saisissiez son ID client et sa clé secrète client.
Configurer un agent IA
Avant de commencer
Permissions de configuration
Seuls les Administrateurs client peuvent configurer l'intégration MCP et gérer qui d'autre peut l'utiliser. Une fois configurée, un administrateur peut également accorder à d'autres utilisateurs, équipes ou à tout le compte l'accès pour interroger les données Contentsquare via le serveur MCP.
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 de l'outil : Consultez les limites d'appels de l'outil ci-dessus pour comprendre votre allocation mensuelle. Les clients Pro et Enterprise peuvent acheter une capacité supplémentaire si nécessaire.
Configurer l'agent IA
- Cliquez sur Configuration d'analyse dans le menu principal.
-
Cliquez sur Model Context Protocol (MCP).
- Sélectionnez votre agent IA et suivez les étapes de configuration directement sur l'interface.
La plupart des agents IA, tels que Claude et ChatGPT, s'enregistrent automatiquement auprès de Contentsquare lors de leur première connexion. Certains outils, comme Gemini Enterprise, nécessitent plutôt un ID client et une clé secrète client.
Les jetons d'accès expirent après une heure et sont automatiquement actualisés par l'agent IA. Vous ne pouvez accéder qu'aux projets pour lesquels vous disposez déjà des permissions Contentsquare. Le transfert des données est sécurisé grâce à l'authentification OAuth.
Comment connecter un outil qui nécessite un ID client et une clé secrète client
Certains outils IA ne se connectent pas automatiquement à Contentsquare. Ils vous demandent un ID client et une clé secrète client lors de leur configuration. Gemini Enterprise fonctionne de cette manière.
Pour connecter l'un de ces outils, créez une Application dans Contentsquare. Une application appartient à votre compte Contentsquare, pas à un individu. Chacune vous fournit un ID client et une clé secrète client à coller dans l'outil externe. Contentsquare définit l'URI de redirection et les permissions pour l'outil que vous choisissez, vous n'avez donc rien de technique à saisir manuellement.
Avant de commencer
Vérifiez que vous :
- Êtes un Administrateur client sur le compte Contentsquare.
- Pouvez configurer l'outil externe. Pour Gemini Enterprise, cela signifie être administrateur Google Workspace ou équipe (édition Business), ou disposer des permissions Google Cloud IAM pour créer des magasins de données et des applications (Vertex AI).
- Disposez d'un endroit sûr pour stocker la clé secrète client, comme le gestionnaire de mots de passe de votre entreprise. La clé secrète client est affichée une seule fois.
Créer une application
- Cliquez sur votre profil.
- Accédez à Paramètres du compte.
- Ouvrez Applications connectées et sélectionnez l’onglet Applications.
- Cliquez sur Créer une application.
- Saisissez un nom pour l’Application. Utilisez un nom qui vous aide à identifier l’Application, comme Gemini Enterprise – équipe marketing.
-
Dans Connecter à, sélectionnez l’outil externe, comme Gemini Enterprise.
- Cliquez sur Enregistrer.
- Copiez l’ID client et la clé secrète client dans la section Vos identifiants et stockez-les en lieu sûr.
-
Cliquez sur l’icône œil pour afficher la clé secrète.
- Cliquez sur J’ai copié mes identifiants pour fermer la fenêtre.
La clé secrète client est affichée une seule fois, immédiatement après la création de l’Application. Elle ne peut pas être affichée à nouveau. Si vous la perdez, faites une rotation de la clé secrète pour en générer une nouvelle.
Terminer la configuration dans l’outil externe
Collez le Client ID et la clé secrète client dans l'outil externe, ainsi que les autres valeurs demandées :
- URL du serveur
- URL d'autorisation
- URL du jeton
- domaines
Utilisez le guide MCP intégré à l'application pour les valeurs exactes et les étapes pour votre outil.
- Cliquez sur Configuration d'analyse dans le menu principal.
- Sélectionnez l'onglet Model Context Protocol (MCP).
- Sélectionnez l'onglet Gemini Enterprise, puis Business Edition ou Vertex Edition (GCP), et suivez les étapes.
Une fois l'outil configuré, chaque utilisateur le connecte une fois : il se connecte à Contentsquare dans une fenêtre popup, sélectionne le compte, et choisit d'accorder l'accès à l'ensemble du compte ou à des projets spécifiques.
La personne qui effectue cette connexion détermine l'accès disponible pour la connexion :
- Si un Administrateur client effectue la connexion, la connexion peut avoir un accès au niveau du compte.
- Si un autre utilisateur effectue la connexion, la connexion est limitée à l'accès MCP de cet utilisateur. La connexion cesse de fonctionner si cet utilisateur quitte le compte ou perd l'accès MCP.
- Pour un outil partagé par une équipe, demandez à un Administrateur client d'effectuer la première connexion.
Gérez vos applications
Les applications sont utilisées par des outils externes qui nécessitent un Client ID et une clé secrète client.
Accédez à vos applications :
- Accédez à Paramètres du compte.
- Cliquez sur Applications connectées.
L'onglet Connexions actives affiche les agents IA que vos utilisateurs ont connectés.
Un compte peut avoir jusqu'à 100 Applications.
Faire pivoter une clé secrète client
Une clé secrète client est valide pendant un an. Faites-la pivoter avant son expiration, si vous l'avez perdue, ou si elle a pu être partagée avec quelqu'un qui ne devrait plus avoir accès.
Faire pivoter une clé secrète conserve le même Client ID, les mêmes permissions et connexions. Seule la clé secrète change.
- Dans l'onglet Applications, cliquez sur Changer la clé secrète dans la ligne de l'application.
-
Vérifiez la confirmation, puis cliquez sur Changer la clé secrète.
-
La fenêtre Votre nouvelle clé secrète client s'ouvre. Copiez la nouvelle clé secrète. Comme la première, elle est affichée une seule fois.
- Cliquez sur J'ai copié ma nouvelle clé secrète.
- Collez la nouvelle clé secrète dans l'outil externe dans l'heure pour éviter de perdre l'accès.
L'ancienne clé secrète cesse de fonctionner dès que vous la changez. L'outil externe continue d'utiliser son accès existant et s'arrête à son prochain rafraîchissement, dans l'heure, sauf si vous saisissez la nouvelle clé secrète.
Les utilisateurs n'ont pas besoin d'autoriser à nouveau l'outil après un changement de clé secrète.
Si la clé secrète a déjà expiré, l'outil est déconnecté. Il se reconnecte une fois qu'il dispose de la nouvelle clé secrète. Les utilisateurs qui n'ont pas utilisé l'outil au cours des 30 derniers jours doivent l'autoriser à nouveau.
Renommer une application
Renommer ne change que le nom affiché dans Contentsquare. L'ID client et la clé secrète client restent les mêmes, et aucune modification n'est nécessaire dans l'outil externe.
- Dans l'onglet Applications, cliquez sur Renommer dans la ligne de l'application.
- Saisissez le nouveau nom.
-
Cliquez sur Enregistrer.
Supprimer une application
Supprimer une application arrête immédiatement les nouvelles connexions. L'accès existant s'arrête dans l'heure.
- Dans l'onglet Applications, cliquez sur Supprimer dans la ligne de l'application.
- Vérifiez le nom de l'application et l'ID client dans la fenêtre de confirmation.
- Cliquez sur Supprimer.
La suppression est irréversible. Pour reconnecter l'outil, créez une nouvelle application et configurez l'outil externe avec les nouvelles informations d'identification.
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 de l’équipe non administrateurs l'accès pour interroger les données Contentsquare via leurs agents IA.
- Accéder à Paramètres du compte.
- Ouvrir Applications connectées.
-
Sélectionner 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.
Applications connectées comporte trois onglets :
- Accès utilisateur : Les utilisateurs qui peuvent connecter des agents IA à Contentsquare via MCP.
- Connexions actives : Les agents IA que vos utilisateurs ont connectés. Cet onglet s’appelait auparavant Applications.
-
Applications : Les applications créées par votre compte pour les outils nécessitant un ID client et une clé secrète client.
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 lui a explicitement accordé l’accès.
-
Clic sur Ajouter un accès utilisateur.
- Sélectionner 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 l’ajoutez à l’avance, prêt pour quand ce sera disponible.
- Sélectionner à qui vous souhaitez donner 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).
FAQ
Que dois-je faire si je reçois un message « Accès refusé » ou si je ne peux pas m'authentifier ?
Votre agent devrait Actualiser automatiquement le jeton. Sinon, essayez de vous réauthentifier via les paramètres de votre agent.
Pourquoi l'agent IA ne se connecte-t-il pas au serveur MCP ?
Pourquoi l'agent IA ne se connecte-t-il pas au serveur MCP ?
Quels agents IA sont compatibles avec l'intégration du serveur MCP ?
Le serveur MCP fonctionne avec tout agent IA compatible MCP, y compris :
- Claude Desktop
- ChatGPT (avec support MCP)
- Microsoft Copilot
- Gemini Enterprise
- Autres outils IA qui supportent la norme Model Context Protocol
La compatibilité dépend de la mise en œuvre du support MCP par votre fournisseur d'agent IA. Consultez la documentation de votre agent IA pour les instructions de configuration MCP.
Formons-nous des modèles tiers avec les données MCP ?
Non, nous ne formons aucun modèle tiers avec les données accessibles via le serveur MCP. Veuillez noter que nous pouvons examiner les modèles d'utilisation et les feedbacks pour améliorer la qualité de nos services.
Comment révoquer l'accès d'un agent IA connecté au serveur MCP ?
Déconnectez-le dans votre agent IA : retirez le serveur Contentsquare MCP des paramètres de votre agent IA. L'accès est automatiquement désactivé après 30 jours sans utilisation.
Si l'outil utilise une application que vous avez créée dans Applications connectées > Applications, un Administrateur client peut également supprimer cette application. Les nouvelles connexions s'arrêtent immédiatement et l'accès existant s'arrête dans l'heure.
Où puis-je voir la clé secrète client d'une application ?
Vous ne pouvez pas la voir à nouveau. La clé secrète client est affichée une seule fois, immédiatement après la création de l'application ou la rotation de sa clé secrète.
Si vous la perdez, faites une rotation de la clé secrète pour en générer une nouvelle, puis saisissez la nouvelle clé dans l'outil externe.
Pourquoi mon outil externe a-t-il cessé de fonctionner après un an ?
Les clés secrètes client sont valides pendant un an. Vérifiez la colonne Statut dans Applications connectées > Applications :
- « Expire bientôt » apparaît 30 jours avant la date d'expiration.
- « Expiré » apparaît après l'expiration de la clé secrète.
Faites une rotation de la clé secrète et saisissez la nouvelle valeur dans l'outil externe.
Pourquoi ne puis-je pas cliquer sur Créer une application ?
Seuls les Administrateurs client peuvent créer et gérer des applications. Demandez à un Administrateur client de votre compte.
Je vois une erreur lors de la création d'une application. Que dois-je faire ?
Un compte peut avoir jusqu'à 100 applications. Supprimez celles que vous n'utilisez plus, puis réessayez.