Cómo conectar Yandex Disk a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Yandex Disk, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Yandex Disk + Gemini

Haz que tu IA trabaje en Yandex Disk: explora carpetas, lista todos los archivos o las subidas recientes, consulta los detalles de un archivo, obtén enlaces de descarga, crea carpetas, copia, mueve, publica o despublica archivos, guarda un archivo desde una URL y restaura desde la Papelera. Con el acceso de tu cuenta de Yandex.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

YANDEX_DISK_CLIENT_ID, YANDEX_DISK_CLIENT_SECRET

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas la cuenta de Yandex con cuyo Disk debe trabajar la IA y una app registrada para ella en Yandex OAuth.

1. Inicia sesión con esa cuenta de Yandex, abre oauth.yandex.ru/client/new (o oauth.yandex.com) y crea una app.
2. Como plataforma, elige Web services. Como Redirect URI, introduce https://cloud.anythingmcp.com/api/mcp-oauth/callback. Si alojas AnythingMCP tú mismo, introduce en su lugar https://tu-host-anythingmcp/api/mcp-oauth/callback.
3. En el acceso a datos, añade los permisos de la Yandex Disk REST API cloud_api:disk.read (leer todo el Disk), cloud_api:disk.write (escribir en cualquier parte del Disk) y cloud_api:disk.info (información del Disk). No elijas solo cloud_api:disk.app_folder: limita la app a su propia carpeta.
4. Crea la app, copia el ClientID en YANDEX_DISK_CLIENT_ID y el Client secret en YANDEX_DISK_CLIENT_SECRET, e instala el conector.
5. En la página del conector, pulsa Authorize with Provider, elige la cuenta de Yandex y permite el acceso.
6. Empieza con yandex_disk_get_disk_info: muestra a qué Disk está conectado el conector, cuánto espacio está ocupado y cuánto ocupa la Papelera.

Permisos y solo lectura: Yandex concede exactamente los permisos que marcaste en la app en el paso 3. Para un uso de solo lectura, registra la app solo con cloud_api:disk.read y cloud_api:disk.info y desactiva yandex_disk_create_folder, yandex_disk_copy, yandex_disk_move, yandex_disk_publish, yandex_disk_unpublish, yandex_disk_upload_from_url y yandex_disk_restore_from_trash.

Inicio de sesión: un token de Yandex dura alrededor de un año y viene con un refresh token, que AnythingMCP usa para renovarlo. Ambos se guardan cifrados. Si revocas la app en id.yandex.ru/security o cambias sus permisos, pulsa de nuevo Authorize with Provider.

Rutas: archivos y carpetas se indican como disk:/carpeta/archivo.txt, la raíz es disk:/ y las entradas de la Papelera son trash:/.... Puedes nombrar sin más una carpeta o un archivo; la IA usa los nombres exactos, con la extensión.

Los cambios esperan tu sí: crear carpetas, copiar, mover o renombrar, publicar y despublicar, guardar un archivo desde una URL y restaurar desde la Papelera cambian tu Disk. La IA dice qué va a pasar y espera tu confirmación, y solo sobrescribe un archivo existente si estás de acuerdo. yandex_disk_publish hace que cualquiera con el enlace pueda abrir un archivo o una carpeta; yandex_disk_unpublish desactiva el enlace, y volver a publicar crea uno nuevo.

Desactivada al instalar: yandex_disk_delete. Cuando un administrador la activa, mueve los elementos a la Papelera, desde donde yandex_disk_restore_from_trash los recupera. Solo borra para siempre si lo pides de forma explícita.

Sin búsqueda: la API de Yandex Disk no busca por nombre ni por contenido. Para encontrar un archivo, la IA lista la carpeta con yandex_disk_list_folder, recorre todos los archivos con yandex_disk_list_files (si quieres, solo imágenes, documentos, etc.) y compara los nombres, o revisa las últimas subidas con yandex_disk_list_last_uploaded.

Contenido de los archivos: el conector no lee ni sube el contenido de los archivos. yandex_disk_get_download_link devuelve un enlace temporal que puedes abrir (una carpeta se descarga como zip), y yandex_disk_upload_from_url guarda un archivo que ya está en internet. yandex_disk_get_public_resource lee cualquier enlace público de Yandex Disk, tuyo o de otra persona.

Operaciones en segundo plano: copiar, mover, restaurar o borrar carpetas grandes, y cada subida desde una URL, se ejecutan en segundo plano en Yandex. La IA sigue el progreso con yandex_disk_get_operation_status hasta que la operación termina.

Errores habituales: 401 UnauthorizedError significa que falta el inicio de sesión, se revocó o caducó; vuelve a autorizar. 403: a la app le falta un permiso del paso 3 (por ejemplo cloud_api:disk.write para un cambio), el Disk superó su cuota o está en modo de solo lectura. 404: la ruta no existe; revisa la ortografía, la extensión y el prefijo disk:/. 409: el destino ya existe o falta su carpeta superior. 423: el elemento está bloqueado por otra operación o las subidas están en pausa; inténtalo más tarde. 507: no queda espacio libre suficiente en el Disk. 429: demasiadas peticiones; espera y vuelve a intentarlo.

El conector no lee ni sube el contenido de los archivos, no edita propiedades personalizadas, no vacía la Papelera, no comparte carpetas con personas concretas y no cambia la configuración de administración de Yandex 360.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra 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 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 terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Yandex Disk.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuánto espacio me queda en Yandex Disk y cuánto ocupa la Papelera?"
• "¿Qué fotos subí la semana pasada y en qué carpetas están?"
• "Crea en mi Disk la carpeta Clientes/Acme y mueve allí el PDF del contrato de Acme que está en Downloads."
• "Crea un enlace público para Presentaciones/Pitch.pdf y dámelo, y luego lista todo lo demás que tengo compartido públicamente."

FAQ

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

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT