Yandex Disk a MCP: trabaja en Yandex Disk desde cualquier agente IA

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

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.

Configuración

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.

Requisitos previos: YANDEX_DISK_CLIENT_ID, YANDEX_DISK_CLIENT_SECRET

Instalar el conector localmente

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

Abre http://localhost:3000/connectors/store, elige Yandex Disk e introduce las variables listadas en los Requisitos previos.

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

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT