Cómo conectar un servidor SFTP a Cursor

SFTP en Cursor

Respuesta corta: añade el servidor SFTP a AnythingMCP como un conector de File Search. AnythingMCP inicia sesión por SSH con una contraseña o una clave privada, indexa el texto completo de la carpeta que elijas 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í, como adjunto o como enlace de descarga temporal. Nunca se escribe nada en el servidor.

Un asistente de IA no puede abrir por sí solo un servidor SFTP, 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?" se resuelva en segundos.

Qué necesitas

• Una cuenta SSH en el servidor que pueda leer la carpeta, idealmente una que no pueda hacer nada más. Sirven tanto una contraseña como una clave privada.
• El nombre del host y el puerto SSH, normalmente el 22.
• Un workspace de AnythingMCP: AnythingMCP Cloud (7 días gratis) o tu propia instalación autoalojada.

SFTP es el protocolo de transferencia de archivos de SSH, no FTP sobre TLS. Si tu servidor usa FTP o FTPS, utiliza la guía de FTP / FTPS. Una Hetzner Storage Box, un NAS Synology y un NAS QNAP tienen sus propias entradas en el Marketplace con los ajustes adecuados.

Configúralo

Paso 1 — Configura el conector de File Search

En AnythingMCP, abre el Marketplace y elige SFTP (File Search), o abre Connectors → New → File Search y elige SFTP. Un asistente breve te guía; no hay que rellenar ningún formulario largo.

1. Conectar. Introduce el host, el puerto, el nombre de usuario y la contraseña o la clave privada, además de la carpeta que se va a usar, por ejemplo /srv/documents.
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 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 de plan.
4. Describir. AnythingMCP redacta la descripción del conector a partir del escaneo, por ejemplo "Documentos de proyecto del equipo de ingeniería, PDF, Word y Excel, 2021–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 e indica exactamente qué se envía (nombres de carpetas, nombres de archivos, los primeros 2.000 caracteres de hasta 20 archivos de muestra, con los datos personales enmascarados); en caso 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: Cursor y tus demás conectores siguen respondiendo a toda velocidad mientras tanto. La pestaña Files del conector muestra el 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 muestre 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, excepto _share_file, son de solo lectura.

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 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 la carpeta del proyecto la especificación de la serie de bombas K-300 y resume los límites de funcionamiento."
• "¿Qué documentos mencionan el contrato de mantenimiento de Kessler y cuándo se modificaron por última vez?"
• "Encuentra todas las filas de Excel con el número de artículo NT-601 y enumera el archivo y la hoja de cada una."
• "Dame la versión más reciente de la lista de verificación de puesta en marcha 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 salen 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 pudiéndose encontrar por su 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 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 que permite tu plan, Cursor sigue buscando en los archivos ya indexados y se le avisa de que pueden faltar los 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 únicamente lista y lee. No tiene ninguna herramienta que escriba, renombre o elimine en el servidor.
• 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).
• Las credenciales se almacenan cifradas y se descifran únicamente 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 le indican al modelo que nunca siga las instrucciones que encuentre dentro de un archivo.
• Clave de host fijada. La clave de host SSH que confirmaste se comprueba en cada conexión; una clave distinta se rechaza antes de usar la contraseña o la clave.
• Inicio de sesión con clave. Con una clave privada, ni siquiera es necesario que exista una contraseña para la cuenta.
• AnythingMCP Cloud solo se conecta a servidores de internet público: un host en una red privada se rechaza, 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 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 después de 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.

El asistente dice que el servidor presentó una clave de host distinta. El servidor se reinstaló o alguien se ha interpuesto en la conexión. Consulta con el administrador del servidor antes de confirmar la nueva huella digital (panel Files → Edit selection → de vuelta a Test).

¿Contraseña o clave privada? Ambas funcionan. Una clave privada para una cuenta que solo puede leer la carpeta es la configuración más limpia.

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