Ajouter un Connecteur MCP Personnalisé

Mise à jour du 2 novembre 2026 — Le Chat devient Vibe. Depuis le 28 mai 2026, Le Chat s’appelle Vibe (toujours sur chat.mistral.ai) : un seul agent pour le travail et le code, avec vos conversations, réglages et abonnements repris. L’ancienne expérience Le Chat reste accessible dans le mode Chat ; dans le mode Work, les agents sont devenus des skills (invoquées avec @), les mémoires la base de connaissances et la recherche approfondie la skill Deep Research. Les offres s’appellent désormais Mistral Free, Pro, Team et Enterprise. Cette leçon emploie désormais le nom Vibe ; certains menus décrits ici ont pu changer de nom ou de place.

Au-delà du répertoire officiel

Les connecteurs pré-intégrés couvrent de nombreux cas d’usage, mais votre entreprise utilise probablement des outils internes, des APIs propriétaires ou des services de niche qui ne figurent pas dans le répertoire de Vibe. C’est là que les connecteurs personnalisés entrent en jeu : vous pouvez ajouter n’importe quel serveur MCP distant à Vibe en fournissant simplement son URL. Le CRM maison développé il y a six ans devient alors utilisable dans une conversation, au même titre que GitHub ou Notion.

Le processus d’ajout

L’ajout se fait en quelques clics depuis l’interface. Ouvrez l’onglet Connectors, cliquez sur Add a custom connector en bas de la liste, puis renseignez les informations demandées :

• Nom : un nom descriptif pour identifier le connecteur (par exemple, « CRM Interne » ou « API Météo »)
• URL du serveur : l’adresse publique de votre serveur MCP, avec le point d’accès /mcp (par exemple, https://mon-serveur.example.com/mcp)
• Description : une description de ce que fait le connecteur (optionnel mais recommandé)
• Méthode d’authentification : aucune, token ou OAuth 2.0

Cliquez enfin sur Create pour enregistrer le connecteur. Vibe interroge alors automatiquement le serveur pour découvrir les outils disponibles : la liste des fonctions exposées s’affiche, et vous pouvez commencer à les utiliser dans vos conversations.

Cette requête de découverte retourne, pour chaque outil, son nom, sa description textuelle, les paramètres attendus avec leur nom, leur type et leur description, ainsi que le type de retour. Ce sont ces seules informations qui permettent au modèle Mistral de savoir quand et comment utiliser chaque outil — d’où l’attention que nous porterons, dans la leçon suivante, à la qualité de ces descriptions. Un outil bien écrit mais mal décrit reste invisible pour le modèle.

Méthodes d’authentification

Le cas le plus simple est l’absence d’authentification : votre serveur MCP est accessible à quiconque connaît son URL. Cela convient aux outils publics qui ne manipulent pas de données sensibles, aux prototypes et démonstrations, et aux serveurs MCP qui encapsulent des APIs publiques. L’authentification par token consiste à fournir une clé qui sera envoyée avec chaque requête au serveur ; le token est stocké de manière sécurisée côté Vibe. C’est le choix adapté aux APIs internes protégées par une clé API, aux serveurs qui doivent identifier l’appelant, et plus largement à tous les cas où vous souhaitez limiter l’accès. Vient enfin OAuth 2.0, le flux complet avec redirection vers la page d’autorisation du service : c’est le mécanisme le plus sécurisé, mais aussi le plus complexe à mettre en place côté serveur, et il fera l’objet d’un approfondissement dans de futurs guides de Mistral AI.

Pré-requis pour votre serveur MCP

La contrainte d’URL publique bloque en apparence le développement local, mais elle se contourne pendant la phase de mise au point. Si vous développez sur votre machine et souhaitez tester avec Vibe avant de déployer, ouvrez un tunnel vers votre serveur local avec ngrok :

ngrok http 8000

ngrok vous fournit une URL publique temporaire que vous pouvez utiliser comme URL de connecteur dans Vibe. Cette approche est idéale pour le développement et les tests : vous modifiez votre code, vous relancez, et Vibe voit immédiatement la nouvelle version sans aucun déploiement.

Test avec le MCP Inspector

Avant même d’ajouter votre serveur à Vibe, testez-le avec le MCP Inspector, un outil open source qui vérifie que votre serveur répond correctement aux requêtes de découverte, liste les outils disponibles avec leurs descriptions et paramètres, exécute des appels d’outils manuellement pour en contrôler les résultats, et vous aide à déboguer les problèmes de format ou de typage. Il se lance avec une simple commande npx :

npx @modelcontextprotocol/inspector

L’Inspector ouvre une interface web locale où vous connectez votre serveur MCP et testez chaque outil individuellement. L’étape n’est pas une formalité : elle vous évite de consommer des messages de conversation pour du debugging, et elle isole clairement les erreurs de votre serveur des erreurs d’interprétation du modèle.

Gestion organisationnelle

Si vous faites partie d’une organisation sur Vibe, sachez que les connecteurs personnalisés que vous ajoutez sont visibles par les autres membres. L’administrateur peut désactiver l’un d’eux pour l’ensemble de l’organisation s’il le juge inapproprié ou non sécurisé. Chaque utilisateur doit en revanche fournir ses propres credentials — token ou OAuth — pour les connecteurs qui requièrent une authentification : partager le connecteur ne revient jamais à partager les accès.

Sécurité des connecteurs personnalisés

Contrairement aux connecteurs officiels validés par Mistral AI, un connecteur personnalisé peut exécuter n’importe quel code côté serveur, et la description textuelle que vous voyez ne garantit en rien ce que le serveur fait réellement. Limitez-vous donc aux serveurs que vous avez développés vous-même, à ceux de collègues ou de partenaires de confiance, et aux serveurs open source dont vous avez vérifié le code. Même avec vos propres connecteurs, gardez la validation humaine activée pendant toute la phase de mise au point ; une fois que vous êtes certain que tout fonctionne, vous pourrez envisager d’« Always Allow » certains outils en lecture seule.

Points clés à retenir

• Vous pouvez ajouter n’importe quel serveur MCP distant comme connecteur personnalisé dans Vibe
• Le serveur doit être accessible via une URL publique avec un endpoint /mcp
• Trois méthodes d’authentification sont supportées : aucune, token et OAuth 2.0
• Utilisez ngrok pour tester votre serveur local avec Vibe avant de le déployer
• Le MCP Inspector est indispensable pour déboguer votre serveur avant intégration
• N’ajoutez que des connecteurs de sources fiables et gardez la validation humaine activée