Ajouter un Connecteur MCP Personnalisé

Au-dela du repertoire officiel

Les connecteurs pre-integres couvrent de nombreux cas d’usage, mais votre entreprise utilise probablement des outils internes, des APIs proprietaires ou des services de niche qui ne figurent pas dans le repertoire de Le Chat. C’est la que les connecteurs personnalises entrent en jeu : vous pouvez ajouter n’importe quel serveur MCP distant a Le Chat en fournissant simplement son URL.

Le processus d’ajout

Depuis l’interface de Le Chat

L’ajout d’un connecteur personnalise se fait en quelques clics :

1. Ouvrez l’onglet Connectors dans Le Chat

2. Cliquez sur Add a custom connector (en bas de la liste)

3. Renseignez les informations demandees :

   • Nom : un nom descriptif pour identifier le connecteur (par exemple, “CRM Interne” ou “API Meteo”)
   • URL du serveur : l’adresse publique de votre serveur MCP, avec le point d’acces /mcp (par exemple, https://mon-serveur.example.com/mcp)
   • Description : une description de ce que fait le connecteur (optionnel mais recommande)
   • Methode d’authentification : aucune, token ou OAuth 2.0

4. Cliquez sur Create pour enregistrer le connecteur

Une fois cree, Le Chat interroge automatiquement le serveur pour decouvrir les outils disponibles. Vous voyez la liste des fonctions exposees par votre serveur MCP, et vous pouvez commencer a les utiliser dans vos conversations.

Decouverte automatique des outils

Lorsque vous connectez un serveur MCP personnalise, Le Chat effectue une requete de decouverte qui retourne :

• Le nom de chaque outil
• Sa description textuelle
• Les parametres attendus (nom, type, description)
• Le type de retour

Ces informations sont essentielles pour que le modele Mistral sache quand et comment utiliser chaque outil. Nous verrons dans la lecon suivante comment optimiser ces descriptions.

Methodes d’authentification

Sans authentification

Le cas le plus simple : votre serveur MCP est accessible a quiconque connait son URL. Adapte pour :

• Les outils publics qui ne manipulent pas de donnees sensibles
• Les prototypes et demonstrations
• Les serveurs MCP qui encapsulent des APIs publiques

Avec token

Vous fournissez un token qui sera envoye avec chaque requete au serveur MCP. Le token est stocke de maniere securisee cote Le Chat. Adapte pour :

• Les APIs internes protegees par une cle API
• Les serveurs MCP qui doivent identifier l’appelant
• Les cas ou vous souhaitez limiter l’acces

Avec OAuth 2.0

Le flux OAuth complet, avec redirection vers la page d’autorisation du service. C’est le mecanisme le plus securise, mais aussi le plus complexe a mettre en place cote serveur. Il fera l’objet d’un approfondissement dans de futurs guides de Mistral AI.

Pre-requis pour votre serveur MCP

Pour qu’un serveur MCP soit compatible avec Le Chat, il doit :

• Etre accessible via une URL publique (pas de localhost)
• Exposer un point d’acces au format Streamable HTTP (endpoint /mcp)
• Repondre aux requetes de decouverte d’outils au format JSON standard MCP
• Gerer correctement les appels d’outils et retourner les resultats au format attendu

Si vous developpez localement et souhaitez tester avec Le Chat avant de deployer, utilisez ngrok pour creer un tunnel vers votre serveur local :

ngrok http 8000

ngrok vous fournit une URL publique temporaire que vous pouvez utiliser comme URL de connecteur dans Le Chat. Cette approche est ideale pour le developpement et les tests.

Test avec le MCP Inspector

Avant d’ajouter votre serveur a Le Chat, testez-le avec le MCP Inspector, un outil open source qui vous permet de :

• Verifier que votre serveur repond correctement aux requetes de decouverte
• Lister les outils disponibles avec leurs descriptions et parametres
• Executer des appels d’outils manuellement et verifier les resultats
• Deboguer les problemes de format ou de typage

Le MCP Inspector se lance avec une simple commande npx :

npx @modelcontextprotocol/inspector

Il ouvre une interface web locale ou vous pouvez connecter votre serveur MCP et tester chaque outil individuellement. C’est une etape essentielle avant d’integrer votre serveur a Le Chat, car elle vous evite de consommer des messages de conversation pour du debugging.

Gestion organisationnelle

Si vous faites partie d’une organisation sur Le Chat :

• Les connecteurs personnalises que vous ajoutez sont visibles par les autres membres de l’organisation
• L’administrateur peut desactiver un connecteur personnalise pour l’ensemble de l’organisation s’il le juge inapproprie ou non securise
• Chaque utilisateur doit fournir ses propres credentials (token, OAuth) pour les connecteurs qui requierent une authentification

Securite des connecteurs personnalises

Verifier la source

Contrairement aux connecteurs officiels qui sont valides par Mistral AI, un connecteur personnalise peut executer n’importe quel code cote serveur. La description textuelle que vous voyez ne garantit pas ce que le serveur fait reellement. N’ajoutez que des serveurs MCP dont vous avez confiance dans la source :

• Serveurs que vous avez developpes vous-meme
• Serveurs de collegues ou de partenaires de confiance
• Serveurs open source dont vous avez verifie le code

Garder la validation humaine

Meme avec vos propres connecteurs, gardez la validation humaine activee pendant la phase de mise au point. Une fois que vous etes certain que tout fonctionne correctement, vous pouvez envisager d‘“Always Allow” certains outils en lecture seule.

Points cles a retenir

• Vous pouvez ajouter n’importe quel serveur MCP distant comme connecteur personnalise dans Le Chat
• Le serveur doit etre accessible via une URL publique avec un endpoint /mcp
• Trois methodes d’authentification sont supportees : aucune, token et OAuth 2.0
• Utilisez ngrok pour tester votre serveur local avec Le Chat avant de le deployer
• Le MCP Inspector est indispensable pour deboguer votre serveur avant integration
• N’ajoutez que des connecteurs de sources fiables et gardez la validation humaine activee