Connecter Equilibrition à ChatGPT et Claude avec MCP

Préparer votre espace Equilibrition

1. 1

   Choisir le contexte

   Ouvrez Gérer les domaines dans la barre latérale. Créez par exemple un domaine Démo et activez son interrupteur Accès MCP. Ajoutez-y un projet Démo MCP et une note de test.

   Résultat attendu : Vous disposez d’un petit contexte facile à reconnaître dans la conversation.

2. 2

   Vérifier les accès

   Ouvrez votre compte en bas de la barre latérale, puis Paramètres > Agents. Vérifiez que Suspendre tous les accès agents est désactivé. Ouvrez Voir le contexte partagé.

   Résultat attendu : Vous voyez le contexte partageable de l’espace. Chaque connexion OAuth peut en recevoir seulement une partie.

3. 3

   Copier la bonne adresse

   Copiez l’URL du serveur MCP affichée dans Paramètres > Agents. En production, c’est https://api.equilibrition.com/mcp. Un espace bêta utilise sa propre adresse : copiez celle de cet espace.

   Résultat attendu : Vous avez l’adresse du serveur, pas celle du site public ni celle du dashboard.

Comment connecter Equilibrition à ChatGPT ?

Utilisez une app MCP personnalisée sur ChatGPT web et l’authentification OAuth. Le compte qui configure l’app doit disposer des droits nécessaires dans ChatGPT ; être administrateur Equilibrition n’est pas requis.

1. 1

   Activer le mode développeur

   Dans ChatGPT, ouvrez Settings > Apps > Advanced settings et activez Developer mode si ce réglage est disponible. En organisation, l’administrateur peut devoir autoriser cette fonction dans les paramètres de l’espace.

   Résultat attendu : La création d’une app personnalisée est accessible à votre compte.

2. 2

   Créer l’app

   Dans Apps, choisissez Create. Nommez l’app Equilibrition, collez l’URL MCP copiée ci-dessus et sélectionnez OAuth. Utilisez la découverte automatique des paramètres OAuth ; ne collez pas votre mot de passe dans les champs de configuration.

   Résultat attendu : ChatGPT peut contacter le serveur MCP Equilibrition.

3. 3

   Autoriser et terminer

   Lancez Scan Tools si proposé. Sur la page Equilibrition qui s’ouvre, connectez-vous, sélectionnez les domaines et gardez Lecture pour commencer. Cliquez sur Autoriser la connexion, puis terminez avec Create dans ChatGPT.

   Résultat attendu : L’app et ses outils sont disponibles pour un test dans ChatGPT.

4. 4

   Tester dans une conversation

   Ouvrez une nouvelle conversation, sélectionnez l’app Equilibrition dans le menu des outils, puis demandez : « Liste mes domaines Equilibrition accessibles, sans rien modifier. »

   Résultat attendu : Un appel d’outil renvoie les domaines réellement accordés. Une réponse sans appel d’outil ne prouve pas la connexion.

Comment connecter Equilibrition à Claude ?

Ajoutez un connecteur distant avec la même URL MCP. Vous n’avez pas besoin d’installer un serveur local ni de modifier un fichier de configuration Claude Desktop.

1. 1

   Ajouter un connecteur

   Dans Claude, ouvrez Customize > Connectors (Personnaliser > Connecteurs), puis + et Add custom connector. Nommez-le Equilibrition et collez l’URL du serveur MCP.

   Résultat attendu : Le connecteur pointe vers votre environnement Equilibrition.

2. 2

   Se connecter

   Cliquez sur Add, puis Connect si proposé. Les champs OAuth avancés Client ID et Client Secret peuvent rester vides pour la découverte automatique. Connectez-vous sur la page Equilibrition ouverte par Claude.

   Résultat attendu : L’écran d’autorisation Equilibrition affiche la demande de Claude.

3. 3

   Choisir et autoriser

   Sélectionnez les domaines nécessaires, choisissez Lecture pour le premier essai et cliquez sur Autoriser la connexion.

   Résultat attendu : La connexion OAuth devient active et apparaît dans Paramètres > Agents d’Equilibrition.

4. 4

   Activer dans le chat

   Dans une conversation Claude, ouvrez + > Connectors et activez Equilibrition. Demandez : « Liste mes domaines Equilibrition accessibles, sans rien modifier. »

   Résultat attendu : Claude appelle le connecteur et affiche le contexte autorisé.

Que peut voir et modifier votre assistant ?

Les accès se cumulent : une connexion valide, les scopes requis, un domaine accordé avec Accès MCP actif et un objet non privé sont nécessaires. Le droit Écriture permet des modifications immédiates dans le domaine concerné.

Lecture

Rechercher et consulter les données autorisées. Une connexion en lecture ne peut pas créer une tâche ou modifier son statut.

Écriture

Créer une capture, une tâche, une note ou une ressource, modifier une tâche et appliquer des créneaux, selon les scopes accordés. Il n’y a pas de file d’approbation dans Equilibrition.

Objets privés

Les éléments privés ou sensibles sont exclus du contexte agent, même dans un domaine partagé. Un sous-domaine reste soumis aux permissions de son domaine parent.

Contexte partagé

Cette vue et le graphe en mode agent montrent le périmètre partageable de l’espace. Ils ne simulent pas les restrictions propres à chaque connexion OAuth.

Données du compte

Les outils MCP n’exposent pas les mots de passe, tokens, données de facturation, invitations ou identifiants des services connectés.

Les 14 outils MCP disponibles dans Equilibrition

