Яндекс Диск MCP

gorokhovdenis/yandex-disk-mcp· Проверено 12.11.2026· 4на GitHub

Подключает агента к Яндекс Диску через REST API: показать файлы и место, загрузить и скачать папки, скопировать, перенести, удалить. Второй вариант добавляет публичные ссылки и корзину.

2 реализации:

17 инструментов: загрузка и скачивание целых папок фоновой задачей с докачкой и проверкой MD5, сравнение локальной папки с облаком; есть пакет в npm.

Как подключить

Что сделать до подключения

Node.js 18 или новее

Копия репозитория после npm install и npm run build, или пакет из npm: npm install -g yandex-disk-mcp

YANDEX_DISK_TOKEN

oauth.yandex.ru/client/new → приложение с правами cloud_api:disk.read, cloud_api:disk.write, cloud_api:disk.info → oauth.yandex.ru/authorize?response_type=token&client_id=<Client ID>

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YANDEX_DISK_TOKEN=<OAuth-токен Яндекс Диска>' --transport stdio yandex-disk \
  -- node /path/to/yandex-disk-mcp/dist/index.js

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yandex-disk]
command = "node"
args = ["/path/to/yandex-disk-mcp/dist/index.js"]

[mcp_servers.yandex-disk.env]
YANDEX_DISK_TOKEN = "<OAuth-токен Яндекс Диска>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yandex-disk": {
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yandex-disk": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yandex-disk": {
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yandex-disk": {
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yandex-disk": {
        "type": "local",
        "command": ["node", "/path/to/yandex-disk-mcp/dist/index.js"],
        "environment": {
          "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "yandex-disk": {
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yandex-disk": {
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

yandex_disk_infoпоказывает объём и занятое место

yandex_disk_list_filesперечисляет файлы на Диске

yandex_disk_get_metadataчитает метаданные файла или папки

yandex_disk_compareсравнивает локальную папку с облачной

yandex_disk_create_folderсоздаёт папку

yandex_disk_uploadзагружает файл или папку

yandex_disk_upload_statusпоказывает прогресс загрузки

yandex_disk_upload_cancelотменяет загрузку

yandex_disk_downloadскачивает файл или папку

yandex_disk_download_statusпоказывает прогресс скачивания

yandex_disk_get_upload_urlвыдаёт адрес для загрузки

yandex_disk_get_download_urlвыдаёт ссылку на скачивание

yandex_disk_deleteудаляет в корзину или навсегда

yandex_disk_copyкопирует файл или папку

yandex_disk_moveперемещает и переименовывает

yandex_disk_last_uploadedпоказывает недавно загруженные

Показано 16 из 17.

19 инструментов: кроме работы с файлами публикует ссылки, управляет корзиной, загружает файл по внешнему URL и ищет файлы по типу; собирается из исходников или в Docker.

Как подключить

Что сделать до подключения

Node.js; склонировать репозиторий, выполнить npm install и npm run build

YANDEX_DISK_TOKEN

oauth.yandex.ru → «Создать приложение», платформа «Веб-сервисы» с redirect URI https://oauth.yandex.ru/verification_code, права Яндекс.Диск REST API → oauth.yandex.ru/authorize?response_type=token&client_id=<Client ID>

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YANDEX_DISK_TOKEN=<OAuth-токен Яндекс Диска>' --transport stdio yandex-disk-mcp \
  -- node /path/to/yandex-disk-mcp/dist/index.js

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yandex-disk-mcp]
command = "node"
args = ["/path/to/yandex-disk-mcp/dist/index.js"]

[mcp_servers.yandex-disk-mcp.env]
YANDEX_DISK_TOKEN = "<OAuth-токен Яндекс Диска>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yandex-disk-mcp": {
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yandex-disk-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yandex-disk-mcp": {
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yandex-disk-mcp": {
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yandex-disk-mcp": {
        "type": "local",
        "command": ["node", "/path/to/yandex-disk-mcp/dist/index.js"],
        "environment": {
          "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "yandex-disk-mcp": {
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yandex-disk-mcp": {
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "<OAuth-токен Яндекс Диска>"
      }
    }
  }
}

Инструменты сервера

disk_infoпоказывает объём, занятое место и корзину

list_filesперечисляет файлы по пути

get_file_infoчитает метаданные

create_folderсоздаёт папку

copyкопирует файл или папку

moveперемещает и переименовывает

deleteудаляет в корзину или навсегда

get_download_linkвыдаёт ссылку на скачивание

upload_from_urlзагружает файл по внешней ссылке

publishоткрывает публичный доступ

unpublishзакрывает публичный доступ

list_publicперечисляет публичные файлы

list_trashпоказывает корзину

restore_from_trashвосстанавливает из корзины

clear_trashочищает корзину

search_filesищет файлы по типу

last_uploadedпоказывает недавно загруженные

operation_statusпроверяет статус операции

Показано 18 из 19.

Что попросить агента

«Сколько места осталось на Яндекс Диске?»Агент вызовет yandex_disk_info, во втором варианте — disk_info

«Сравни <локальная папка> с <папка на Диске> и скажи, чего нет в облаке»Агент вызовет yandex_disk_compare и покажет список only_local

«Загрузи на Диск в <папка на Диске> файлы, которых там нет»Агент передаст only_local в yandex_disk_upload параметром include и проверит прогресс через yandex_disk_upload_status

«Сделай файл disk:/<файл> публичным и дай ссылку»Во втором варианте агент вызовет publish и вернёт ссылку

«Что в корзине? Восстанови последний удалённый файл»Во втором варианте агент вызовет list_trash и restore_from_trash

Для каких задач

Загрузить папку с фото или видео на Диск с докачкой и проверкой MD5

Сравнить бэкап на флешке с папкой на Диске и дозагрузить недостающие файлы

Скачать папку с Диска на компьютер для резервной копии

Разложить файлы по папкам: создать, перенести, переименовать, скопировать

Сделать файл публичным и получить ссылку

Посмотреть корзину и восстановить удалённый файл

Ограничения

Фоновые загрузки и скачивания yandex-disk-mcp живут в процессе сервера: если клиент перезапустит сервер, задача остановится

Сравнение папок и фоновые задачи есть только в yandex-disk-mcp; публичные ссылки, корзина, загрузка по URL и поиск по типу — только во втором варианте

Инструменты удаления с параметром permanently=true стирают файл навсегда, мимо корзины

Сервер Antiloop-git ставится только из исходников или собранным локально образом Docker

Если не работает

Загрузка остановилась после перезапуска клиента

Задача жила в процессе сервера. Повторите тот же вызов yandex_disk_upload: файлы того же размера пропустятся, загрузка продолжится.

После скачивания часть файлов в списке failed

У Диска бывает хранилище, которое не отвечает на часть файлов. Повторите то же скачивание позже, уже скачанные файлы пропустятся.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
yandex-disk-mcp	Denis Gorokhov	4	локально	токен	17	18 октября 2026
Yandex Disk MCP Server	Antiloop-git	5	локально	токен	19	5 марта 2026

Частые вопросы

Какие права дать OAuth-приложению?

cloud_api:disk.read для чтения, cloud_api:disk.write для записи и cloud_api:disk.info для данных о диске. Для второго варианта добавьте cloud_api:disk.app_folder и redirect URI https://oauth.yandex.ru/verification_code.

Как проверить, что бэкап совпадает с облаком?

Попросите сравнить папки: yandex_disk_compare сверяет файлы по пути и размеру, с check_md5 — ещё и по MD5. Список only_local агент передаёт в yandex_disk_upload параметром include и дозагружает только недостающее.

Зачем видео загружается под именем .part?

Диск ограничивает загрузку видео через API примерно 130 КБ/с, ориентируясь на расширение. yandex-disk-mcp загружает файл под временным именем и переименовывает после обработки; список расширений задаёт параметр bypass_extensions, пустой список отключает обход.

Можно поставить без сборки?

yandex-disk-mcp есть в npm: npm install -g yandex-disk-mcp. Второй вариант собирается из исходников или запускается в Docker: docker build -t yandex-disk-mcp . и docker run -i --rm -e YANDEX_DISK_TOKEN=<токен> yandex-disk-mcp.

Можно пустить трафик загрузки через прокси?

В yandex-disk-mcp — да: задайте YANDEX_DISK_UPLOAD_PROXY и YANDEX_DISK_DOWNLOAD_PROXY в env. Через прокси идут только загрузка и скачивание файлов, запросы к API всегда идут напрямую.

Работает ли сервер из России?

Оба сервера запускаются на вашем компьютере и ходят в API Яндекс Диска по вашему OAuth-токену; зарубежные аккаунты не нужны.

Яндекс Диск MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы