Intégrer un Serveur Custom dans Le Chat

Connecter votre serveur MCP à Le Chat

Votre serveur MCP est déployé et accessible via une URL publique. Il est temps de le connecter à Le Chat de Mistral pour l’utiliser en conversation. Cette leçon couvre l’intégration, le test et le debugging.

Ajouter un connecteur custom dans Le Chat

Étape 1 : Accéder aux connecteurs

1. Ouvrez Le Chat de Mistral (chat.mistral.ai)
2. Cliquez sur l’onglet Connectors dans la barre latérale
3. Vous verrez deux sections : les connecteurs featured (GitHub, Notion, etc.) et vos connecteurs custom

Étape 2 : Créer le connecteur

1. Cliquez sur Add Custom Connector
2. Remplissez les champs :
   • Name : un nom descriptif (ex: “Gestionnaire de Tâches”)
   • Server URL : l’URL complète de votre endpoint MCP (ex: https://mon-serveur.com/tasks/mcp)
   • Description : ce que fait votre serveur (optionnel mais recommandé)
3. Choisissez la méthode d’authentification :
   • No authentication : pour les serveurs publics
   • Token : collez votre API token
   • OAuth 2.0 : configurez le flux de consentement

Étape 3 : Connecter et vérifier

Cliquez Connect. Si la connexion réussit, Le Chat affiche la liste des tools découverts sur votre serveur. Vous pouvez voir le nom et la description de chaque tool.

Utiliser le serveur en conversation

Une fois connecté, votre serveur MCP apparaît dans la section Tools de la barre de chat. Une icône indique que des outils externes sont disponibles.

Exemple de conversation

Utilisateur : Crée une tâche haute priorité pour préparer la démo MCP

Le Chat : [Appelle create_task avec les arguments suivants]
  - title: "Préparer la démo MCP"
  - priority: "high"

  → Voulez-vous autoriser cet appel d'outil ?

Utilisateur : [Autorise]

Le Chat : La tâche "Préparer la démo MCP" a été créée avec succès
en haute priorité. Son identifiant est abc123.

Autorisation des appels

Par défaut, Le Chat demande une confirmation avant chaque appel de tool. Vous pouvez :

• Autoriser ponctuellement : pour cet appel uniquement
• Toujours autoriser : pour ce tool spécifique (déconseillé sauf pour vos propres serveurs de confiance)

Il est fortement recommandé de garder la confirmation active, surtout pour les serveurs tiers. Cela protège contre les injections de prompts qui pourraient détourner vos outils.

Debugging : quand ça ne marche pas

Problème : “Impossible de se connecter”

Vérifications :

1. L’URL est-elle accessible depuis l’extérieur ? Testez avec curl https://votre-url/mcp
2. Le protocole est-il HTTPS ? Le Chat exige HTTPS.
3. Le serveur est-il démarré ? Vérifiez les logs.
4. Les CORS sont-ils configurés ? Le Chat fait des requêtes depuis un navigateur.

# Tester l'accessibilité
curl -X POST https://votre-url/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

Problème : “Les tools ne s’affichent pas”

Vérifications :

1. Vos tools ont-ils le décorateur @app.tool() ?
2. Les fonctions ont-elles des docstrings ?
3. Le serveur MCP est-il bien monté sur la bonne route ?
4. Testez avec MCP Inspector d’abord.

Problème : “Le modèle n’appelle pas le bon tool”

Le modèle choisit les tools en fonction de leurs descriptions. Si le mauvais tool est appelé :

1. Améliorez la description (plus spécifique, cas d’usage clairs)
2. Renommez le tool (plus explicite)
3. Réduisez le nombre de tools actifs (désactivez ceux non nécessaires)

Problème : “Le tool retourne une erreur”

Vérifications côté serveur :

1. Consultez les logs du serveur
2. Testez le tool manuellement avec MCP Inspector
3. Vérifiez que les variables d’environnement sont définies
4. Vérifiez les permissions (token, scopes OAuth)

Le MCP Inspector : votre meilleur outil de debug

L’inspector permet de tester vos tools sans passer par Le Chat :

npx @modelcontextprotocol/inspector

L’inspector ouvre une interface web où vous pouvez :

• Vous connecter à votre serveur distant via son URL
• Lister tous les tools avec leurs descriptions et paramètres
• Exécuter un tool avec des arguments personnalisés
• Voir la réponse brute du serveur

Utilisez-le systématiquement avant d’ajouter un serveur dans Le Chat. Si un tool fonctionne dans l’inspector mais pas dans Le Chat, le problème vient de la description ou du prompt, pas du serveur.

Bonnes pratiques pour Le Chat

Gérer les tools actifs

Ne gardez actifs que les tools nécessaires à votre tâche. Le Chat permet de toggler chaque connecteur. Trop de tools actifs simultanément dégrade la qualité des réponses du modèle.

Prompts adaptés

Quand vous utilisez vos propres serveurs MCP, adaptez vos prompts en fonction des tools disponibles :

# Bon : reflète les capacités des tools
"Crée une tâche haute priorité intitulée 'Préparer la démo'"

# Mauvais : trop vague, le modèle ne sait pas quel tool utiliser
"Gère mon projet"

Organisation multi-serveurs

Si vous avez plusieurs serveurs MCP custom, organisez-les par domaine :

• Un serveur pour la gestion de projet
• Un serveur pour le monitoring
• Un serveur pour les outils internes

Activez uniquement le serveur pertinent pour chaque conversation.

Utilisation mobile

Les serveurs MCP connectés à Le Chat sont aussi disponibles sur l’application mobile. Cela signifie que vos outils internes sont accessibles depuis votre téléphone, ce qui ouvre des possibilités intéressantes pour les cas d’usage terrain.

Points clés à retenir

• L’ajout d’un connecteur custom dans Le Chat se fait en 3 étapes : nom, URL, auth
• Gardez la confirmation manuelle des appels de tools activée par sécurité
• Utilisez le MCP Inspector pour tester et débugger avant d’intégrer dans Le Chat
• Améliorez les descriptions des tools si le modèle ne les utilise pas correctement
• Ne gardez actifs que les tools nécessaires à la tâche en cours
• Vos serveurs MCP sont aussi accessibles sur mobile