Cómo conectar un NAS QNAP a Gemini

QNAP NAS en Gemini

Respuesta corta: permite SFTP en el NAS, crea un usuario que solo pueda leer la carpeta compartida y añade el NAS a AnythingMCP como un conector de File Search. AnythingMCP indexa el texto completo de esa carpeta 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 necesite y entregarte el archivo en sí, adjunto o como enlace de descarga temporal. Nunca se escribe nada en el NAS.

Un asistente de IA no puede abrir un NAS por sí solo, y si 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?» tarde solo unos segundos.

Qué necesitas

• SFTP permitido (Panel de control → Servicios de red y archivos → Telnet/SSH → Permitir SFTP), o WebDAV activado si prefieres WebDAV.
• Un usuario de QNAP con acceso de solo lectura a la carpeta compartida.
• Para AnythingMCP Cloud: el NAS accesible desde internet, con el puerto redirigido en tu router. Un AnythingMCP autoalojado puede acceder a él en la red local.
• Un espacio de trabajo de AnythingMCP: AnythingMCP Cloud (7 días gratis) o tu propia instalación autoalojada.

Esto funciona con QTS y QuTS hero. SMB (puerto 445) no es accesible desde Cloud: no debe exponerse a internet. Usa SFTP o WebDAV, o un AnythingMCP autoalojado.

Configúralo

Paso 1 — Configura el conector de File Search

En AnythingMCP, abre el Marketplace y elige QNAP NAS (File Search): se abre el asistente de File Search con SFTP y los ajustes para QNAP. (O abre Conectores → Nuevo → File Search y usa el acceso directo de QNAP.)

1. Conectar. Introduce la dirección del NAS (desde fuera: la dirección que redirige tu router), el puerto, el usuario de solo lectura con su contraseña y la carpeta compartida.
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 falla un paso. También muestra la clave de host SSH del servidor como una huella digital: confírmala una vez y, a partir de entonces, AnythingMCP rechaza una clave diferente antes de enviar la contraseña, lo que te protege de un servidor que se hace pasar por el tuyo.
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 el plan.
4. Describir. AnythingMCP redacta la descripción del conector a partir del escaneo, por ejemplo «Carpeta compartida Engineering: listas de planos, fichas técnicas e informes de pruebas, PDF y Excel, 2019–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 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); de lo contrario, el borrador se genera 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 donde esta guía muestre YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP desde ~/.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, 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 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 planos 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 Gemini

• «Busca en la carpeta Engineering la ficha técnica de la serie de bombas K-300.»
• «¿Qué informes de pruebas mencionan el modelo de puerta Nordtor NT-601?»
• «Encuentra todas las filas de Excel con el número de artículo 4711-200.»
• «¿Qué hay en el archivo más reciente de la carpeta Orders?»

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 descarga solo los archivos nuevos y modificados. Con WebDAV usa el ETag en su lugar. 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 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 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 el 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 solo lista y lee. No tiene ninguna herramienta que escriba, renombre o elimine en el NAS.
• Solo tu espacio de trabajo. El índice se almacena por espacio de trabajo y cada consulta se limita a él, tanto por la aplicación como, de nuevo, por 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.
• Usuario de solo lectura. Da al usuario de QNAP acceso de lectura a la única carpeta compartida y a nada más.
• Clave de host fijada. La clave de host SSH del NAS se comprueba en cada conexión.
• Redirección de puertos. Redirige solo el puerto que uses, y únicamente para AnythingMCP Cloud.
• AnythingMCP Cloud solo se conecta a servidores de internet pública: un host en una red privada se rechaza, también tras una redirección. Un servidor de la red de tu oficina debe ser accesible desde fuera, o bien ejecutas AnythingMCP autoalojado junto a él.

Límites por plan

Autoalojado: Starter incluye un conector de 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 requiere 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 tras 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.

¿SFTP o WebDAV en el QNAP? Ambos funcionan. SFTP se permite en Panel de control → Servicios de red y archivos → Telnet/SSH. La entrada del Marketplace abre el asistente con SFTP.

¿Tengo que abrir el NAS a internet? Para AnythingMCP Cloud, sí: redirige el puerto. Un AnythingMCP autoalojado en la misma red accede al NAS sin redirección de puertos.

¿AnythingMCP copia todo el NAS? 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 en archivos de Nextcloud y WebDAV con IA
• Comparte archivos desde un chat de IA como enlaces de descarga
• Conectar un NAS QNAP a Claude
• Conectar un NAS QNAP a ChatGPT
• Conectar un NAS QNAP a Microsoft Copilot
• Conectar un NAS QNAP a Cursor
• Conectar un NAS QNAP a Muse
• Otras fuentes de archivos en Gemini: servidor SFTP, servidor FTP / FTPS, servidor WebDAV, bucket de S3, Nextcloud, ownCloud, NAS Synology, almacenamiento de Fritz!Box, Hetzner Storage Box, Carpeta de red (autoalojado)