Serveurs MCP

Le Model Context Protocol (MCP) est un standard ouvert décrivant la façon dont une application d'IA découvre et utilise des outils externes. WivenLLM en est client : tout serveur MCP peut être branché, et ses outils deviennent des compétences utilisables par vos agents.


À quoi ça sert

Sans MCP, connecter WivenLLM à un outil interne suppose un développement spécifique. Avec MCP, il suffit que l'outil expose un serveur conforme au standard : WivenLLM interroge le serveur, découvre les fonctions offertes, et les propose aux agents.

L'intérêt : l'écosystème MCP est partagé. Un serveur écrit pour une autre application fonctionne ici, et réciproquement.

Exemples de ce qu'on branche ainsi : un système de tickets, un ERP, un outil de gestion de projet, un service interne, une base documentaire propriétaire.


Configurer — administrateur

Un serveur MCP s'ajoute dans le fichier de configuration JSON des serveurs MCP, situé dans le dossier de stockage de l'instance. L'interface ne propose pas de formulaire d'ajout. Le fichier se présente ainsi :

{
  "mcpServers": {
    "tickets-local": {
      "command": "npx",
      "args": ["-y", "mon-serveur-mcp"],
      "env": { "API_TOKEN": "..." }
    },
    "erp-distant": {
      "type": "streamable",
      "url": "https://mcp.exemple.ch/mcp",
      "headers": { "Authorization": "Bearer ..." }
    }
  }
}

Un serveur se déclare de deux manières :

Serveur local. WivenLLM démarre le programme et communique avec lui directement. On déclare la commande à exécuter, ses arguments et ses variables d'environnement. Le programme et ce dont il dépend (par exemple npx) doivent être présents là où tourne WivenLLM.

Serveur distant. WivenLLM se connecte à une adresse HTTP. On déclare l'URL et, le cas échéant, les en-têtes d'authentification. Le champ type vaut streamable ou sse ; sans lui, sse est utilisé.

Le serveur apparaît ensuite dans Réglages → Agent → Compétences de l'agent, section Serveurs MCP, après un rafraîchissement de la liste. Ses outils y figurent un par un.

Les serveurs MCP sont globaux : il n'y a pas d'activation par espace de travail. Les outils d'un serveur démarré sont disponibles pour tous les agents de l'instance, sauf ceux qu'un administrateur a désactivés dans cet écran.


Cycle de vie

  • Les serveurs sont démarrés à la demande, ensemble, à la première session d'agent ou à la première ouverture de l'écran d'administration. Pour en exclure un, ajoutez à sa définition "wivenllm": { "autoStart": false }.
  • L'écran d'administration affiche leur état et permet de les arrêter, de les démarrer et de recharger l'ensemble.
  • Un serveur indisponible n'empêche pas les agents de fonctionner : les outils correspondants sont simplement absents.

Points d'attention

Les outils MCP s'exécutent sans approbation. Aucune carte de validation ne s'affiche : l'outil part dès que l'agent le décide, y compris s'il modifie des données dans le système branché. Désactivez les outils d'écriture que vous ne voulez pas confier à un agent, et donnez au serveur un compte aux droits limités.

Un serveur MCP s'exécute avec les droits que vous lui donnez. Un serveur local tourne sur votre machine ; un serveur distant reçoit ce que l'agent lui transmet. N'installez que des serveurs dont vous connaissez l'origine.

Les données transitent. Un serveur MCP distant reçoit les arguments que l'agent lui envoie. Sur une installation qui ne doit rien laisser sortir, seuls des serveurs locaux ou internes ont leur place.

Chaque outil consomme du contexte. Un serveur exposant cinquante fonctions alourdit considérablement le choix de l'agent. Préférez des serveurs ciblés, désactivez les outils inutiles, et appuyez-vous sur la sélection intelligente des compétences.

→ Compétences des agents

Les erreurs sont visibles. Un outil MCP qui échoue renvoie son erreur à l'agent, qui doit la rapporter plutôt que de simuler un succès.


MCP ou flux d'agent ?

Besoin Mécanisme
Donner accès à un système externe, l'agent décidant quand l'utiliser MCP
Exécuter toujours les mêmes étapes dans le même ordre Flux d'agent
Transmettre une procédure métier Bibliothèque de compétences

Les trois se combinent au niveau de l'agent : il peut suivre une procédure décrite dans une fiche, appeler un outil MCP et lancer un flux. Un flux, lui, ne peut pas appeler d'outil MCP : il ne dispose que de ses propres blocs.