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

Carpetas de red en Gemini

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 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 Gemini CLI. Gemini 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 por sí solo una unidad de red, y si pudiera, tendría que descargar todos los archivos para responder a 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 una 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 modo 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.

Configúralo

Paso 1 — Monta el recurso compartido y activa File Search

1. Monta el recurso compartido en modo solo lectura en el host de Docker, por ejemplo en /mnt/knowledge.
2. Enlázalo en modo solo lectura en 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.

Paso 2 — Configura el conector File Search

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 Gemini nunca cite un documento obsoleto. Mientras marcas carpetas, tipos de archivo o un límite de antigüedad, una barra compara tu selección con tu plan; 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 Gemini qué contiene la carpeta y cuándo debe 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); si no, 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: Gemini y tus demás conectores siguen respondiendo a toda velocidad mientras tanto. La pestaña Files del conector muestra su 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 Gemini

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.

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

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu shell): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI 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. Gemini busca primero en el índice, abre las páginas que coinciden y responde indicando el nombre del archivo, la página y la fecha del archivo, para que puedas comprobar la fuente.

Qué puede hacer Gemini con los archivos

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

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 de plantilla, 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 encuentra igualmente 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 Gemini

• «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 desaparecen 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 siendo localizable 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 Gemini: 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, Gemini 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 por sí sola cuando cabe.

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 se limita a él, tanto por la aplicación como, de nuevo, por la base de datos (Row-Level Security).
• El extractor de texto se ejecuta en una red interna sin salida al exterior, sin base de datos y sin secretos.
• Quién ve qué depende de tus roles 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 utilices.
• Solo lectura por partida doble. Monta el recurso compartido en modo solo lectura en el host y enlázalo en modo solo lectura en los contenedores.

Límites por plan

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

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

¿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 File Search con hasta 500 archivos, y Team tres con 2.000. Enterprise elimina los límites y añade OCR, permisos de carpeta por rol y políticas del 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 utiliza 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 Microsoft Copilot
• Conectar una carpeta de red o un servidor de archivos de Windows a Cursor
• Conectar una carpeta de red o un servidor de archivos de Windows a Muse
• Otras fuentes de archivos en Gemini: servidor SFTP, servidor FTP / FTPS, servidor WebDAV, bucket de S3, Nextcloud, ownCloud, Synology NAS, QNAP NAS, almacenamiento de Fritz!Box, Hetzner Storage Box