Configuracions · Nivell intermedi

Configuració: Hermes Agent amb accés MCP a una sola carpeta

Recepta per copiar que connecta Hermes Agent al servidor MCP de sistema de fitxers, limitat a una carpeta i només amb les eines que necessites, explicada línia a línia.

Per Equip editorial de Cognenza · Actualitzada el 15 d’octubre del 2026 · 3 min de lectura · Amb fonts citades

Per a què serveix

MCP és un estàndard obert que el seu web descriu com «un port USB-C per a aplicacions d’IA»: una manera comuna de connectar una IA a eines i dades. Amb aquesta recepta, Hermes Agent pot treballar amb els fitxers d’una sola carpeta i res més.

La recepta

Obre (o crea) el fitxer ~/.hermes/config.yaml i afegeix:

mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/el-teu-usuari/projectes-ia"]
    tools:
      include: ["read_*", "list_*", "search_*"]

Explicació línia a línia

Línia	Què fa
`mcp_servers:`	Obre la llista de servidors MCP que Hermes ha de connectar
`filesystem:`	Nom que tries per a aquest servidor
`command: "npx"`	Programa que arrenca el servidor (ve amb Node.js)
`args: [...]`	Baixa el servidor oficial de fitxers i li indica l’única carpeta permesa
`tools: include:`	Deixa disponibles només les eines el nom de les quals encaixa amb aquests patrons (aquí, de lectura)

Canvia /home/el-teu-usuari/projectes-ia pel camí real de la teva carpeta. A Windows tindrà una forma com C:/Users/el-teu-usuari/projectes-ia.

Quan vulguis que també escrigui

Treu el bloc tools: o fes servir exclude per retirar només el que no vulguis, per exemple:

    tools:
      exclude: ["move_*"]

Abans, fes una còpia de seguretat de la carpeta.

Com comprovar-ho

Reinicia Hermes amb hermes chat i fes servir la plantilla de sota: hauria d’enumerar només les eines permeses i la carpeta indicada.

Precaucions

Instal·la només servidors MCP de fonts conegudes: la guia de seguretat de MCP descriu el risc de servidors locals compromesos.
Mantén la llista d’eines tan curta com sigui possible (minimitzar permisos).

Preguntes freqüents

Què és un servidor MCP?

Un petit programa que dona a una IA accés a una eina o a unes dades concretes, seguint l’estàndard obert Model Context Protocol. Aquí, el de sistema de fitxers dona accés a una carpeta.

Necessito Node.js?

Sí: l’exemple oficial fa servir npx, que ve amb Node.js, per baixar i arrencar el servidor de sistema de fitxers.

Puc donar accés a diverses carpetes?

Sí, afegint més camins a la llista args. Com menys, millor.

Continua llegint

Fonts

Les fonts oficials s’enllacen en la llengua original.

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

Historial de canvis

15 d’octubre del 2026: Publicació inicial.

Contingut divulgatiu, preparat amb l’ajuda d’eines d’IA, amb fonts citades. No substitueix el consell d’un professional. Les eines canvien de pressa: si veus alguna cosa desactualitzada, escriu-nos a contacto@cognenza.com. Com treballem.