Le serveur expose les outils ci-dessous. Leur présence dans la liste ne garantit pas leur autorisation : les scopes et les permissions sont contrôlés à chaque appel.

search_context

Recherche dans le contexte autorisé : retrouvez les objets utiles avant d’agir.

list_domains

Liste les domaines accessibles à cette connexion.

list_subdomains

Liste les sous-domaines autorisés, avec un filtre de domaine facultatif.

get_domain_context

Récupère les projets, tâches, notes et ressources d’un domaine autorisé.

get_subdomain_context

Récupère le contexte d’un sous-domaine autorisé.

get_project_context

Lit un projet et ses tâches, notes et ressources liées.

suggest_inbox_orientation

Lit jusqu’à 20 captures et fournit les règles pour proposer Tâche, Note ou Ressource. Ne classe pas automatiquement les captures.

create_inbox_item

Dépose une capture dans l’Inbox avec son contenu complet et une classification proposée. Ne crée pas directement une tâche, note ou ressource.

create_task

Crée immédiatement une tâche avec son titre, son contexte et, si fournis, sa durée et sa priorité.

update_task

Modifie une tâche après lecture de sa version actuelle, pour éviter d’écraser une modification concurrente.

create_note

Crée immédiatement une note visible par les agents dans le domaine autorisé en écriture.

add_resource

Ajoute une référence avec son titre, son type, son résumé et éventuellement son URL. N’envoie pas un fichier local.

propose_schedule

Calcule une proposition de créneaux sans l’appliquer au calendrier.

apply_schedule

Applique les créneaux explicitement fournis, après contrôle des permissions. À distinguer d’une simple proposition.

Réussir votre premier essai — ou votre démo en live

1. 1

   Montrer le contexte

   Affichez le domaine Démo et le projet Démo MCP dans Equilibrition. Utilisez des données fictives. Dans l’assistant, copiez le premier exemple proposé en haut de cette page.

   Résultat attendu : Le public voit le lien entre les données de l’application et la réponse de l’assistant.

2. 2

   Montrer une action

   Si vous avez accordé Écriture au domaine Démo, utilisez l’exemple de capture Inbox ou de création de tâche. Attendez le résultat de l’outil avant de continuer.

   Résultat attendu : L’assistant renvoie une création réussie et un identifiant, ou une erreur explicite à corriger.

3. 3

   Vérifier dans l’application

   Revenez dans Captures ou Tâches et actualisez la liste si nécessaire. Ouvrez l’élément pour vérifier son contenu, son domaine et sa durée. Consultez aussi l’Historique récent dans Agents.

   Résultat attendu : La démonstration confirme une modification réelle, pas seulement une phrase dans le chat.

Et pour un client MCP qui utilise un token manuel ?

Ce parcours est destiné aux clients capables d’envoyer un en-tête Authorization: Bearer <token> en Streamable HTTP. Pour ChatGPT et Claude dans le navigateur, privilégiez les parcours OAuth ci-dessus.

Dans Paramètres > Agents > Connecter, saisissez un nom et une expiration en jours (90 par défaut, de 1 à 365). Cliquez sur Créer le token, puis sur l’icône Copier. Le secret n’est affiché qu’une fois. Configurez l’URL MCP et ce secret dans les paramètres sécurisés de votre client, jamais dans un message de chat.

Le formulaire de token manuel propose le nom et l’expiration ; il ne propose pas de sélecteur de scopes ni de domaines. N’y cherchez pas les choix Lecture/Écriture de l’écran OAuth. Utilisez OAuth pour choisir explicitement le périmètre lors de la connexion.

Résoudre un problème de connexion MCP

Aucun domaine proposé

Activez Accès MCP sur un domaine non archivé, puis Actualiser les domaines sur l’écran OAuth. Si la demande a expiré, recommencez depuis le client IA.

Connexion refusée ou expirée

Vérifiez l’URL et l’environnement (production ou bêta), la suspension globale et la révocation. Relancez l’authentification depuis le connecteur si nécessaire.

Aucun résultat

Activez l’app dans la conversation. Vérifiez les domaines accordés, le rattachement du contenu et ses exceptions privées. Un domaine non partagé ne devient pas accessible en reformulant la demande.

Lecture OK, écriture refusée

Le domaine ou les scopes sont en lecture seule. Révoquez puis reconnectez en choisissant Écriture si nécessaire. Vérifiez aussi que la cible n’est pas privée.

Un outil manque

Actualisez les outils du connecteur côté client ou recréez la connexion. La liste mise en cache peut dater d’une version antérieure du serveur.

Conflit de version

Demandez à l’assistant de relire la tâche avant de renouveler sa modification. Ne réutilisez pas une ancienne version.

L’URL affiche une erreur dans le navigateur

L’endpoint /mcp est une API, pas une page web. Le test utile est la connexion depuis le client MCP, suivie d’un appel d’outil.

Suspendre, révoquer et vérifier l’historique

Dans Paramètres > Agents, Suspendre tous les accès agents coupe les prochains accès MCP sans supprimer les connexions. Pour retirer définitivement une connexion, utilisez Révoquer dans Connexions OAuth ou l’icône de révocation du token manuel concerné.

Historique récent affiche les dernières opérations enregistrées, leur type d’acteur et leur date. Cette vue présente jusqu’à 20 entrées ; elle ne propose pas de filtres par agent ou par période. Révoquer un accès n’efface pas les données déjà transmises dans une conversation : gérez aussi cet historique chez votre fournisseur IA.