Configurazioni · Livello intermedio

Configurazione: Hermes Agent con accesso MCP a una sola cartella

Ricetta da copiare per collegare Hermes Agent al server MCP del file system, limitato a una cartella e ai soli strumenti necessari, spiegata riga per riga.

Di Redazione di Cognenza · Aggiornata il 15 ottobre 2026 · 3 min di lettura · Con fonti citate

A cosa serve

MCP è uno standard aperto che il suo sito descrive come «una porta USB-C per le applicazioni di IA»: un modo comune per collegare un’IA a strumenti e dati. Con questa ricetta, Hermes Agent può lavorare con i file di una sola cartella e nient’altro.

La ricetta

Apri (o crea) il file ~/.hermes/config.yaml e aggiungi:

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

Spiegazione riga per riga

Riga	Cosa fa
`mcp_servers:`	Apre l’elenco dei server MCP che Hermes deve collegare
`filesystem:`	Nome che scegli per questo server
`command: "npx"`	Programma che avvia il server (incluso in Node.js)
`args: [...]`	Scarica il server ufficiale dei file e gli indica l’unica cartella consentita
`tools: include:`	Lascia disponibili solo gli strumenti il cui nome corrisponde a questi schemi (qui, di lettura)

Sostituisci /home/tuo-utente/progetti-ia con il percorso reale della tua cartella. Su Windows avrà una forma come C:/Users/tuo-utente/progetti-ia.

Quando vuoi che scriva anche

Togli il blocco tools: oppure usa exclude per rimuovere solo ciò che non vuoi, per esempio:

    tools:
      exclude: ["move_*"]

Prima fai un backup della cartella.

Come verificarlo

Riavvia Hermes con hermes chat e usa il modello qui sotto: dovrebbe elencare solo gli strumenti consentiti e la cartella indicata.

Precauzioni

Installa server MCP solo da fonti note: la guida alla sicurezza di MCP descrive il rischio di server locali compromessi.
Tieni l’elenco degli strumenti il più corto possibile (ridurre al minimo i permessi).

Domande frequenti

Cos’è un server MCP?

Un piccolo programma che dà a un’IA accesso a uno strumento o a dati specifici, secondo lo standard aperto Model Context Protocol. Qui, quello del file system dà accesso a una cartella.

Mi serve Node.js?

Sì: l’esempio ufficiale usa npx, incluso in Node.js, per scaricare e avviare il server del file system.

Posso dare accesso a più cartelle?

Sì, aggiungendo altri percorsi alla lista args. Meno sono, meglio è.

Continua a leggere

Fonti

Le fonti ufficiali sono collegate nella lingua originale.

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

Cronologia delle modifiche

15 ottobre 2026: Prima pubblicazione.

Contenuto divulgativo, preparato con l’aiuto di strumenti di IA, con fonti citate. Non sostituisce il parere di un professionista. Gli strumenti cambiano in fretta: se trovi qualcosa di superato, scrivici a contacto@cognenza.com. Come lavoriamo.