Cómo conectar un servidor SFTP a Gemini

SFTP en Gemini

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 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. No se escribe nada en el servidor.

Un asistente de IA no puede abrir por sí solo un servidor SFTP, 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

• 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 espacio de trabajo 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, consulta la guía de FTP / FTPS. Un 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 breve asistente te guía; no hay que rellenar ningún formulario largo.

1. Conectar. Introduce host, puerto, 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 hay que 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 ese momento, AnythingMCP rechaza una clave distinta antes de enviar la contraseña, lo que te protege de un servidor que se haga 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, así 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 un borrador de 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 Gemini qué contiene la carpeta y cuándo buscar en ella. Si hay un modelo de IA configurado en el servidor, el asistente puede redactarlo 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); si no, el borrador se construye a partir de la estructura de carpetas. Edítalo 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 en segundo plano independiente: Gemini 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 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, 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 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 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 Gemini

• «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 comprobació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 los 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 los archivos protegidos con contraseña), sigue siendo localizable 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 lo que permite 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 únicamente lista y lee. No tiene ninguna herramienta que escriba, cambie el nombre o elimine en el servidor.
• 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 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 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ú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 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 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.

El asistente dice que el servidor presentó una clave de host distinta. El servidor se reinstaló, o hay alguien en medio. Consúltalo 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 sirven. 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 Microsoft Copilot
• Conectar un servidor SFTP a Cursor
• Conectar un servidor SFTP a Muse
• Otras fuentes de archivos en Gemini: 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)