Configurar el servidor MCP de Yandex Disk en Claude Code
Conecta un agente a la CLI de Yandex Disk por MCP, mira qué se le ofrece y mantén tuyas sus escrituras.
MCP y skills →Qué aporta MCP, cómo conectar tu cliente y cómo leer esta documentación.Dale a tu agente de IA tu Yandex Disk, para que encuentre un documento, lo cite y archive tus ficheros cuando se lo
pidas. Un agente con terminal ejecuta ydisk por sí mismo después de que instales el skill de la herramienta. Una
aplicación sin terminal, como Claude Desktop o Cursor, llega a los mismos comandos por MCP, el Model Context Protocol
que usan las aplicaciones de IA para llamar a herramientas. Tú decides qué puede cambiar el agente.
En esta página:
- Agentes con terminal
- Claude Code y Codex por MCP
- Claude Desktop, Cursor y otras aplicaciones MCP
- ChatGPT y Claude en el navegador
- Decide qué puede cambiar el agente
Agentes con terminal
Claude Code, Codex, Gemini CLI, OpenClaw y otros agentes que ejecutan comandos solo necesitan el skill: un archivo corto que enseña al agente los comandos y las reglas de la herramienta.
ydisk skill installLo deja donde lo buscan Claude Code (~/.claude/skills/) y Codex, Gemini CLI y OpenClaw (~/.agents/skills/).
ydisk skill install --for hermes añade además esa carpeta a los ajustes propios de Hermes Agent, algo que un
skill install normal no hace. Vuelve a ejecutarlo después de una actualización. ydisk skill status te dice si el
skill instalado coincide con esta versión.
Luego pide lo que quieras con palabras normales y nombra el perfil:
Use ydisk CLI with profile personal. What did I upload to /Documents/Invoices this month?
List the files with their dates. Do not change anything.Claude Code y Codex por MCP
Para darle la herramienta a Claude Code o a Codex como servidor MCP, añádela con un solo comando:
ydisk personal mcp add claude-code --allow-writes
ydisk personal mcp add codex --allow-writes--allow-writes confirma que sabes que el servidor ofrece los comandos que cambian el Disk. Los permisos del perfil
siguen decidiendo qué se ejecuta. Mira qué puede cambiar el agente.
Claude Desktop, Cursor y otras aplicaciones MCP
ydisk personal mcp configImprime la entrada mcpServers con rutas completas. Pégala en los ajustes MCP de la aplicación y reinicia la
aplicación. Dónde guarda cada aplicación sus ajustes está en la página de agentes.
Vuelve a imprimir la entrada después de cambiar o actualizar Node.js, porque nombra una sola ruta de Node.js.
ydisk personal mcp check arranca el servidor como lo haría una aplicación y lista las herramientas que ofrece.
Ejecútalo cuando una aplicación no muestre herramientas de ydisk.
Un servidor puede atender varios perfiles: ydisk mcp config --profiles personal,work. Entonces cada herramienta
pregunta qué perfil usar.
ChatGPT y Claude en el navegador
Una aplicación del navegador no puede arrancar un programa en tu ordenador, así que ydisk sirve MCP por HTTP en tu
ordenador, y tu propio túnel, como Tailscale Funnel o Cloudflare Tunnel, le da una dirección https:
ydisk personal mcp server start --public-url https://laptop.example.ts.net
ydisk personal mcp server statusLa dirección de arriba es un ejemplo. Usa la de tu túnel. El servidor escucha en 127.0.0.1, puerto 8765 (--port
lo cambia), y se ejecuta en segundo plano hasta que ejecutes ydisk personal mcp server stop. Una aplicación del
navegador inicia sesión con un código de un solo uso que imprimen server start y server status.
ydisk personal mcp revoke termina todas las sesiones. Cómo configurar el túnel y la aplicación está en la
página de aplicaciones del navegador.
Decide qué puede cambiar el agente
El servidor MCP ofrece todos los comandos, también los que cambian el Disk. En un terminal la herramienta pregunta antes de borrar, sobrescribir o crear un enlace público, pero por MCP no hay nadie a quien preguntar, así que se ejecutan. Elige una de estas opciones para un agente:
-
Solo lectura.
YDISK_READ_ONLY=1en el entorno del servidor rechaza cualquier cambio. -
Sin borrar y sin enlaces públicos. Fija los dos permisos del perfil:
ydisk personal config set permissions.files.delete deny ydisk personal config set permissions.files.share deny -
Más estricto solo para un servidor.
--permissionenmcp serve,mcp add,mcp configomcp server starthace un permiso más estricto para ese servidor, nunca más laxo:ydisk personal mcp add claude-code --allow-writes --permission files.delete=deny.
Por MCP un agente lee el texto de un archivo con files download, pero no puede guardar un archivo en una ruta de tu
ordenador. Todas las claves de permisos están en los ajustes, y lo que llega a tu
Disk y a la red está en seguridad.
Siguiente: peticiones para probar.