Aller au contenu principal

Clients MCP

Le Model Context Protocol (MCP) est un standard ouvert pour exposer des outils aux modèles d'IA. De nombreux services proposent un serveur MCP, et vous pouvez écrire le vôtre. Un client MCP IA connecte MonoChat à un serveur MCP, afin que les outils de ce serveur puissent être donnés à vos nœuds IA et à vos agents IA, à côté des fonctions Outil IA que vous écrivez dans MonoChat.

Vous les gérez dans Paramètres › Automatisation › Clients MCP IA.

Fonctionnement​

  1. Vous ajoutez l'adresse du serveur MCP et vous vous connectez. MonoChat lit ce que le serveur propose : ses Outils, Ressources, Modèles de ressources et Invites.
  2. Lorsque vous enregistrez, MonoChat conserve cette liste comme contenu du client.
  3. Dans un nœud Générer une réponse IA ou un nœud Agent IA, vous choisissez les outils que vous voulez donner à ce nœud, et vous pouvez réécrire la description de chaque outil pour le modèle.
  4. Pendant la conversation, le modèle décide quand appeler un outil ; MonoChat appelle le serveur MCP et renvoie le résultat au modèle.

Seuls les outils que vous ajoutez à un nœud lui sont accessibles : chaque nœud ne voit donc que ce dont il a besoin.

Ajouter un client MCP​

  1. Allez dans Paramètres › Automatisation › Clients MCP IA et cliquez sur + (Créer).

  2. Renseignez les champs :

    ChampDescription
    NomUn nom pour le serveur, affiché à côté de chacun de ses outils dans les panneaux des nœuds.
    DescriptionNotes facultatives.
    VersionLa version du client que MonoChat annonce au serveur lors de la connexion, par exemple 1.0.0.
    Point de terminaisonL'URL de base du serveur MCP. MonoChat se connecte avec le transport SSE à <Endpoint>/sse ; saisissez donc l'adresse sans /sse.
    Type d'authentificationAucun, Basic (avec Nom d'utilisateur et Mot de passe) ou Bearer (avec Jeton). Les identifiants sont enregistrés avec le client.

  3. Cliquez sur Connecter. MonoChat se connecte au serveur et affiche ce qu'il a trouvé dans des onglets :

    • Informations du serveur : le Nom, la Version, la Version du protocole et les Instructions du serveur.
    • Outils : le nom et la description de chaque outil.
    • Ressources, Modèles de ressources et Invites, si le serveur en propose.

  4. Si la liste vous semble correcte, cliquez sur Enregistrer. Pour changer l'adresse et réessayer, cliquez sur le bouton Déconnecter situé à côté.

astuce

Si Connecter échoue, vérifiez que le point de terminaison est accessible depuis Internet, que le serveur prend en charge le transport SSE et que l'URL ne se termine pas déjà par /sse.

Mettre à jour la liste des outils​

Lorsque le serveur MCP ajoute ou modifie des outils, ouvrez le client avec Modifier. MonoChat se reconnecte et affiche le contenu actuel ; cliquez sur Modifier pour enregistrer la nouvelle liste.

Supprimer un client supprime aussi son contenu : les nœuds perdent donc les outils qui en provenaient.

Donner des outils à un nœud​

Nœud Générer une réponse IA​

  1. Ouvrez le nœud et faites défiler jusqu'à Paramètres des outils de contenu du client MCP IA.
  2. Cliquez sur Définir les outils de contenu du client MCP IA. Le panneau Outils de contenu du client MCP IA liste les outils déjà ajoutés à ce nœud.
  3. Cliquez sur + (Créer), puis choisissez un outil dans Outils de contenu du client MCP IA. Les outils sont listés sous la forme <nom du client> - <nom de l'outil>.
  4. La Description est renseignée avec la description propre à l'outil. Modifiez-la si vous voulez indiquer plus précisément au modèle quand utiliser l'outil, par exemple « Utilisez cet outil pour retrouver une commande à partir de son numéro ». La description est obligatoire.
  5. Répétez l'opération pour chaque outil, puis enregistrez le nœud.

Vous pouvez modifier la description d'un outil ou le retirer du nœud dans ce même panneau.

Nœud Agent IA​

Le nœud Agent IA possède le même bouton Définir les outils de contenu du client MCP IA dans sa section Paramètres des outils. Les outils MCP sélectionnés sont proposés à l'agent avec les périmètres IA et les outils IA du nœud, sur tous les harness. Voir Agents IA.

info

Une exécution d'agent vérifie que chaque outil MCP du nœud existe toujours dans votre espace de travail. Si vous supprimez un client MCP utilisé par un nœud, les exécutions de ce nœud échouent avec « Un périmètre IA ou un outil MCP est introuvable dans cet espace de travail. » tant que vous n'avez pas retiré l'outil du nœud.

Permissions​

L'accès est contrôlé par les permissions de rôle Consulter / Créer / Modifier / Supprimer les clients MCP IA dans l'automatisation et Consulter les contenus des clients MCP IA dans l'automatisation. Voir Rôles.