> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Brancher un serveur MCP sur l'assistant IA

# 🔌 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.

${frame}[Vidéo : brancher un serveur MCP](https://celestory-docs-videos.netlify.app/fr/geste-ui/brancher-un-serveur-mcp.html)

## 🧭 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.