Установка CLI и MCP-сервера Яндекс Диска
Установите CLI для Яндекс Диска из npm, получите токен Яндекса и войдите с профилем.
Настройте ydisk один раз на каждом компьютере, где работаете вы или ваш агент. После этих шагов ваш Диск подключен
под именем профиля, которое вы выбрали, и первый поиск работает. Чтобы войти, вы вставляете токен OAuth Яндекса. Это ключ, который
Яндекс выдает для вашего собственного аккаунта и который дает инструменту доступ к Диску. Получить его можно минут за
пять, один раз.
На этой странице:
- Установите инструмент
- Получите токен Яндекса
- Войдите
- Проверьте, что все работает
- Компьютер без связки ключей
- Обновление
- Удаление
Установите инструмент
Нужен Node.js 22.16 или новее в ветке 22.x либо версия 24 и новее. Node 23 не поддерживается. Версию покажет команда
node --version. Если Node.js нет или он старее, скачайте его на nodejs.org.
npm install -g @wirecat/yandex-disk-cli
ydisk --version
ydisk doctordoctor не использует сеть и не открывает связку ключей. Он показывает версию, где лежат настройки и локальное
хранилище, какие профили есть и могут ли другие пользователи компьютера читать настройки. Чтобы попробовать инструмент
без установки, выполните npx @wirecat/yandex-disk-cli --help.
Получите токен Яндекса
Токен Яндекс выдает приложению, которое вы регистрируете для себя. Приложение здесь только название и список прав в вашем аккаунте Яндекса. Ничего не публикуется. Шаги повторяют собственные инструкции Яндекса: регистрация приложения для доступа к API и быстрый старт API Диска. Страницы Яндекса на русском, поэтому названия из интерфейса даны в шагах как есть.
- Откройте oauth.yandex.ru/client/new и войдите в Яндекс с аккаунтом, Диск которого хотите использовать. Если Яндекс предложит выбрать тип приложения, выберите Для доступа к API или отладки («Для доступа к API или отладки»).
- Введите любое название приложения («Название вашего сервиса»), например
Мой ноутбук, и свою почту («Контактная почта»). - В разделе «Доступ к данным» добавьте права Яндекс Диска, которые нужны инструменту:
cloud_api:disk.read: чтение всего Диска («Чтение всего Диска»).cloud_api:disk.info: информация о Диске («Доступ к информации о Диске»). По ней инструмент проверяет, чей это токен.cloud_api:disk.write: запись в любом месте Диска («Запись в любом месте на Диске») для загрузки, переноса, удаления и публичных ссылок. Для токена только на чтение не добавляйте его. Тогда любое изменение завершится ошибкой.
- Создайте приложение («Создать приложение»). На его странице будет ClientID, строка из букв и цифр. Скопируйте ее.
- Откройте в браузере этот адрес, дописав ClientID в самый конец, после
client_id=:https://oauth.yandex.ru/authorize?response_type=token&client_id= - Яндекс спросит, разрешить ли приложению доступ к вашему Диску. Разрешите, и Яндекс покажет токен на странице. Скопируйте его.
Прежде чем разрешить создание приложений, Яндекс может попросить подтвердить личность. Без подтверждения он показывает предупреждение и ограничивает число приложений, но для этих шагов это не помеха. Подробности на странице Яндекса.
Храните токен как пароль. Тот, у кого он есть, может работать с вашим Диском с теми правами, которые вы выбрали.
Войдите
Выберите имя профиля для этого аккаунта, например personal, и войдите под ним. Инструмент спросит токен скрытым
вводом. Вставьте его и нажмите Enter.
ydisk personal session startСначала инструмент проверяет токен у Яндекса и сохраняет его, только если Яндекс его принял. Токен лежит в системной связке ключей (Keychain в macOS, Credential Manager в Windows, Secret Service в Linux). Токен никогда не передается аргументом команды и не попадает ни в вывод, ни в журнал.
session start читает токен и из stdin, так что скрипт может передать его из менеджера паролей. У второго аккаунта
будет свой профиль: ydisk work session start.
Проверьте, что все работает
ydisk personal session status --check
ydisk personal folders browsesession status --check спрашивает Яндекс, чей это токен, и показывает аккаунт. folders browse показывает папки
верхнего уровня вашего Диска. Обе команды отвечают по данным Яндекса, так что рабочий ответ значит, что вход
выполнен.
Яндекс держит токен действующим месяцами и продлевает его, пока им пользуются
(Яндекс ID). Когда Яндекс перестанет его принимать,
команды завершатся с кодом выхода 4: получите новый токен так же и снова выполните session start.
ydisk personal session end удаляет токен с этого компьютера.
Компьютер без связки ключей
На сервере или в контейнере без связки ключей инструмент хранит токен в закрытом файле, который читаете только вы, и говорит об этом. Чтобы обойтись без связки ключей намеренно:
ydisk personal session start --credential-storage fileОбновление
ydisk upgradeydisk upgrade --check только сообщает, есть ли новая версия. После обновления снова выполните ydisk skill install,
чтобы инструкции вашего агента соответствовали новой версии.
Удаление
ydisk personal session end забывает токен профиля на этом компьютере. Затем удалите сам инструмент:
npm uninstall -g @wirecat/yandex-disk-cliНастройки и локальное хранилище остаются в папках, которые показал ydisk doctor, для других инструментов WireCat,
которые делят это хранилище. Если они вам больше не нужны, удалите их вручную.
Дальше: выберите папки и синхронизируйте их.