> For the complete documentation index, see [llms.txt](https://boundaryai.gitbook.io/boundaryai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://boundaryai.gitbook.io/boundaryai-docs/boundaryai-docs-fr/api-et-webhooks/mcp.md). # Connecter des assistants IA (MCP) Laissez Claude, ChatGPT et d'autres assistants IA interroger vos analyses de retours. BAI Analytics expose une interface en lecture seule **serveur MCP** (Model Context Protocol), afin que les assistants IA puissent répondre à des questions comme *"quelles sont les principales plaintes du service client UE ce mois-ci ?"* directement à partir de vos retours analysés. MCP est la norme ouverte utilisée par les outils IA pour accéder à des données externes ; Claude, ChatGPT et un ensemble croissant de clients le prennent en charge nativement. Tout fonctionne depuis **Intégrations → Assistants IA** dans le tableau de bord. Il existe deux façons de se connecter, et toutes deux sont de bout en bout en lecture seule : | Mode d’accès | Idéal pour | Comment l’accès est accordé | | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Se connecter depuis votre assistant** (OAuth) | Utilisateurs de Claude et ChatGPT qui veulent connecter leur propre assistant sans gérer de clés. | Vous vous connectez à BAI Analytics depuis l’assistant, puis vous approuvez la connexion sur la page des assistants IA. L’accès est personnel et peut être révoqué pour chaque connexion. | | **Se connecter avec une clé d’accès** (Configuration avancée) | Claude Code, Claude Desktop, et tout autre client MCP capable d’envoyer un en-tête `Authorization` header. | Un administrateur crée une `mcp_read` clé ; la clé hérite des droits de la personne qui l’a créée. | Quelle que soit la méthode utilisée, l’assistant voit ce qu’un membre de l’organisation voit, et rien de ce qu’il fait via MCP ne peut modifier vos données. *** ### Ce que l’assistant peut faire Sept outils en lecture seule, listés en direct sur la page des assistants IA exactement comme le serveur les présente à un client : | Outil | Réponses | | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `list_sources` | Quels groupes de retours et quelles sources existent, et quelle est leur taille. Point de départ : tous les autres outils utilisent les identifiants qu’il renvoie. | | `get_source_analysis` | La répartition du sentiment, les thèmes et les correspondances aux moniteurs d’une source, sur l’ensemble de son historique (toutes les périodes analysées combinées pour les groupes suivis dans le temps). | | `list_themes` | Les thèmes regroupés d’un groupe de retours, les plus mentionnés en premier, avec les occurrences, le sentiment, la criticité et un résumé IA. Lit le même regroupement que celui affiché par le tableau de bord ; passez un `period_key` pour lire le regroupement propre à une période. | | `get_theme_verbatims` | Les commentaires clients réels que l’analyse a attribués à un thème regroupé (les mêmes que ceux listés dans la vue Evidence), éventuellement filtrés par sous-thème, sentiment ou période. | | `search_feedback` | Éléments de retour individuels arrivés via l’API, filtrés par source ou par champ. Les réponses natives aux enquêtes intégrées à l’application ne sont pas incluses. | | `list_monitors` | Moniteurs de surveillance personnalisés d’un groupe de retours, avec leurs paramètres d’alerte, leur couverture et leurs nombres de correspondances. | | `get_sentiment_trend` | Le sentiment et le volume dans le temps pour un groupe de retours avec suivi des tendances activé. | Les résultats sont paginés et dimensionnés pour le contexte d’un modèle ; les descriptions des outils indiquent à l’assistant comment paginer et ce que signifie chaque champ, donc une bonne première question est simplement *"Montrez-moi mes groupes de retours, puis aidez-moi à comprendre les principales préoccupations des clients dans l’un d’eux."* *** ### Se connecter depuis votre assistant (Claude, ChatGPT) C’est le parcours guidé sur la page des assistants IA. Il se déroule en quatre étapes : **Choisir → Connecter → Approuver → Demander**. 1. **Activez-le une seule fois pour l’organisation.** Un administrateur de l’organisation active *Activer pour cette organisation*. Jusqu’à ce moment, les membres voient qu’un administrateur doit activer l’accès aux assistants. Les connexions par authentification doivent aussi être activées pour votre environnement par l’équipe BAI Analytics ; si la page indique que l’assistant n’est pas encore disponible, contactez le support et indiquez quel assistant vous souhaitez. 2. **Choisissez** votre assistant (Claude ou ChatGPT) et indiquez si BAI Analytics y est déjà सूचीé. Si l’administrateur de votre espace de travail a déjà ajouté BAI Analytics, il vous suffit de l’ouvrir dans votre assistant et de sélectionner *Connexion*. 3. **Connecter.** Pour une première configuration, la page affiche toutes les valeurs demandées par l’assistant : le nom de la connexion, l’adresse du serveur à coller et les paramètres d’authentification (OAuth ; la page vous indique s’il faut laisser les paramètres client vides ou coller un identifiant client, et il n’y a jamais de secret client). Dans Claude, c’est *Personnaliser → Connecteurs → + → Ajouter un connecteur personnalisé*; dans ChatGPT sur le web, c’est *Plugins → Ajouter → Ajouter un serveur MCP* après avoir activé le mode Développeur sous *Paramètres → Sécurité et connexion*. Lorsque l’assistant vous y invite, connectez-vous à BAI Analytics, choisissez la même organisation que celle que vous utilisez dans le tableau de bord, puis autorisez la demande de connexion. 4. **Approuver.** Retournez sur la page des assistants IA. La nouvelle connexion apparaît comme *En attente de votre approbation* ; examinez-la puis choisissez *Autoriser l’accès en lecture seule*. Le simple fait de se connecter n’expose jamais de retours : tant que vous n’avez pas approuvé, l’assistant ne peut qu’initialiser et lister les outils. Seule la personne qui a effectué la connexion peut approuver sa propre connexion ; les administrateurs peuvent déconnecter n’importe quelle connexion mais ne peuvent pas approuver à la place de quelqu’un d’autre. 5. **Demandez.** Retournez dans votre assistant, activez BAI Analytics pour la conversation et commencez par la première question suggérée. Les connexions sont listées sur la page avec leur statut (*En attente de votre approbation*, *Accès autorisé*, *Déconnecté*) et l’heure de la dernière requête réussie. Déconnecter une connexion refuse immédiatement la prochaine requête de l’assistant ; désactiver l’accès aux assistants pour l’organisation déconnecte toutes les connexions par authentification, et le réactiver ne les restaure pas. Les clés d’accès sont indépendantes de tout cela. {% hint style="info" %} BAI Analytics n’est pas un connecteur préinstallé dans ces assistants, donc l’étape côté assistant ci-dessus est une configuration unique. Pour un espace de travail d’entreprise, la page propose aussi un **Publier BAI dans votre espace de travail** kit : les valeurs pas à pas qu’un administrateur de ChatGPT, Claude, Gemini Enterprise ou Microsoft 365 Copilot saisit une seule fois pour que chaque membre puisse se connecter, plus un message prêt à envoyer si vous n’êtes pas cet administrateur. {% endhint %} *** ### Se connecter avec une clé d’accès (configuration avancée) Pour Claude Code, Claude Desktop, les agents que vous exécutez vous-même, ou tout client pouvant envoyer un en-tête bearer. Ouvrez **Configuration avancée** sur la page des assistants IA : 1. **Créez une clé pour votre assistant** (administrateur uniquement). La clé obtient uniquement l’autorisation `mcp_read` et n’est affichée qu’une seule fois ; nommez-la d’après l’assistant et la personne qui l’utilise (par exemple, *Claude Desktop, Marketing*). Vous pouvez aussi la créer sous *Outils de développement → Clés API* avec l’autorisation *Assistant IA (lecture seule)* . 2. **Configurez votre client.** La page affiche l’URL du serveur et un bloc prêt à copier pour chaque client, avec votre clé déjà renseignée. L’URL du serveur de production est : ``` https://boundaryai-backend-279197672085.europe-west9.run.app/api/mcp ``` {% tabs %} {% tab title="Claude Code" %} ```bash claude mcp add --transport http --scope user bai-analytics \ https://boundaryai-backend-279197672085.europe-west9.run.app/api/mcp \ --header "Authorization: Bearer inpk_live_..." ``` Vérifiez-le avec `claude mcp list`. Le scope utilisateur maintient la clé hors de tout fichier commité dans votre dépôt. {% endtab %} {% tab title="Claude Desktop" %} Le fichier de configuration de Claude Desktop ne lance que des programmes locaux, donc `mcp-remote` le relie au serveur. Ajoutez ceci à `claude_desktop_config.json` (macOS : `~/Library/Application Support/Claude/`; Windows : `%APPDATA%\Claude\`) et redémarrez l’application : ```json { "mcpServers": { "bai-analytics": { "command": "npx", "args": [ "-y", "mcp-remote", "https://boundaryai-backend-279197672085.europe-west9.run.app/api/mcp", "--transport", "http-only", "--header", "Authorization: Bearer inpk_live_..." ] } } } ``` {% endtab %} {% tab title="Tout client MCP" %} Configurez un **HTTP streamable** serveur (révision du protocole 2025-06-18, sans état, sans flux SSE, sans lotissement JSON-RPC) : ```json { "url": "https://boundaryai-backend-279197672085.europe-west9.run.app/api/mcp", "headers": { "Authorization": "Bearer inpk_live_..." } } ``` Une vérification technique rapide depuis un terminal : ```bash curl -sS https://boundaryai-backend-279197672085.europe-west9.run.app/api/mcp \ -H "Authorization: Bearer inpk_live_..." \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ``` {% endtab %} {% endtabs %} 3. **Vérifiez l’accès.** Collez la clé dans *Vérifier l’accès* sur la page : il exécute un véritable `initialize` et `tools/list` contre le serveur et indique les outils disponibles. Cela confirme que la clé fonctionne, pas que votre assistant est configuré. Puis demandez simplement : *"En utilisant BAI Analytics, qu’est-ce qui a changé dans le sentiment client depuis le mois dernier, et quel moniteur se déclenche le plus ?"* ChatGPT ne peut pas utiliser de clé d’accès : son formulaire de connexion personnalisée ne dispose pas de champ pour un en-tête statique, donc utilisez le parcours de connexion ci-dessus. #### Fonctionnement des clés d’accès * Un `mcp_read` une clé peut interroger les analyses mais peut **ne jamais envoyer, créer ou transmettre**. Les autres scopes n’incluent volontairement pas MCP, donc une clé d’intégration existante ne devient pas silencieusement la surface de requête d’un assistant. Une clé sans accès MCP reçoit 403 `MCP_NOT_ALLOWED`. * **Les clés héritent des droits de la personne qui les a créées**, revérifiés à chaque requête. Si le compte de cette personne est désactivé ou qu’elle quitte l’organisation, la clé cesse immédiatement de fonctionner (403 `MCP_KEY_UNBOUND`) et la page l’indique comme arrêtée ; un administrateur la révoque dans les outils Développeur et crée un remplacement si nécessaire. * Le **Clés MCP** la liste sur la page montre chaque clé, les droits qu’elle hérite et son statut ; le **Utilisation** panneau affiche les requêtes par outil sur les derniers jours, y compris les vérifications techniques. * Les limites de débit s’appliquent comme pour toute clé (60 requêtes/minute par défaut) ; voir [Authentification et clés API](/boundaryai-docs/boundaryai-docs-fr/api-et-webhooks/authentication.md). *** ### Bonnes pratiques * **Créez une `mcp_read` clé dédiée par assistant** et étiquetez-la en conséquence, afin de pouvoir révoquer l’accès d’un assistant sans toucher à vos intégrations. * **Traitez l’accès de l’assistant comme l’accès en lecture d’un membre de l’équipe.** Il peut voir tout ce que contiennent les analyses de l’organisation, et ce qu’il récupère est partagé avec le fournisseur d’assistant que vous avez choisi. * **Le texte des retours est du contenu non fiable.** Le serveur indique à l’assistant de traiter les verbatims comme des données à analyser, jamais comme des instructions ; gardez cela à l’esprit si vous construisez votre propre agent par-dessus.