Servidor Filesystem MCP: da a un asistente acceso seguro a tus carpetas
Guía del servidor Filesystem MCP y generador de configuración
Servidor Filesystem MCP: herramientas, carpetas permitidas, config | We.Inc
Cómo funciona el servidor Filesystem MCP de referencia: sus 13 herramientas, las carpetas permitidas, Roots, los montajes Docker de solo lectura y un generador que escribe el JSON de configuración por ti.
El servidor Filesystem MCP es el programa Node.js de referencia del proyecto Model Context Protocol que permite a un asistente de IA leer, escribir, buscar y mover archivos, pero solo dentro de las carpetas que autorices. Indicas esas carpetas al iniciarlo, o tu aplicación las proporciona mediante Roots. Todo lo que queda fuera se rechaza.
El servidor Filesystem MCP de un vistazo
- Elemento
- Valor
- Paquete npm
- @modelcontextprotocol/server-filesystem
- Imagen Docker
- mcp/filesystem
- Dónde se ejecuta
- En tu propio ordenador, iniciado por tu aplicación MCP
- Límite de acceso
- Solo carpetas permitidas, por argumentos o Roots
- Herramientas
- 13, de las cuales 9 solo leen
MCP (Model Context Protocol) es un estándar abierto que permite a una aplicación de asistente llamar a pequeños programas auxiliares llamados servidores. El servidor de archivos es el que casi todo el mundo instala primero, porque convierte "mira mi carpeta de descripciones de productos" en algo que el asistente puede hacer de verdad. Esta página explica a qué puede acceder, cómo funciona el límite de carpetas y cómo mantenerlo en solo lectura. Usa el generador de abajo para crear una configuración que puedas pegar en los ajustes MCP de tu aplicación.
- Escribe las carpetas que quieres que vea el asistente, una por línea, con rutas completas.
- Elige npx (necesita Node.js) o Docker. Docker puede montar carpetas en solo lectura.
- Elige el formato de configuración que espera tu aplicación: la mayoría usa mcpServers, VS Code usa servers.
- Copia el JSON en el archivo de configuración MCP de tu aplicación y reiníciala para que arranque el servidor.
- Comparte la carpeta más pequeña que sirva, como una carpeta de contenido, nunca todo tu directorio personal.
- Ejecútalo con Docker y montajes de solo lectura cuando el asistente solo necesite leer.
- Pide al asistente que ejecute list_allowed_directories primero para ver exactamente a qué tiene acceso.
- Usa la opción de prueba (dry run) de edit_file antes de dejar que los cambios lleguen a archivos que te importan.
- Guarda una copia de seguridad o un historial de versiones de todo lo que dejes escribir al asistente.
Preguntas frecuentes
¿Puede el servidor Filesystem MCP leer archivos fuera de las carpetas que indico?
No. El README indica que todas las operaciones de archivos están restringidas a las carpetas permitidas. Si el cliente envía Roots, estas sustituyen por completo a las carpetas de la línea de comandos, así que la lista permitida es la última que proporcionó tu aplicación.
¿Qué pasa si lo inicio sin ninguna carpeta?
Si tu aplicación admite Roots, el servidor espera a que la aplicación las envíe. Si la aplicación no admite Roots y no diste ninguna carpeta, el servidor registra el motivo, cierra la conexión y termina con el estado 1.
¿Cómo lo dejo en solo lectura?
El README documenta una forma: ejecutar la imagen Docker y añadir ro a cada montaje, lo que deja esa carpeta en solo lectura para el servidor. Algunas aplicaciones también permiten aprobar o bloquear herramientas concretas, lo que ayuda, pero el montaje es el límite más firme.
¿Puede borrar archivos?
Su lista de herramientas no incluye ninguna de borrado. Aun así puede destruir contenido: write_file sobrescribe archivos existentes y move_file elimina el origen, por eso ambas aparecen como destructivas en la tabla de anotaciones del README.
¿Necesita acceso a internet?
No para su trabajo. Todas las herramientas fijan openWorldHint en false, es decir, solo tocan el sistema de archivos local dentro de las carpetas permitidas. npx sí descarga el paquete la primera vez que se ejecuta.
Carpetas permitidas y Roots, en palabras sencillas
- Hay dos formas de decirle al servidor qué carpetas puede usar. La primera es poner las rutas de las carpetas después del nombre del paquete en la configuración, lo que fija la lista hasta que reinicies. La segunda es Roots, una función con la que la aplicación del asistente indica al servidor qué carpetas están en juego y puede cambiar esa lista mientras se ejecuta.
- El README considera Roots el método recomendado. El detalle que importa para la seguridad: una vez que las Roots de tu aplicación están activas, una actualización sin raíces válidas revoca todo el acceso en lugar de volver a las carpetas que escribiste.
Tareas útiles para quien tiene un sitio o una tienda
- Apúntalo a una carpeta con datos de productos exportados y pide una lista de artículos sin descripción. Apúntalo a tus borradores del blog y pide un resumen de qué entradas mencionan un precio antiguo. Apúntalo a una copia descargada de tu sitio y busca nombres de imágenes rotos.
- En todos los casos la carpeta es una copia, no el sitio en vivo, así que una edición equivocada no cuesta nada. Ese hábito vale más que cualquier ajuste.
Las 13 herramientas y qué puede cambiar cada una
Solo lectura significa que el README marca la herramienta con readOnlyHint true. Destructiva significa que puede sobrescribir o eliminar contenido existente.
Herramientas del servidor Filesystem MCP
- Herramienta
- Qué hace
- ¿Cambia archivos?
- Lee un archivo como texto UTF-8, opcionalmente solo las primeras o últimas N líneas
- No
- Lee una imagen, un audio u otro archivo como base64 con su tipo MIME
- No
- Lee varios archivos a la vez; un fallo no detiene el resto
- No
- Lista una carpeta con los prefijos [FILE] y [DIR]
- No
- El mismo listado con tamaños, ordenable por nombre o tamaño
- No
- Devuelve un árbol JSON anidado de una carpeta
- No
- Búsqueda tipo glob con patrones de exclusión opcionales
- No
- Tamaño, fechas, tipo y permisos
- No
- Muestra qué carpetas puede usar el servidor
- No
- Crea una carpeta y las carpetas padre que falten
- Sí, no destructiva
- Crea o sobrescribe un archivo
- Sí, destructiva
- Sustituye el texto que coincide, con una opción de vista previa dryRun
- Sí, destructiva
- Mueve o renombra; falla si el destino ya existe
- Sí, destructiva
Ejemplos de configuración
Ejecutar con npx, dos carpetas
Las carpetas después del nombre del paquete pasan a ser las carpetas permitidas. Necesita Node.js en tu equipo.
Ejecutar con Docker, una carpeta en solo lectura
Las carpetas se montan bajo /projects. La marca ro impide que el servidor escriba en esa carpeta.
Configuración del espacio de trabajo de VS Code (.vscode/mcp.json)
VS Code usa la clave servers. ${workspaceFolder} limita el servidor al proyecto que tienes abierto.
Generador de configuración de Filesystem MCP
Escribe tus carpetas y elige cómo ejecutar el servidor. El JSON se actualiza mientras escribes y nada sale de tu navegador.
Carpetas permitidas, una ruta completa por línea
Ejecutar con
Formato de configuración
Montar carpetas en solo lectura (solo Docker)
El montaje de solo lectura está documentado para Docker. Con npx el servidor puede escribir dentro de las carpetas que indiques.
JSON de configuración
npx (Node.js)
Docker
mcpServers (la mayoría de aplicaciones)
servers (VS Code)
Añade al menos una carpeta. El servidor necesita una carpeta permitida para funcionar.
{v} no es una ruta completa. Empiézala con / en Mac o Linux, o con una letra de unidad en Windows.
Empieza gratis · Sin tarjeta de crédito
Relacionado: Guías
- Precios de Firebase
- Ejemplos de reglas de seguridad de Firebase
- Ejemplos de webs de comida y restauración
- Ejemplos de Framer Motion
- Páginas de sedes de franquicia que merecen posicionar
- ¿Puedes conseguir un dominio gratis? Un análisis honesto
- Plantillas Next.js gratis, revisadas
- React vs Vue vs Svelte vs Astro vs Next.js, misma app
Producto
Para quién es
- Para agencias
- Para freelancers
- Para proveedores de hosting
- Para plataformas SaaS
- Para startups
- Servicios financieros
- Soluciones para salud
Funciones
Recursos
- Blog
- Centro de Ayuda
- Herramientas gratuitas para empresas
- Free UI Components
- Plantillas
- Colecciones de plantillas
- Ejemplos de webs
- Guías
- Comparativas
- Alternativas
- Los mejores
- Reseñas
- Guías de precios
- Casos de uso
- Glosario y guías
- Integraciones
- Desarrolladores
- Benchmark
- Windows App