Cómo conectar una Hetzner Storage Box a Cursor

Hetzner Storage Box en Cursor

Respuesta corta: añade la Storage Box a AnythingMCP como un conector File Search mediante SFTP en el puerto 23, idealmente con una subcuenta limitada a una carpeta. 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 necesita y entregarte el archivo en sí, adjunto o como enlace de descarga temporal. Nunca se escribe nada en la Storage Box.

Un asistente de IA no puede abrir una Storage Box por sí solo, y si 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

• El nombre de host de la Storage Box: uXXXXXX.your-storagebox.de.
• Compatibilidad con SSH activada en los ajustes de la Storage Box. SFTP funciona en el puerto 23, no en el 22.
• El usuario principal o, mejor, una subcuenta limitada a una carpeta (Robot → Storage Box → Sub-accounts).
• Un espacio de trabajo de AnythingMCP: AnythingMCP Cloud (7 días gratis) o tu propia instalación autoalojada.

Una subcuenta solo ve su carpeta. Crea una para AnythingMCP y el conector no podrá leer el resto de la Storage Box, marques lo que marques en el asistente.

Configúralo

Paso 1 — Configura el conector File Search

En AnythingMCP, abre el Marketplace y elige Hetzner Storage Box (File Search): se abre el asistente de File Search con SFTP y los ajustes para la Storage Box. (O abre Connectors → New → File Search y usa el acceso directo de Hetzner Storage Box.)

1. Conectar. Introduce uXXXXXX.your-storagebox.de, el puerto 23, la subcuenta y su contraseña, y la carpeta que quieres usar.
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 hay que corregir cuando falla un paso. También muestra la clave de host SSH del servidor como huella digital: confírmala una vez y, a partir de ese momento, 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 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.
4. Describir. AnythingMCP redacta la descripción del conector a partir del escaneo, por ejemplo "Informes exportados y archivo de documentos del equipo de contabilidad, PDF y Excel, 2019–2026". Este texto le dice 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 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: Cursor 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 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 allí 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, son de solo lectura.

Archivos compatibles: el texto se extrae de más de 100 tipos de archivo: PDF (página a 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 (a través de 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 su 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 en el archivo el informe anual de 2024 y resume las cifras de ingresos."
• "¿Qué informes exportados mencionan a Nordtor como proveedor?"
• "Encuentra todas las filas de Excel con el centro de coste 4711."
• "Dame la exportación mensual más reciente como enlace de descarga."

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. 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 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 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.

Seguridad

• Solo lectura. El conector solo lista y lee. No tiene ninguna herramienta que escriba, renombre o elimine en la Storage Box.
• Solo tu espacio de trabajo. El índice se almacena por espacio de trabajo y cada consulta está limitada a él, por la aplicación y 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. Cursor y tus compañeros nunca las ven.
• 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.
• Subcuenta. Al estar limitada a una carpeta, mantiene el resto de la Storage Box fuera de alcance.
• Clave de host fijada. La clave de host SSH de la Storage Box se comprueba en cada conexión.
• AnythingMCP Cloud solo se conecta a servidores de internet pública: un host de una red privada se rechaza, también tras 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 tras la prueba. Todos los planes.

FAQ

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

¿Por qué el puerto 23? Una Storage Box ofrece SFTP en el puerto 23 una vez activada la compatibilidad con SSH en sus ajustes.

¿Usuario principal o subcuenta? Una subcuenta limitada a una carpeta: se puede crear en Robot en Storage Box → Sub-accounts y mantiene a AnythingMCP fuera de todo lo demás que haya en la Storage Box.

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