Connecter un serveur MCP

Section en cours de refonte

Les pages Intégrations seront retravaillées après la release v0.1.0 : parcours UX revus, captures d'écran ajoutées, contenu enrichi. Le contenu actuel reste correct sur la mécanique, mais peut diverger de l'UI finale.

Pour les operators qui veulent brancher un outil métier (Notion, GitHub, Slack, base de données…) sur leurs agents, sans écrire de code.

Voir aussi : Vue d'ensemble des intégrations · Câbler votre propre serveur MCP · Personnaliser le catalogue

Le catalogue v0.1.0 contient 18 entrées curées (Notion, Slack, GitHub, Linear, Atlassian, Stripe, Figma, Sentry, Cloudflare, PostgreSQL, SQLite, Git, Time, Fetch, Filesystem, Memory, Puppeteer, Brave Search). Pour Google Workspace et Microsoft 365, utilisez plutôt les connecteurs natifs (page Intégrations) plutôt qu'un MCP — Apollia a un connecteur natif OAuth pour ces deux providers.

Prérequis

• Vous savez quel outil métier vous voulez brancher.
• Vous avez les identifiants ou le token d'accès nécessaires à cet outil.
• Connexion internet active (pour parcourir le catalogue).

Étapes

1. Dans la sidebar, cliquez sur Connexions.

2. Cliquez sur le bouton Ajouter une connexion en haut à droite pour ouvrir le catalogue. Filtrez par catégorie (productivité, développement, communication…) ou tapez le nom de l'outil cherché dans la barre de recherche. [SCREENSHOT: overlay catalogue plein écran avec filtres par catégorie et niveau de confiance, recherche "Notion" tapée]

   Note : le catalogue s'ouvre en overlay plein écran, pas en onglet — il se superpose à la page Connexions.

3. Cliquez sur la carte du serveur souhaité. Vous voyez sa description, son auteur, son niveau de confiance (officiel, vérifié, communautaire), et la liste des outils qu'il expose.

4. Cliquez sur Installer. Apollia télécharge et prépare le serveur (quelques secondes), puis le wizard de configuration s'ouvre automatiquement.

5. Étape — Transport : le wizard affiche le type de transport détecté depuis la configuration du package (stdio, HTTP ou SSE). Pour la plupart des packages, le transport est préconfiguré.

   • stdio (recommandé) — le serveur tourne comme processus local, isolé, le plus sécurisé.
   • HTTP — le serveur tourne ailleurs, accessible via une URL.
   • SSE — pour les serveurs qui poussent des événements en streaming. [SCREENSHOT: ConnectorWizard étape transport, valeur auto-détectée affichée]

6. Étape — Identifiants. Renseignez les paramètres demandés (token, URL, clé). Apollia les chiffre localement et ne les transmet à aucun tiers.

7. Étape — Paramètres complémentaires. Selon le serveur, vous pouvez préciser un identifiant de base, un dépôt cible, ou un espace de travail. Cette étape est facultative pour la plupart des MCP.

8. Étape — Tester la connexion. Cliquez sur Tester. Un voyant vert apparaît avec la liste des outils détectés. Si le voyant est rouge, le message d'erreur indique précisément ce qui manque. [SCREENSHOT: étape Test du wizard, voyant vert "Connecté", latence affichée, liste des outils détectés en dessous]

9. Étape — Confirmation. Lisez le disclaimer (responsabilité du serveur communautaire) et cliquez sur Ajouter la connexion. Le connecteur passe en statut Connecté dans la liste de vos connexions.

10. Pour utiliser le MCP depuis un chat, ouvrez une conversation avec un agent qui a la permission d'utiliser ses outils, et formulez votre demande en langage naturel (par exemple : Liste mes pages Notion récentes). L'agent appelle automatiquement les bons outils.

Vérification

Dans la page Connexions, sous le segment Mes connexions actives, votre MCP apparaît avec un voyant vert et la liste de ses outils disponibles. Un agent autorisé peut désormais l'invoquer depuis n'importe quel chat ou pipeline.

Si ça ne marche pas

• Voyant rouge à l'étape Test : le token est invalide ou expiré. Régénérez-le côté outil métier puis revenez à l'étape d'identifiants du wizard.
• Aucun outil détecté : le serveur tourne mais ne déclare rien. Vérifiez la version installée dans la fiche du catalogue ou consultez la page Tester une connexion MCP.
• L'agent dit qu'il n'a pas accès à l'outil : ouvrez la fiche de l'agent et vérifiez que le MCP figure bien dans ses outils autorisés.

Concept : book ch04 — Les outils