🔌 Brancher un serveur MCP sur l'assistant IA

Un connecteur MCP donne à l'assistant IA des outils supplémentaires : lire vos pages Notion, interroger un service métier, déclencher une action ailleurs. Une fois branché, l'assistant s'en sert tout seul dans le chat Texte.

🧭 Où cela se passe

Ouvrez la fenêtre Génération IA (raccourci Cmd+Shift+G), puis l'onglet Outils : vos connecteurs y sont affichés en cartes, avec le bouton Ajouter un connecteur.

➕ Créer un connecteur

Le bouton ouvre le dialogue Connecteur MCP personnalisé, avec quatre champs :

• Titre : le nom affiché sur la carte. Obligatoire.
• Serveur : l'adresse du serveur MCP. Obligatoire.
• Description : facultative.
• Méthode d'authentification : voir ci-dessous.

Le bouton Connexion crée le connecteur, puis Celestory interroge le serveur pour découvrir ses outils. La fiche s'ouvre alors, avec deux onglets : Aperçu et Fonctions.

🔐 Les quatre méthodes d'authentification

• Sans authentification : rien à saisir.
• Token API : vous collez un jeton, présenté au serveur à chaque appel.
• En-têtes JSON : vos propres en-têtes, sous forme d'objet JSON. Un JSON mal formé est signalé avant l'enregistrement.
• OAuth : aucun secret à saisir. Celestory interroge le serveur, s'enregistre auprès de lui et vous emmène sur sa page de consentement.

En choisissant OAuth, le dialogue affiche : « L'autorisation s'ouvre dans une fenêtre juste après la création du connecteur. » Vous validez sur le site du service, la fenêtre se referme, la fiche passe à Connecté et deux boutons apparaissent : Autoriser à nouveau et Déconnecter.

🔺 Si votre navigateur bloque les fenêtres surgissantes, rien ne démarre : autorisez les pop-ups pour le site, puis recommencez.

🔺 Une autorisation laissée en attente plus de dix minutes expire, et il faut la relancer depuis Celestory.

Vos secrets restent côté serveur. Un jeton enregistré n'est jamais renvoyé à l'interface : les champs repartent vides, et seuls la méthode utilisée et l'état de connexion sont affichés. Retaper une valeur remplace l'ancienne ; ne rien taper la laisse en place.

Le renouvellement est automatique. Celestory renouvelle l'accès avant qu'il n'expire, et si le service refuse quand même un appel, il retente une fois avec un accès frais. Vous n'intervenez que si le service n'a accordé aucun renouvellement : le connecteur cesse de répondre, et Autoriser à nouveau rétablit l'accès.

🧰 L'onglet Fonctions

Il liste les outils exposés par le serveur, avec leur description et un compteur. Actualiser les outils relance la découverte.

Chaque outil porte un interrupteur Autoriser. Le couper laisse l'outil visible dans la liste, mais il n'est plus jamais proposé à l'assistant : pratique pour ne laisser passer que la lecture.

🎚️ Désactiver sans supprimer

Dans l'onglet Aperçu, l'interrupteur Activé coupe le connecteur entier : sa carte passe en Désactivé et l'assistant l'ignore, sans perdre sa configuration ni son autorisation. Supprimer demande une confirmation.

👥 Les connecteurs appartiennent au projet

Un connecteur est rattaché au projet, pas à votre compte. Toute personne qui peut modifier le projet voit les mêmes connecteurs, et l'autorisation faite par un membre sert à toute l'équipe. À l'inverse, un connecteur n'apparaît pas dans vos autres projets.

🔺 Tous les modèles ne savent pas utiliser d'outils

Certains modèles ne savent pas appeler d'outils. Si vous en sélectionnez un alors qu'un connecteur est actif, un bandeau s'affiche dans l'onglet Outils et dans le chat Texte. Le modèle répondra normalement, mais n'utilisera aucun connecteur. Choisissez un modèle compatible.

📏 Limites à connaître

• Le nombre de connecteurs n'est pas plafonné.
• 128 outils au maximum sont présentés à l'assistant pour un tour ; au-delà, les suivants sont ignorés.
• L'assistant enchaîne au plus 8 séries d'appels d'outils pour une même réponse.

🛠️ Quand ça ne marche pas

Si le serveur est injoignable ou refuse la connexion, la carte passe en Erreur de connexion et le message exact s'affiche dans la fiche. Pendant une conversation, un connecteur en échec est simplement écarté : l'assistant continue avec les autres.

→ Prochaine étape : dans l'onglet Fonctions, coupez les outils inutiles, puis demandez quelque chose à l'assistant dans le chat Texte pour le voir s'en servir.

Mis à jour le : 22/09/2026