MCP для Яндекс Диска с фоновой загрузкой
yadisk-mcp
MCP-сервер для Яндекс Диска с 22 инструментами: файлы, публикация и корзина, фоновая загрузка больших файлов и режим только для чтения
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- По умолчанию может удалять, перемещать и публиковать файлы на Яндекс Диске
- Может загружать произвольные локальные файлы, если не ограничить папки переменной окружения
- Советуем начинать с флага --read-only, пока не нужна запись
Установка
Ручная установка
pip install yadisk-mcpУстановка пакета из PyPI.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер асинхронно покрывает API Яндекс Диска 22 инструментами: квота и информация о диске, список и поиск файлов, создание, копирование, перемещение, переименование и удаление, загрузка локального файла (до примерно 100 МБ синхронно, крупные файлы в фоне с job_id и трекингом прогресса), загрузка по URL, публикация файлов со ссылкой и снятие публикации, работа с корзиной. Флагом --read-only, переменной окружения или программно можно заблокировать все пишущие операции и оставить только просмотр. Отдельная переменная ограничивает, из каких локальных папок разрешена загрузка, и блокирует симлинки за их пределы.
Для кого. Для тех, кто хочет полноценно управлять Яндекс Диском через агента: от загрузки больших файлов до публикации ссылок.
Подходит, если
- Нужна загрузка больших файлов в фоне с отслеживанием прогресса
- Нужно опубликовать файл и получить публичную ссылку прямо из диалога с агентом
- Нужен безопасный режим только для чтения для демонстраций или просмотра чужого диска
Не подходит, если
- Нужен минимальный сервер без пишущих операций вообще: тут запись включена по умолчанию, режим только для чтения нужно включать отдельно
- Не хочется выдавать токен с правами записи на весь диск
Пример запроса к агенту
Найди все PDF-файлы на Яндекс Диске за последний месяц и опубликуй самый свежийОграничения
Нужен OAuth-токен Яндекса с правами cloud_api:disk.read, disk.write, disk.app_folder и disk.info, полученный через собственное приложение на oauth.yandex.ru. Токен действует год и требует ручного обновления. По умолчанию upload_local_file может загрузить любой локальный файл, если не задать YADISK_MCP_UPLOAD_ALLOWED_DIRS. Полная очистка корзины необратима.
Как отключить. Удалите сервер командой claude mcp remove yadisk или из конфигурации клиента вручную и отзовите OAuth-токен на oauth.yandex.ru.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_DISK_TOKEN обязательная, секрет | OAuth-токен Яндекса с правами cloud_api:disk.read, disk.write, disk.app_folder, disk.info |
| YADISK_MCP_READ_ONLY | Включает режим только для чтения и блокирует все пишущие инструменты |
| YADISK_MCP_UPLOAD_ALLOWED_DIRS | Список локальных папок, из которых разрешена загрузка файлов на диск |
Проверка безопасности
- По умолчанию может удалять, перемещать и публиковать файлы на Яндекс Диске
- Может загружать произвольные локальные файлы, если не ограничить папки переменной окружения
- Советуем начинать с флага --read-only, пока не нужна запись
Коротко о README
README на русском с английской версией отдельным файлом описывает сервер как полностью асинхронный, с фоновой загрузкой больших файлов и трекингом прогресса. Дана таблица из 22 инструментов по категориям: информация и поиск, файловые операции, загрузка и скачивание, публикация, корзина. Подробно расписано получение OAuth-токена через собственное приложение на oauth.yandex.ru с нужными правами, установка через pip install yadisk-mcp или из исходников, подключение в Claude Code и Claude Desktop, режим --read-only со списком заблокированных и доступных инструментов и переменная ограничения папок загрузки. Есть CI и публикация в PyPI.
Частые вопросы
Можно ли запретить агенту изменять файлы?
Да, флаг --read-only, переменная YADISK_MCP_READ_ONLY=true или программный вызов configure(read_only=True) блокируют все операции записи, публикации и очистки корзины.
Как ограничить, какие локальные файлы можно загружать?
Переменной YADISK_MCP_UPLOAD_ALLOWED_DIRS со списком разрешенных папок, симлинки за их пределы блокируются автоматически.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI