Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Intégrer un serveur personnalisé dans Vibe

Lekcija 13 od 14 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Connecter ton serveur MCP à Vibe
  2. Ajouter le connecteur
  3. Ce qui se passe en conversation
  4. Quand cela ne fonctionne pas
  5. Le MCP Inspector : utilise-le avant Vibe
  6. Gérer plusieurs serveurs
  7. Ključne točke

Mise à jour du 2 novembre 2026 — Le Chat devient Vibe. Depuis le 28 mai 2026, Le Chat a été rebaptisé Vibe (toujours sur chat.mistral.ai) : un agent unique pour le travail et le code, qui conserve vos conversations, vos paramètres et vos abonnements. L’expérience historique de Le Chat reste accessible en mode Chat ; en mode Work, les agents sont devenus des compétences (appelées avec @), les mémoires sont devenues la base de connaissances, et la recherche approfondie est devenue la compétence Deep Research. Les formules s’appellent désormais Mistral Free, Pro, Team et Enterprise. Cette leçon utilise le nom Vibe ; note que certains menus décrits ici peuvent avoir changé de nom ou d’emplacement.

Connecter ton serveur MCP à Vibe

Ton serveur est déployé et répond via HTTPS à une adresse stable. Vient maintenant l’étape qui donne tout son sens à ton travail précédent : le rendre utilisable en conversation par ton public cible, y compris ceux qui n’ouvriront jamais un terminal. Vibe accepte n’importe quel serveur MCP conforme en tant que connecteur personnalisé. Cette leçon couvre l’ajout du connecteur, le déroulement des appels en conversation et le diagnostic des échecs, car la première tentative échoue souvent.

Ajouter le connecteur

Ouvre Vibe sur chat.mistral.ai et navigue vers l’onglet Connectors dans la barre latérale. Tu y trouveras deux sections distinctes : les connecteurs en vedette, préconfigurés par Mistral (GitHub, Notion et autres), et tes propres connecteurs personnalisés, initialement vides. Clique sur Add Custom Connector et remplis les champs :

  1. Name : Un nom descriptif (par ex. „Task Manager“)
  2. Server URL : L’URL complète de ton point de terminaison MCP (par ex. https://my-server.com/tasks/mcp)
  3. Description : Ce que fait ton serveur (optionnel mais recommandé)

Ensuite, choisis ta méthode d’authentification : No authentication pour un serveur public, Token si tu colles ton jeton API, ou OAuth 2.0 pour un flux de consentement complet. Cliquer sur Connect déclenche la découverte : si cela réussit, Vibe affiche la liste des outils trouvés sur ton serveur, montrant le nom et la description de chacun. C’est ton premier retour réel sur la qualité de tes docstrings : tu les lis ici exactement comme le modèle les recevra.

Ce qui se passe en conversation

Une fois connecté, ton serveur apparaît dans la section Tools de la barre latérale du chat, marqué par une icône indiquant la disponibilité d’un outil externe. L’utilisateur formule sa demande en langage naturel, et le modèle la traduit :

User: Create a high-priority task to prepare the MCP demo

Vibe: [Calling create_task with the following arguments]
  - title: "Prepare the MCP demo"
  - priority: "high"

  → Do you want to authorize this tool call?

User: [Authorize]

Vibe: The task "Prepare the MCP demo" has been successfully created
with high priority. Its ID is abc123.

Cette invite de confirmation est le comportement par défaut. Tu peux l’approuver au cas par cas ou passer un outil en autorisation permanente. Résiste à la tentation de faire cela pour tout serveur que tu ne possèdes pas. La confirmation protège non seulement contre les bugs ; c’est ta seule défense contre les injections de prompt, où des instructions cachées dans les données renvoyées par un outil orientent le modèle vers des appels que personne n’a demandés. Voir défiler les arguments avant validation est ce qui te permet de repérer l’anomalie.

Quand cela ne fonctionne pas

Le message „Unable to connect“ provient presque toujours de l’une de ces quatre causes : l’URL est inaccessible depuis l’extérieur, le protocole n’est pas HTTPS (ce que Vibe exige), le serveur n’est tout simplement pas en cours d’exécution, ou CORS n’est pas configuré alors que Vibe envoie des requêtes depuis un navigateur. La commande suivante distingue les deux premières hypothèses en quelques secondes :

# Test accessibility
curl -X POST https://your-url/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

Si la connexion réussit mais qu’aucun outil n’apparaît, remonte la chaîne côté serveur : vérifie que le décorateur @app.tool() est présent sur chaque fonction, qu’aucune docstring ne manque et que le serveur MCP est monté sur la route que tu penses. Utilise MCP Inspector avant toute autre investigation.

Le cas le plus déroutant est lorsque tout fonctionne, mais que le modèle appelle le mauvais outil ou aucun. Le problème n’est alors pas technique : le modèle choisit en fonction des descriptions, et si deux outils se ressemblent ou si l’un reste vague, il choisit mal. Utilise trois leviers, dans cet ordre : rends la description plus spécifique en clarifiant le cas d’usage, renomme l’outil pour lever l’ambiguïté et réduis le nombre d’outils actifs simultanément. Enfin, si un outil renvoie une erreur, consulte les journaux du serveur, rejoue l’appel manuellement dans l’inspecteur et vérifie que les variables d’environnement sont définies et que le jeton ou les scopes OAuth accordent les permissions attendues.

Le MCP Inspector : utilise-le avant Vibe

L’inspecteur teste tes outils sans impliquer le modèle, isolant ainsi la moitié des variables du problème :

npx @modelcontextprotocol/inspector

Il ouvre une interface web où tu te connectes à ton serveur distant via son URL, listes tous les outils avec leurs descriptions et paramètres, exécutes un outil avec des arguments de ton choix et lis la réponse brute du serveur. Prends l’habitude d’effectuer cette vérification systématiquement avant d’ajouter un serveur à Vibe, car elle te donne un diagnostic immédiat : si un outil répond correctement dans l’inspecteur mais échoue dans Vibe, le serveur n’est pas en cause, et le problème réside dans la description ou le prompt.

Gérer plusieurs serveurs

Une fois que tu as installé plusieurs connecteurs, la discipline devient le facteur principal de qualité. Vibe te permet de basculer chaque connecteur : ne garde actifs que les outils nécessaires à la tâche en cours, car un modèle noyé sous cinquante outils choisit moins précisément et répond plus lentement. Cette hygiène repose sur la séparation des domaines abordée dans la leçon 10 : un serveur pour la gestion de projet, un pour la surveillance, un pour les outils internes, puisque tu n’as alors besoin d’activer que celui correspondant à la conversation en cours.

Enfin, adapte tes prompts aux capacités réellement exposées :

# Good: reflects tool capabilities
"Create a high-priority task titled 'Prepare the demo'"

# Bad: too vague, the model doesn't know which tool to use
"Manage my project"

Un dernier point utile à connaître avant de concevoir tes serveurs : les connecteurs MCP configurés dans Vibe restent disponibles sur l’application mobile. Tes outils internes deviennent ainsi accessibles depuis un téléphone, ouvrant des scénarios d’utilisation sur le terrain auxquels tu n’aurais peut-être pas pensé en développant sur un bureau.

Ključne točke

  • L’ajout d’un connecteur personnalisé dans Vibe prend 3 étapes : nom, URL, auth
  • Garde la confirmation manuelle des appels d’outils activée pour la sécurité
  • Utilise le MCP Inspector pour tester et déboguer avant l’intégration dans Vibe
  • Améliore les descriptions des outils si le modèle ne les utilise pas correctement
  • Ne garde actifs que les outils nécessaires à la tâche en cours
  • Tes serveurs MCP sont également accessibles sur mobile