This page is machine-translated from French. Read the French original.
MCP Servers
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.
What is it for?
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 :
Local server. 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.
Remote server. 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 Or 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.
Life cycle
- 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 to consider
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.
An MCP server runs with the permissions you give it. 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.
The data is being transferred. 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.
Every tool consumes context. 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.
The errors are visible. Un outil MCP qui échoue renvoie son erreur à l'agent, qui doit la rapporter plutôt que de simuler un succès.
MCP or agent flow?
| Need | Mechanism |
|---|---|
| Granting access to an external system, with the agent deciding when to use it | MCP |
| Always perform the same steps in the same order | Agent flow |
| Transmit a business procedure | Skills library |
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.
