Documentos y archivosYandex Disk

Configuración de la CLI de Yandex Disk

Mira y cambia los ajustes de la CLI de Yandex Disk: perfiles, carpetas, variables y su orden.

Cambia cómo se comporta ydisk para un perfil o para todos: qué puede cambiar un agente en tu Disk, cuánto tiempo se guardan los registros de ejecución y cómo ordena la búsqueda sus resultados. Los ajustes están en un solo archivo, config.json, en la carpeta que muestra ydisk doctor. Cada perfil tiene su propia parte, y defaults valen para todos los perfiles.

ydisk personal config show
ydisk personal config set limit 50
ydisk personal config unset limit

config show lista cada ajuste y de dónde viene: del archivo, de una variable o del valor por defecto.

Permisos

permissions decide qué puede hacer un comando para este perfil. Cada comando tiene su propia clave, con su nombre, como files.move o files.upload, y cada clave tiene uno de cuatro niveles:

NivelQué pasa
allowEl comando se ejecuta.
askEn un terminal la herramienta pregunta antes. Por MCP no hay nadie a quien preguntar, así que el comando se ejecuta.
readonlyUna lectura se ejecuta. Un cambio se rechaza.
denyEl comando se rechaza, con código de salida 5.

Dos claves protegen los cambios que cuesta deshacer. Están en ask hasta que las cambies. Las demás claves de files están en allow:

ClaveQué protege
files.deletefiles delete, y una subida, una copia o un movimiento con --replace, que sobrescribe un archivo. En el grupo api: un borrado, vaciar la papelera y cualquier sobrescritura.
files.sharefiles publish y files unpublish: un enlace que abre cualquiera que lo tenga. En el grupo api: las operaciones de enlace público.
ydisk personal config set permissions.files.delete deny
ydisk personal config set permissions.files.share deny
ydisk personal config set permissions.files.upload deny

Un comando de api que hace lo que hace un comando de files comprueba también la clave de ese comando: con files.move en deny se detiene también api resources-move. --dry-run en cualquier cambio muestra cada clave que comprueba y su nivel, sin hacer el cambio.

YDISK_READ_ONLY=1 rechaza cualquier cambio, digan lo que digan los permisos. Solo para un servidor MCP, --permission files.delete=deny hace una clave más estricta. Mira la conexión del agente.

Registros de ejecución

Un comando que falla se guarda como una ejecución, para ydisk runs list y runs show. Un comando que llega a Yandex Disk, como files list, sync o session status --check, se guarda también cuando tiene éxito, salvo que record sea false (entonces solo los fallos) o que se ejecutara con --no-record. record_input decide si una ejecución guarda las palabras que escribiste. Es true salvo que lo pongas en false. Los secretos se ocultan en ambos casos. Mira Seguridad.

AjustePor defectoQué hace
recordtrueGuarda cada ejecución. false guarda solo las que fallan.
record_inputtrueGuarda las palabras escritas en la línea de comandos: true, false o failed.
keep_runs_for_days30Días que se guarda una ejecución.
keep_successful_runs_for_days7Días que se guarda una ejecución correcta.
runs_size_limit_mb200Los megabytes máximos que pueden ocupar todas las ejecuciones.

Otros ajustes

AjustePor defectoQué hace
limit20Cuántos elementos muestra una lista a la vez.
search_rerankermmarcoEl modelo que ordena los primeros resultados de la búsqueda, o off.
embedding_providerlocallocal u openai: lo que convierte el texto en vectores para la búsqueda por significado. openai envía el texto a OpenAI.
update_checktrueComprueba una vez al día si hay una versión nueva.
skill_hinttrueAvisa a un agente una vez al día de que skill install le daría el skill de esta herramienta.

Variables de entorno

VariableQué hace
YDISK_PROFILEEl perfil para los comandos que no nombran ninguno.
YDISK_READ_ONLY1 rechaza cualquier cambio.