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.
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
.envydocker-compose.yml.
Configuración
Paso 1 — Monta el recurso compartido y activa File Search
- Monta el recurso compartido en solo lectura en el host de Docker, por ejemplo en
/mnt/knowledge. - Vincúlalo en solo lectura a los contenedores
appyfiles-worker(consulta el comentario endocker-compose.yml) y defineFILE_SOURCE_ROOTS=/mnt/knowledgeen.env. El asistente solo ofrece carpetas situadas bajo esas raíces. - Activa los servicios de File Search: añade a
.envFILES_WORKER_URL=http://files-worker:8891,FILES_WORKER_TOKENyFILE_EXTRACTOR_TOKEN(cada uno conopenssl rand -hex 24) yCOMPOSE_PROFILES=files. - 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.
Paso 2 — Configura el conector de File Search
En AnythingMCP, abre Connectors → New → File Search y elige Network folder (en el Marketplace: Network folder (File Search)).
- Carpeta. Elige la carpeta situada bajo
FILE_SOURCE_ROOTS, por ejemplo/mnt/knowledge/Purchasing. - Prueba. AnythingMCP lista la carpeta antes de guardar nada y muestra si se puede leer.
- 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. - 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.
- 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 muestreYOUR_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" }
}
}
}
- 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. - Guarda el archivo y reinicia Cursor.
- Abre Cursor → Settings → MCP y comprueba que
anythingmcpaparece en la lista y está conectado. - 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
| Herramienta | Qué hace |
|---|---|
<prefix>_guide | Cómo buscar en esta carpeta |
<prefix>_search | Bú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>_find | Encuentra archivos por nombre (tolerante a erratas) o por patrón |
<prefix>_list | Muestra una carpeta: subcarpetas con recuentos, archivos con tamaño y fecha |
<prefix>_read | Lee un archivo como texto, por páginas ("1-3,7") o en ventanas de caracteres |
<prefix>_grep | Bú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>_status | Estado de la sincronización, recuentos, motivo de la pausa y un resumen del contenido |
<prefix>_view_page | Muestra 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_file | El archivo en sí como enlace de descarga temporal para los miembros del workspace (las imágenes también se adjuntan) |
<prefix>_share_file | Un 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ías | Starter | Team | Enterprise | |
|---|---|---|---|---|
| Conectores de File Search | 3 | 1 | 3 | ilimitados |
| Archivos indexados, todos los conectores juntos | 2000 | 500 | 2000 | ilimitados |
| Sincronización automática | diaria | diaria | diaria | hasta cada 5 minutos |
| Sincronizaciones manuales al día | 3 | 1 | 3 | ilimitadas |
| 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
- Busca en el servidor de archivos de tu empresa con IA
- Encuentra precios en listas de precios de proveedores con IA
- Busca dentro de archivos de Nextcloud y WebDAV con IA
- Comparte archivos desde un chat de IA como enlaces de descarga
- Conectar una carpeta de red o un servidor de archivos de Windows a Claude
- Conectar una carpeta de red o un servidor de archivos de Windows a ChatGPT
- Conectar una carpeta de red o un servidor de archivos de Windows a Gemini
- Conectar una carpeta de red o un servidor de archivos de Windows a Microsoft Copilot
- Conectar una carpeta de red o un servidor de archivos de Windows a Muse
- Otras fuentes de archivos en Cursor: servidor SFTP, servidor FTP / FTPS, servidor WebDAV, bucket de S3, Nextcloud, ownCloud, NAS Synology, NAS QNAP, almacenamiento de Fritz!Box, Hetzner Storage Box
¿Te ha sido útil esta guía?