Что умеет агент

  • disk_get_info — сведения о Диске: объём и занятое место;
  • disk_list_resources — содержимое папок и сведения о файлах;
  • disk_download — скачивание файла на компьютер, чтобы агент мог с ним работать;
  • disk_upload — загрузка файла на Диск после подтверждения;
  • disk_api_request — остальные операции API: публикация, перемещение, копирование и корзина.

Какие права выдать

Права задаются в OAuth-приложении Яндекса, и агент не получит больше, чем в них указано:

  • cloud_api:disk.info — сведения о Диске;
  • cloud_api:disk.read — чтение всего Диска;
  • cloud_api:disk.write — запись в любое место;
  • cloud_api:disk.app_folder — доступ только к папке приложения.

Если агенту нужно своё рабочее пространство, достаточно папки приложения: остальной Диск ему не виден. Для поиска по существующим документам хватит чтения. Шаги подключения такие же, как для Метрики.

Сравнение прав: с cloud_api:disk.read агент видит весь Диск, а с cloud_api:disk.app_folder — только папку своего приложения
Чем уже права, тем меньше агент видит. Папка приложения — самый безопасный вариант.

Примеры запросов

  • «Найди в папке “Отчёты” файлы за октябрь и скачай последнюю выгрузку».
  • «Собери из CSV-выгрузки сводную таблицу и положи результат в папку “Аналитика”» — перед загрузкой агент попросит подтверждение.
  • «Покажи, сколько места занято и какие файлы больше 1 ГБ».
  • «Сравни две версии договора в папке “Юристы” и выпиши отличия».
  • «Опубликуй презентацию и дай ссылку» — публикация открывает доступ по ссылке, поэтому агент сначала уточнит.
Пример диалога: агент скачивает CSV-выгрузку через disk_download, собирает сводную таблицу и просит подтвердить загрузку файла в папку «Аналитика»
Загрузка на Диск — изменение, поэтому агент сначала показывает путь к файлу.

Безопасность и ограничения

  • Агент видит только то, что разрешают OAuth-права. Для изоляции используйте папку приложения.
  • Загрузка, публикация, перемещение и удаление выполняются после подтверждения.
  • Удалённые файлы по умолчанию попадают в корзину Диска, если не запрошено удаление навсегда.
  • Большие файлы передаются через временные ссылки API, и скорость зависит от вашего канала.

Диск вместе с другими сервисами

Диск удобно использовать как место для результатов: агент строит отчёт по Метрике или Вебмастеру и сохраняет его в общую папку команды. Все доступные сервисы перечислены на странице интеграции с Яндексом.

Короткие ответы

Работает ли это с Codex?

Да. Приложение устанавливает профиль в Codex, Claude Code, Cursor, VS Code с Copilot, Windsurf, Antigravity и Cline CLI.

Можно ограничить агента одной папкой?

Да. Выдайте только право cloud_api:disk.app_folder: агент будет работать в папке приложения и не увидит остальные файлы.

Файлы проходят через ваши серверы?

Нет. MCP-сервер работает на вашем компьютере и обращается к API Диска напрямую.

Агент может удалить файлы?

Только если OAuth-права разрешают запись и вы подтвердите операцию. По умолчанию удалённые файлы попадают в корзину.