Cómo conectar un NAS QNAP a Cursor

NAS QNAP en Cursor

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 File Search. AnythingMCP indexa el texto completo de esa carpeta y mantiene el índice sincronizado. Después, conecta AnythingMCP a Cursor. Cursor puede encontrar archivos por nombre y por contenido, leer las páginas que necesite y entregarte el propio archivo, 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 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 responda en segundos.

Qué necesitas

• SFTP permitido (Control Panel → Network & File Services → Telnet/SSH → Allow 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 desde la red local.
• Un workspace de AnythingMCP: AnythingMCP Cloud (7 días gratis) o tu propia instalación autoalojada.

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

Configúralo

Paso 1 — Configura el conector 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 Connectors → New → 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 distinta 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 Cursor 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 tu 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 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 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); si no, 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: Cursor 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 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 Cursor

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 en todos los lugares donde esta guía muestra YOUR_SERVER_ID.

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

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 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 4 — 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

<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 (a través de 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 pueden mostrarse 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 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 salen del índice. Un archivo que no se puede leer se reintenta en las siguientes sincronizaciones y, tras tres fallos (de inmediato en los archivos protegidos con contraseña), sigue siendo localizable 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 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 de tu plan, Cursor sigue buscando en los archivos ya indexados y recibe el aviso de que pueden faltar archivos más recientes, y puedes desmarcar carpetas o mejorar tu plan. Una carpeta en pausa se vuelve a comprobar una vez al día y se reanuda 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 workspace. El índice se almacena por workspace y cada consulta se limita a él, tanto por la aplicación como 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. Cursor 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 solo para AnythingMCP Cloud.
• AnythingMCP Cloud solo se conecta a servidores de internet público: un host en una red privada es rechazado, 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 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 se define con 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

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

¿SFTP o WebDAV en el QNAP? Ambos funcionan. SFTP se permite en Control Panel → Network & File Services → 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 guarda el texto extraído, no los archivos. Un archivo solo se vuelve a leer cuando ha cambiado o cuando pides el propio archivo.

¿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 en archivos de Nextcloud y WebDAV con IA
• Comparte archivos desde un chat de IA como enlaces de descarga
• Conecta un NAS QNAP a Claude
• Conecta un NAS QNAP a ChatGPT
• Conecta un NAS QNAP a Gemini
• Conecta un NAS QNAP a Microsoft Copilot
• Conecta un NAS QNAP a Muse
• Otras fuentes de archivos en Cursor: 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)