Ajouter un Connecteur MCP Personnalisé

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 Le Chat. C’est là que les connecteurs personnalisés entrent en jeu : vous pouvez ajouter n’importe quel serveur MCP distant à Le Chat 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. Le Chat 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é Le Chat. 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 Le Chat 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 Le Chat. Cette approche est idéale pour le développement et les tests : vous modifiez votre code, vous relancez, et Le Chat voit immédiatement la nouvelle version sans aucun déploiement.

Test avec le MCP Inspector

Avant même d’ajouter votre serveur à Le Chat, 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 Le Chat, 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 Le Chat
• 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 Le Chat 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