Configurations · Niveau intermédiaire

Configuration : Hermes Agent avec un accès MCP à un seul dossier

Recette à copier pour connecter Hermes Agent au serveur MCP de système de fichiers, limité à un dossier et aux seuls outils nécessaires, expliquée ligne par ligne.

Par Équipe éditoriale de Cognenza · Mis à jour le 15 octobre 2026 · 3 min de lecture · Sources citées

À quoi ça sert

MCP est un standard ouvert que son site décrit comme « un port USB-C pour les applications d’IA » : une façon commune de connecter une IA à des outils et à des données. Avec cette recette, Hermes Agent peut travailler avec les fichiers d’un seul dossier, et rien d’autre.

La recette

Ouvrez (ou créez) le fichier ~/.hermes/config.yaml et ajoutez :

mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/votre-utilisateur/projets-ia"]
    tools:
      include: ["read_*", "list_*", "search_*"]

Explication ligne par ligne

Ligne	Ce qu’elle fait
`mcp_servers:`	Ouvre la liste des serveurs MCP que Hermes doit connecter
`filesystem:`	Nom que vous choisissez pour ce serveur
`command: "npx"`	Programme qui lance le serveur (fourni avec Node.js)
`args: [...]`	Télécharge le serveur officiel de fichiers et lui indique le seul dossier autorisé
`tools: include:`	Ne garde que les outils dont le nom correspond à ces motifs (ici, ceux de lecture)

Remplacez /home/votre-utilisateur/projets-ia par le chemin réel de votre dossier. Sous Windows, il ressemblera à C:/Users/votre-utilisateur/projets-ia.

Pour qu’il puisse aussi écrire

Supprimez le bloc tools: ou utilisez exclude pour retirer seulement ce que vous ne voulez pas, par exemple :

    tools:
      exclude: ["move_*"]

Sauvegardez d’abord le dossier.

Comment vérifier

Redémarrez Hermes avec hermes chat et utilisez le modèle ci-dessous : il devrait n’énumérer que les outils autorisés et le dossier indiqué.

Précautions

N’installez des serveurs MCP que depuis des sources connues : le guide de sécurité de MCP décrit le risque de serveurs locaux compromis.
Gardez la liste d’outils la plus courte possible (minimiser les permissions).

Questions fréquentes

Qu’est-ce qu’un serveur MCP ?

Un petit programme qui donne à une IA l’accès à un outil ou à des données précis, selon le standard ouvert Model Context Protocol. Ici, le serveur de système de fichiers donne accès à un dossier.

Ai-je besoin de Node.js ?

Oui : l’exemple officiel utilise npx, fourni avec Node.js, pour télécharger et lancer le serveur de système de fichiers.

Puis-je donner accès à plusieurs dossiers ?

Oui, en ajoutant d’autres chemins à la liste args. Moins il y en a, mieux c’est.

Sources

Les sources officielles sont liées dans leur langue d’origine.

MCP en Hermes Agent (documentación oficial) — Nous Research (GitHub)
What is the Model Context Protocol? — Model Context Protocol
Security Best Practices (MCP) — Model Context Protocol

Historique des modifications

15 octobre 2026: Publication initiale.

Contenu de vulgarisation, préparé avec l’aide d’outils d’IA, avec sources citées. Il ne remplace pas l’avis d’un professionnel. Les outils évoluent vite : si vous voyez une information dépassée, écrivez-nous à contacto@cognenza.com. Notre façon de travailler.