MCP de sistema de archivos

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\usuario\\Desktop",
        "C:\\Users\\usuario\\Downloads"
      ]
    }
  }
}

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/usuario/Desktop",
        "/Users/usuario/Downloads"
      ]
    }
  }
}

npx -y @modelcontextprotocol/server-filesystem C:\Users\usuario\Desktop

npx -y @modelcontextprotocol/server-filesystem /Users/usuario/Desktop

El MCP de filesystem le da al agente acceso controlado a tus archivos: puede leer, escribir, listar, buscar, mover y renombrar, pero solo dentro de las carpetas que vos listás explícitamente. Es de los servidores más útiles para trabajar con proyectos locales porque convierte al agente en alguien que entiende tu carpeta de trabajo, sin dejarlo suelto por todo el disco.

Cómo conectarlo, paso a paso

1. Verifica que tienes Node.js (node --version); el servidor corre con npx.

2. Abre claude_desktop_config.json desde la pestaña Developer de Claude Desktop. Añade el servidor listando las carpetas permitidas. Reemplaza usuario por tu nombre de usuario real.

En Mac las rutas usan barra normal:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/usuario/Desktop",
        "/Users/usuario/Downloads"
      ]
    }
  }
}

En Windows las rutas usan barra invertida doble (\\):

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\usuario\\Desktop",
        "C:\\Users\\usuario\\Downloads"
      ]
    }
  }
}

3. Guarda y reinicia Claude Desktop por completo.

4. Si algo falla, prueba el servidor a mano en una terminal para ver el error:

npx -y @modelcontextprotocol/server-filesystem /Users/usuario/Desktop

(en Windows, con la ruta C:\Users\usuario\Desktop). Si corre sin errores, la config debería andar tras reiniciar.

Ejemplo real

Una vez conectado, le pides que trabaje con tus carpetas:

Mira la carpeta Downloads, agrupa los PDF por tema y armame una lista con un resumen de cada uno.

Seguridad y errores comunes

• El servidor opera con tus permisos de usuario: dale acceso solo a carpetas con las que estés cómodo, nunca a la raíz del disco ni a carpetas del sistema.
• Cada acción de escritura te pide permiso; revisa antes de aprobar borrados o sobrescrituras.
• En Windows, si las rutas usan una sola barra invertida la config falla: tienen que ir dobles.
• Si el servidor no aparece tras editar la config, casi siempre es porque no reiniciaste Claude Desktop del todo.

Cuándo conviene

Cuando quieres que el agente lea y organice archivos locales, ordene carpetas, busque algo entre muchos documentos o edite archivos de un proyecto, manteniendo el acceso acotado a unas pocas rutas elegidas.