Cómo conectar Nextcloud Files a Gemini

Archivos de Nextcloud en Gemini

Respuesta corta: añade tu Nextcloud a AnythingMCP como un conector File Search, con una contraseña de aplicación mediante WebDAV. AnythingMCP indexa el texto completo de la carpeta que elijas y mantiene el índice sincronizado. 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 tu Nextcloud.

Un asistente de IA no puede abrir tu Nextcloud por sí solo, y uno que pudiera tendría que descargar todos los archivos 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

• La dirección WebDAV de tu Nextcloud: https://YOUR-HOST/remote.php/dav/files/USER/.
• Una contraseña de aplicación de ese usuario (Ajustes → Seguridad → Dispositivos y sesiones), nunca la contraseña de la cuenta. Ponle un nombre, por ejemplo AnythingMCP, para poder revocarla por separado.
• Un usuario que pueda leer las carpetas en las que quieres buscar. AnythingMCP ve exactamente lo que ve ese usuario.
• Un espacio de trabajo de AnythingMCP: AnythingMCP Cloud (7 días gratis) o tu propia instalación autoalojada.

AnythingMCP también tiene un conector de Nextcloud para la API de Nextcloud: usuarios, grupos, recursos compartidos, estado del servidor. No lee lo que hay dentro de tus archivos; eso lo hace File Search. Usa ambos si necesitas ambas cosas. Las ofertas de Nextcloud gestionado, como Hetzner Storage Share, funcionan de la misma manera.

Configúralo

Paso 1 — Configura el conector File Search

En AnythingMCP, abre el Marketplace y elige Nextcloud (File Search): se abre el asistente de File Search con los ajustes para Nextcloud. (O abre Connectors → New → File Search, elige WebDAV y el acceso directo de Nextcloud.)

1. Conectar. Introduce la dirección WebDAV, el nombre de usuario y la contraseña de aplicación, y la carpeta que quieres usar, por ejemplo Documents/Projects.
2. Probar. AnythingMCP se conecta, inicia sesión y lista la carpeta antes de guardar nada, y muestra una lista de comprobación (dirección, accesibilidad, cifrado, identidad del servidor, inicio de sesión, carpeta) con lo que debes corregir cuando un paso falla.
3. Escanear. 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 vienen desmarcadas, de modo que Gemini nunca cita 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. Describir. AnythingMCP redacta la descripción del conector a partir del escaneo, por ejemplo «Carpetas de proyectos del equipo de ventas, ofertas e informes de aceptación, PDF y Word, 2021–2026». Este texto le indica a Gemini 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 y 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 construye a partir de la estructura de carpetas. Edítala como quieras.
5. Activar. 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 otros 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 2 — Copia la URL del servidor

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

Paso 3 — 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://cloud.anythingmcp.com/mcp/…). Úsala allí donde esta guía muestre YOUR_SERVER_ID.

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

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.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 4 — 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 con 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, excepto _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 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 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 oferta que enviamos a Kessler para el tejado del almacén y resume las partidas de precio.»
• «¿Qué carpetas de proyecto contienen un informe de aceptación firmado de este año?»
• «Busca en las actas de reuniones las decisiones sobre el nuevo ERP y enuméralas con sus fechas.»
• «Dame la última versión del manual del empleado como enlace de descarga.»

Cómo funciona la sincronización

Nextcloud informa de un marcador de cambio (ETag) para cada archivo mediante WebDAV. AnythingMCP lo compara con el de la última ejecución y descarga solo 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 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 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 de 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 en el plan.

Seguridad

• Solo lectura. El conector solo lista y lee. No tiene ninguna herramienta que escriba, renombre o elimine nada en tu Nextcloud.
• Solo tu espacio de trabajo. El índice se almacena por espacio de trabajo y cada consulta se limita a él, tanto desde la aplicación como desde la base de datos (Row-Level Security).
• Las credenciales se almacenan cifradas y solo se descifran en el servicio de sincronización en segundo plano. Gemini y tus compañeros nunca las ven.
• 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.
• Contraseña de aplicación. Se puede revocar por separado en Nextcloud, sin cambiar la contraseña de la cuenta.
• Se respetan los recursos compartidos. AnythingMCP ve lo que ve el usuario conectado: comparte con ese usuario solo lo que deba poder buscarse.
• AnythingMCP Cloud solo se conecta a servidores de internet pública: se rechaza un host de una red privada, también después de una redirección. Un servidor de la red de tu oficina debe ser accesible desde el exterior, o bien ejecutas AnythingMCP autoalojado junto a él.

Límites por plan

Autoalojado: Starter incluye un conector File Search con hasta 500 archivos, Team tres conectores con 2.000 archivos, Enterprise no tiene límite y sincroniza hasta cada 5 minutos; el archivo más grande lo define FILES_MAX_FILE_BYTES (100 MB por defecto). File Search autoalojado necesita una licencia de pago o la prueba de 30 días, que tiene los límites de Team; la edición Community gratuita no incluye File Search después de 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é una contraseña de aplicación y no mi contraseña de Nextcloud? Una contraseña de aplicación se puede revocar por separado, sin cambiar la contraseña de la cuenta. Las instrucciones de Nextcloud en AnythingMCP piden una contraseña de aplicación, nunca la contraseña de la cuenta.

¿Cuál es la diferencia con el conector de Nextcloud? El conector de Nextcloud se comunica con la API de Nextcloud: usuarios, grupos, recursos compartidos, estado del servidor. El conector File Search indexa y busca el contenido de tus archivos.

Nuestro Nextcloud solo es accesible desde la red de la oficina. AnythingMCP Cloud necesita que esté en internet mediante HTTPS. Un AnythingMCP autoalojado puede acceder a él una vez que un administrador añade el host a la lista de permitidos de salida (Admin → Settings o SSRF_ALLOWED_HOSTS).

¿AnythingMCP copia todo tu Nextcloud? 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 las 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 Nextcloud Files a Claude
• Conectar Nextcloud Files a ChatGPT
• Conectar Nextcloud Files a Microsoft Copilot
• Conectar Nextcloud Files a Cursor
• Conectar Nextcloud Files a Muse
• Otras fuentes de archivos en Gemini: servidor SFTP, servidor FTP / FTPS, servidor WebDAV, bucket de S3, ownCloud, Synology NAS, QNAP NAS, almacenamiento de Fritz!Box, Hetzner Storage Box, carpeta de red (autoalojada)