MCP для Яндекс Диска и Вики с гранулярными правами
Yandex Workspace MCP
MCP-сервер для Яндекс Диска и Яндекс Вики с раздельными правами на чтение, запись и удаление, белым списком путей и аудит-логом
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запись и удаление на Диске и в Вики можно включить отдельными переменными, по умолчанию выключены
- OAuth-токен дает доступ к данным в пределах разрешенных корней и прав приложения
- Советуем начинать с DISK_READ и WIKI_READ без DISK_WRITE и WIKI_WRITE, пока не понадобится запись
Установка
- Работает в
- Сервисы
Ручная установка
git clone https://github.com/denis-samatov/yandex-workspace-mcp.git
cd yandex-workspace-mcp
uv syncУстановка зависимостей через uv.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запись и удаление на Диске и в Вики можно включить отдельными переменными, по умолчанию выключены
- OAuth-токен дает доступ к данным в пределах разрешенных корней и прав приложения
- Советуем начинать с DISK_READ и WIKI_READ без DISK_WRITE и WIKI_WRITE, пока не понадобится запись
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер объединяет Яндекс Диск и Яндекс Вики за одним MCP-интерфейсом: 22 инструмента для Диска и 27 для Вики плюс общий инструмент поиска, который опрашивает оба сервиса одновременно. По умолчанию сервер работает только на чтение, а запись и удаление включаются отдельными переменными DISK_WRITE, DISK_DELETE, WIKI_WRITE, WIKI_DELETE. Доступ к Диску и Вики ограничивается белым списком корневых путей ALLOWED_ROOTS, каждая операция проверяется на попадание в разрешенные корни до и после запроса. Полное удаление настроенного корня отклоняется, а очистка корзины Диска доступна только при явном флаге глобально разрушительных операций и параметре confirm=true в каждом вызове. Все пишущие и разрушительные операции пишутся в структурированный аудит-лог.
Для кого. Для команд, которые хотят дать агенту доступ к рабочему пространству в Яндекс Диске и Вики, но с четким контролем прав и следом действий.
Подходит, если
- Нужен единый поиск сразу по Диску и Вики из одного запроса агенту
- Важно ограничить агента конкретными папками и разделами, а не всем аккаунтом
- Нужен аудит-лог, кто и что изменил через агента
Не подходит, если
- Нужен простой сервер без настройки прав и ролей: тут конфигурация подробная и рассчитана на осознанный выбор каждого права
- Нужен доступ к Диску без Вики или наоборот без лишних переменных: оба сервиса настраиваются отдельными блоками, но конфиг общий
Пример запроса к агенту
Найди все упоминания проекта Атлас в Вики и на Диске и покажи, где что лежитMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
YANDEX_OAUTH_TOKENобязательная, секрет- OAuth-токен Яндекса с правами Диска и, при необходимости, Вики
YANDEX_WIKI_ORG_ID- Идентификатор организации, нужен для Вики в корпоративном аккаунте
DISK_READ- Включает инструменты чтения Диска, по умолчанию true
DISK_WRITE- Включает инструменты записи Диска, по умолчанию false
DISK_DELETE- Включает удаление и восстановление из корзины Диска, по умолчанию false
DISK_ALLOWED_ROOTS- Список разрешенных корневых путей Диска
WIKI_READ- Включает инструменты чтения Вики, по умолчанию true
WIKI_WRITE- Включает запись страниц и таблиц Вики, по умолчанию false
WIKI_DELETE- Включает удаление и восстановление страниц Вики, по умолчанию false
WIKI_ALLOWED_ROOTS- Список разрешенных корневых разделов Вики
Ограничения
Нужен OAuth-токен Яндекса с правами на Яндекс Диск и, при включенной Вики, отдельный идентификатор организации. Для многопользовательского режима по HTTP нужны Redis, ключи шифрования токенов и регистрация callback URL. Установка через uv, готового пакета в PyPI на момент проверки нет. Полнотекстовый поиск Вики использует недокументированную стабильность полей API и при расхождении переключается на резервный обход с пометкой degraded.
Как отключить. Удалите сервер из конфигурации MCP клиента, отзовите OAuth-токен Яндекса и, если использовался многопользовательский режим, удалите зарегистрированный callback URL приложения.
Частые вопросы
Может ли агент удалить весь Диск или Вики целиком?
Нет, удаление настроенного корня целиком отклоняется сервером, а очистка корзины Диска доступна только при отдельном флаге глобально разрушительных операций и явном confirm=true в каждом вызове.
Как ограничить агента конкретной папкой?
Переменными DISK_ALLOWED_ROOTS и WIKI_ALLOWED_ROOTS со списком путей, каждый запрос проверяется на попадание в эти корни до и после обращения к API.
Обсуждение
Вопросов и отзывов пока нет.
MCP для Яндекс Диска с фоновой загрузкой
yadisk-mcp
MCP-сервер для Яндекс Диска с 22 инструментами: файлы, публикация и корзина, фоновая загрузка больших файлов и режим только для чтения
MCP для уборки на Яндекс Диске
Yandex Disk MCP Server
MCP-сервер для Яндекс Диска, нацеленный на поиск больших файлов и уборку по API, минуя локальную синхронизацию
MCP-сервер полнотекстового поиска по Яндекс Вики
Yandex Wiki Search MCP
MCP-сервер для Яндекс Вики: тот же полнотекстовый поиск, что в веб-интерфейсе, страницы, комментарии, вложения и динамические таблицы, 33 инструмента
MCP-сервер Яндекс Диска без редактирования
Yandex.Disk MCP Server
Небольшой Python MCP-сервер для Яндекс Диска: просмотр, загрузка, скачивание и создание файлов, но без изменения существующих
MCP для Яндекс Вики от 1gory
mcp-yandex-wiki
MCP-сервер на 28 инструментов для Yandex Wiki API v1: страницы, вложения, комментарии, таблицы и восстановление удаленного
MCP-сервер для Яндекс Диска: папки, метаданные, копирование, перемещение, удаление и ссылки на загрузку и скачивание
Коротко о README
README на английском описывает проект как security-first сервер для Диска и Вики с явными правами на чтение, запись и удаление. Подробно расписана конфигурация через .env: белые списки путей, лимиты загрузки, разрешенные хосты для импорта по URL, режимы транспорта stdio и streamable-http с тремя вариантами аутентификации, ключи шифрования токенов. Отдельные разделы объясняют права на инструменты Диска и Вики, поведение поиска и резервный режим при расхождении API, шаги получения OAuth-токена и пример конфигурации для Claude Desktop и Cursor. Проект покрыт контрактными и security-тестами, есть Dockerfile и docker-compose.