Guía de conector11 minutos de lectura10 herramientas MCP7 idiomas

Cómo conectar una carpeta de red o un servidor de archivos de Windows a Cursor

Permite que Cursor busque dentro de un servidor de archivos de Windows, un NAS o un recurso compartido de red (SMB/CIFS o NFS) montado en un AnythingMCP autoalojado: índice de texto completo de archivos PDF, Excel, Word y Outlook, sincronizado en segundo plano. Solo autoalojado.

HCPor el equipo de HelpCodeActualizado 11 min de lectura Código abierto en GitHub

Open source · AGPL-3.0 · se ejecuta en tu propio servidor

Network folder (File Search)

Network folder (File Search)

Search inside a Windows file server, NAS or network share mounted into a self-hosted AnythingMCP: full-text index of PDF, Excel, Word and Outlook files, synced in the background. Self-hosted only.

herramientas

10

Región

INTL

Categoría

Almacenamiento de archivos

Autenticación

Local server

Self-host con Docker

Open source · AGPL-3.0 · se ejecuta en tu propio servidor

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

Resumen

Permite que Cursor busque dentro de un servidor de archivos de Windows, un NAS o un recurso compartido de red (SMB/CIFS o NFS) montado en un AnythingMCP autoalojado: índice de texto completo de archivos PDF, Excel, Word y Outlook, sincronizado en segundo plano. Solo autoalojado.

Prueba a pedir

Prompts de ejemplo para Network folder (File Search)

Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.

Network folder (File Search) · live vía MCP
Compartir
Opus 4.7

Claude es IA y puede equivocarse. Verifica siempre las respuestas.

Carpetas de red en Cursor

Solo autoalojado. La carpeta de red existe únicamente en un AnythingMCP autoalojado. En AnythingMCP Cloud, accede a un NAS mediante SFTP o WebDAV.

Respuesta corta: monta el recurso compartido en modo solo lectura en el servidor que ejecuta tu AnythingMCP autoalojado y añade la carpeta como un conector de File Search. AnythingMCP indexa el texto completo de cada archivo compatible y mantiene el índice sincronizado, y los archivos nunca salen de tu red. Después, conecta AnythingMCP a Cursor. Cursor puede encontrar archivos por nombre y por contenido, leer las páginas que necesita y entregarte el archivo en sí, adjunto o como enlace de descarga temporal. Nunca se escribe nada en el recurso compartido.

Un asistente de IA no puede abrir una unidad de red por sí solo, y uno que pudiera tendría que descargar cada archivo para responder una sola pregunta. El índice es lo que hace que una pregunta como «¿cuánto cuesta el artículo NT-601 en la lista de precios actual?» se resuelva en segundos.

Qué necesitas

  • Un AnythingMCP autoalojado con licencia de pago o la prueba de 30 días. AnythingMCP Cloud no puede acceder a un recurso compartido de red: SMB (puerto 445) no debe exponerse a internet.
  • El recurso compartido montado en solo lectura en el host de Docker, por ejemplo en /mnt/knowledge (SMB/CIFS o NFS, un servidor de archivos de Windows o un volumen de NAS).
  • Acceso por shell al host de Docker para editar .env y docker-compose.yml.

Configuración

  1. Monta el recurso compartido en solo lectura en el host de Docker, por ejemplo en /mnt/knowledge.
  2. Vincúlalo en solo lectura a los contenedores app y files-worker (consulta el comentario en docker-compose.yml) y define FILE_SOURCE_ROOTS=/mnt/knowledge en .env. El asistente solo ofrece carpetas situadas bajo esas raíces.
  3. Activa los servicios de File Search: añade a .env FILES_WORKER_URL=http://files-worker:8891, FILES_WORKER_TOKEN y FILE_EXTRACTOR_TOKEN (cada uno con openssl rand -hex 24) y COMPOSE_PROFILES=files.
  4. Ejecuta docker compose up -d. Connectors → New → File Search muestra si el worker y el extractor son accesibles.

La documentación de File Search enumera todos los ajustes.

En AnythingMCP, abre Connectors → New → File Search y elige Network folder (en el Marketplace: Network folder (File Search)).

  1. Carpeta. Elige la carpeta situada bajo FILE_SOURCE_ROOTS, por ejemplo /mnt/knowledge/Purchasing.
  2. Prueba. AnythingMCP lista la carpeta antes de guardar nada y muestra si se puede leer.
  3. Escaneo. Haz clic en Scan folder. AnythingMCP lista la carpeta sin indexarla todavía y muestra un árbol con el número de archivos de cada subcarpeta, los tipos de archivo y los años. Las carpetas que parecen archivos históricos (Alt, Old, Archive, Backup) ya aparecen desmarcadas, de modo que Cursor nunca cite un documento obsoleto. Una barra compara tu selección con tu plan mientras marcas carpetas, tipos de archivo o un límite de antigüedad; cuando la selección supera el plan, desmarca más elementos o mejora de plan.
  4. Descripción. AnythingMCP redacta la descripción del conector a partir del escaneo, por ejemplo «Recurso de Compras: listas de precios y condiciones de proveedores, PDF y Excel, alemán, 2019–2026». Este texto le indica a Cursor qué contiene la carpeta y cuándo buscar en ella. Si hay un modelo de IA configurado en el servidor, el asistente puede redactarla con IA e indica exactamente qué se envía (nombres de carpetas, nombres de archivos, los primeros 2000 caracteres de hasta 20 archivos de muestra, con los datos personales enmascarados); en caso contrario, el borrador se genera a partir de la estructura de carpetas. Edítala como quieras.
  5. Activación. Elige el prefijo de las herramientas, el intervalo de sincronización y los servidores MCP que recibirán el conector, y haz clic en Activate.

La primera sincronización empieza de inmediato y se ejecuta en un servicio independiente en segundo plano: Cursor y tus otros conectores siguen respondiendo a toda velocidad mientras tanto. La pestaña Files del conector muestra el progreso: archivos encontrados, indexados y omitidos, la última y la próxima sincronización, y un botón Sync now.

Paso 3 — Copia la URL del servidor

En MCP Servers, abre el servidor que elegiste en el asistente y copia su URL.

Paso 4 — Añade el conector en Cursor

La URL de tu servidor: en AnythingMCP, abre MCP Servers → el servidor en el que está este conector y copia su URL (https://anythingmcp.example.com/mcp/… con tu propia dirección). Úsala donde esta guía muestre YOUR_SERVER_ID.

Cursor se ejecuta en tu ordenador, por lo que también puede acceder a un AnythingMCP situado en tu propia red. Usa la dirección de tu instancia donde este paso muestre https://anythingmcp.example.com.

Cursor lee los servidores MCP desde ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://anythingmcp.example.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Crea una clave de API de MCP en AnythingMCP, en MCP Servers → tu servidor → API keys, y pégala en lugar de YOUR_MCP_API_KEY.
  2. Guarda el archivo y reinicia Cursor.
  3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
  4. Empieza a chatear: el agente ya puede llamar a las herramientas de búsqueda de archivos.

Paso 5 — Pregunta

Inicia un chat nuevo y pregunta por el contenido de tus archivos. Cursor busca primero en el índice, abre las páginas que coinciden y responde con el nombre del archivo, la página y la fecha del archivo, para que puedas comprobar la fuente.

Qué puede hacer Cursor con los archivos

HerramientaQué hace
<prefix>_guideCómo buscar en esta carpeta
<prefix>_searchBúsqueda de texto completo en todas las páginas indexadas: los archivos con su mejor página, un fragmento y la fecha; filtros por carpeta, tipo de archivo y fechas, los más recientes primero si se solicita
<prefix>_findEncuentra archivos por nombre (tolerante a erratas) o por patrón
<prefix>_listMuestra una carpeta: subcarpetas con recuentos, archivos con tamaño y fecha
<prefix>_readLee un archivo como texto, por páginas ("1-3,7") o en ventanas de caracteres
<prefix>_grepBúsqueda exacta de códigos y números con dos líneas de contexto; las filas de las hojas de cálculo incluyen los nombres de sus columnas
<prefix>_statusEstado de la sincronización, recuentos, motivo de la pausa y un resumen del contenido
<prefix>_view_pageMuestra como imagen una página de un PDF, o un archivo de imagen: planos, sellos, fotos y tablas que el texto no recoge
<prefix>_get_fileEl archivo en sí como enlace de descarga temporal para los miembros del workspace (las imágenes también se adjuntan)
<prefix>_share_fileUn enlace temporal (interno o público); desactivada en la instalación

<prefix> es el prefijo de las herramientas que eliges en el asistente, por ejemplo pricelists. Todas las herramientas, excepto _share_file, son de solo lectura.

Archivos compatibles: se extrae texto de más de 100 tipos de archivo: PDF (página por página); Word, Excel y PowerPoint, incluidas las variantes con macros y plantillas y .xlsb; OpenDocument; Outlook .msg, .eml y .mbox con el texto de sus adjuntos; .rtf, .epub, .xps; Apple Pages, Numbers y Keynote (mediante su vista previa en PDF); .svg y el texto de los dibujos CAD .dxf; CSV, Markdown, HTML, XML, JSON, YAML, calendarios y contactos; y código fuente. Cualquier otro archivo se sigue encontrando por nombre, y las páginas de PDF y las imágenes se pueden mostrar a la IA como imágenes. Los PDF escaneados sin capa de texto se leen con OCR en Enterprise.

Prompts para probar en Cursor

  • «Busca la lista de precios actual de Nordtor y dime el precio de NT-601 875 x 2000.»
  • «¿Qué documentos del recurso compartido mencionan un plazo de preaviso de tres meses?»
  • «Busca en la carpeta Purchasing el número de artículo 4711-200 y muestra todas las filas en las que aparece.»
  • «¿Qué dice nuestro procedimiento interno sobre las devoluciones de más de 30 días? Cita el párrafo y el archivo.»

Cómo funciona la sincronización

AnythingMCP compara el tamaño y la fecha de modificación de cada archivo con la última ejecución y lee únicamente los archivos nuevos y modificados. Los archivos cuyo contenido es idéntico a la versión indexada se reconocen por su suma de verificación (SHA-256) y no se vuelven a procesar. Los archivos eliminados salen del índice. Un archivo que no se puede leer se reintenta en las siguientes sincronizaciones y, tras tres fallos (de inmediato en el caso de archivos protegidos con contraseña), sigue pudiendo encontrarse por nombre, con el motivo indicado en la pestaña Files.

La sincronización se ejecuta en su propio servicio en segundo plano, separado del servidor que responde a Cursor: una primera sincronización grande no ralentiza tus preguntas, y la búsqueda sigue funcionando con el último índice mientras se sincroniza.

Cuando la carpeta supera tu plan, la sincronización se pausa antes de descargar nada, en lugar de indexar solo una parte: la pestaña Files muestra cuántos archivos contiene ahora la carpeta frente a los que permite tu plan, Cursor sigue buscando en los archivos ya indexados y se le avisa de que pueden faltar archivos más recientes, y tú puedes desmarcar carpetas o mejorar de plan. Una carpeta en pausa se vuelve a comprobar una vez al día y se reanuda sola cuando cabe en el plan.

Seguridad

  • Solo lectura. El conector únicamente lista y lee. No tiene ninguna herramienta que escriba, renombre o elimine en el recurso compartido.
  • Solo tu workspace. El índice se almacena por workspace y cada consulta está limitada a él, tanto por la aplicación como por la base de datos (Row-Level Security).
  • El extractor de texto se ejecuta en una red interna sin ruta de salida, sin base de datos y sin secretos.
  • Quién ve qué depende de tus roles de MCP: un rol sin las herramientas de archivos no las ve. En Enterprise también puedes permitir o denegar carpetas por rol.
  • El contenido de los archivos son datos. Las herramientas indican al modelo que nunca siga instrucciones que encuentre dentro de un archivo.
  • Los archivos permanecen en tu red. Solo lo que una herramienta devuelve para una pregunta (una lista de coincidencias, el texto de una página) viaja al proveedor de IA que uses.
  • Solo lectura por partida doble. Monta el recurso compartido en solo lectura en el host y vincúlalo en solo lectura a los contenedores.

Límites por plan

Prueba de 30 díasStarterTeamEnterprise
Conectores de File Search313ilimitados
Archivos indexados, todos los conectores juntos20005002000ilimitados
Sincronización automáticadiariadiariadiariahasta cada 5 minutos
Sincronizaciones manuales al día313ilimitadas
OCR, permisos de carpeta por rol, política del workspace–––✓

El tamaño máximo de archivo se define con FILES_MAX_FILE_BYTES (100 MB por defecto). File Search requiere una licencia de pago (Starter, Team o Enterprise) o la prueba de 30 días; la edición Community gratuita no incluye File Search una vez terminada la prueba. Todos los planes.

Preguntas frecuentes

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

¿Por qué no está disponible en AnythingMCP Cloud? Cloud accede a los archivos a través de internet, y SMB (puerto 445) no debe exponerse a internet. Usa SFTP o WebDAV en el NAS para Cloud, o ejecuta AnythingMCP autoalojado junto al recurso compartido.

¿Requiere el plan Enterprise autoalojado? No. Starter incluye un conector de File Search con hasta 500 archivos, y Team tres con 2000. Enterprise elimina los límites y añade OCR, permisos de carpeta por rol y políticas de workspace.

¿AnythingMCP copia todo el recurso compartido? No. AnythingMCP conserva el texto extraído, no los archivos. Un archivo solo se vuelve a leer cuando ha cambiado o cuando pides el archivo en sí.

¿Se usa búsqueda vectorial? No. En los documentos de empresa se buscan nombres, códigos y números exactos, y ahí la búsqueda por palabras clave con resultados a nivel de página es más fiable que los embeddings.

Relacionado

¿Te ha sido útil esta guía?

Tu agente de Network folder está a un clic.

Instala el conector, pega la clave y pregunta a Cursor. 7 días gratis, sin tarjeta de crédito.

Guías relacionadas

Empresa

Permisos de carpetas por rol para la búsqueda de archivos con IA: quién ve qué carpetas en Claude y ChatGPT

Ofrece a ventas, compras y servicio una única búsqueda de archivos con IA sobre el recurso compartido de la empresa, y deja que cada rol vea solo sus carpetas. Cómo funcionan los permisos de carpetas de AnythingMCP Enterprise (permitir, denegar, denegar prevalece), cómo planificar las reglas y la alternativa sin Enterprise.

Conectores

Cómo conectar una carpeta de red o un servidor de archivos de Windows a ChatGPT

Permite que ChatGPT busque dentro de un servidor de archivos de Windows, un NAS o un recurso compartido de red (SMB/CIFS o NFS) montado en un AnythingMCP autoalojado: índice de texto completo de archivos PDF, Excel, Word y Outlook, sincronizado en segundo plano. Solo autoalojado.

Conectores

Cómo conectar una carpeta de red o un servidor de archivos de Windows a Claude

Permite que Claude busque dentro de un servidor de archivos de Windows, un NAS o un recurso compartido de red (SMB/CIFS o NFS) montado en un AnythingMCP autoalojado: índice de texto completo de archivos PDF, Excel, Word y Outlook, sincronizado en segundo plano. Solo autoalojado.

Conectores

Cómo conectar una carpeta de red o un servidor de archivos de Windows a Microsoft Copilot

Permite que Microsoft Copilot busque dentro de un servidor de archivos de Windows, un NAS o un recurso compartido de red (SMB/CIFS o NFS) montado en un AnythingMCP autoalojado: índice de texto completo de archivos PDF, Excel, Word y Outlook, sincronizado en segundo plano. Solo autoalojado.

Conectores

Cómo conectar una carpeta de red o un servidor de archivos de Windows a Gemini

Permite que Gemini busque dentro de un servidor de archivos de Windows, un NAS o un recurso compartido de red (SMB/CIFS o NFS) montado en un AnythingMCP autoalojado: índice de texto completo de archivos PDF, Excel, Word y Outlook, sincronizado en segundo plano. Solo autoalojado.

Conectores

Cómo conectar una carpeta de red o un servidor de archivos de Windows a Muse

Deja que Muse busque dentro de un servidor de archivos de Windows, un NAS o un recurso compartido de red (SMB/CIFS o NFS) montado en un AnythingMCP autoalojado: índice de texto completo de archivos PDF, Excel, Word y Outlook, sincronizado en segundo plano. Solo autoalojado.