Yandex Disk を MCP に：あらゆる AI エージェントから Yandex Disk を操作

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Yandex Disk をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Yandex Disk

AI から Yandex Disk を操作できます。フォルダーの閲覧、全ファイルや最近のアップロードの一覧、ファイル詳細の確認、ダウンロードリンクの取得、フォルダーの作成、ファイルのコピー、移動、公開と公開停止、URL からのファイル保存、ゴミ箱からの復元ができます。Yandex アカウントでサインインして使います。

セットアップ

設定は 5 分ほどで終わります。AI に扱わせる Disk の Yandex アカウントと、そのアカウントで Yandex OAuth に登録したアプリが必要です。

1. その Yandex アカウントでサインインし、oauth.yandex.ru/client/new（または oauth.yandex.com）を開いてアプリを作成します。
2. プラットフォームは Web services を選びます。Redirect URI には https://cloud.anythingmcp.com/api/mcp-oauth/callback を入力します。AnythingMCP をセルフホストしている場合は、代わりに https://your-anythingmcp-host/api/mcp-oauth/callback を入力します。
3. データアクセスで、Yandex Disk REST API の権限 cloud_api:disk.read（Disk 全体の読み取り）、cloud_api:disk.write（Disk 全体への書き込み）、cloud_api:disk.info（Disk の情報）を追加します。cloud_api:disk.app_folder だけを選ぶと、アプリが専用フォルダーしか扱えなくなるので避けてください。
4. アプリを作成し、ClientID を YANDEX_DISK_CLIENT_ID に、Client secret を YANDEX_DISK_CLIENT_SECRET にコピーして、コネクタをインストールします。
5. コネクタのページで Authorize with Provider をクリックし、Yandex アカウントを選んでアクセスを許可します。
6. まず yandex_disk_get_disk_info を実行します。どの Disk にサインインしているか、使用容量、ゴミ箱のサイズが表示されます。

権限と読み取り専用の設定: Yandex は、手順 3 でアプリに付けた権限をそのまま付与します。読み取り専用にするなら、アプリを cloud_api:disk.read と cloud_api:disk.info だけで登録し、yandex_disk_create_folder、yandex_disk_copy、yandex_disk_move、yandex_disk_publish、yandex_disk_unpublish、yandex_disk_upload_from_url、yandex_disk_restore_from_trash をオフにしてください。

サインイン: Yandex のトークンは約 1 年有効で、リフレッシュトークンも発行されます。AnythingMCP はこれを使ってトークンを更新し、どちらも暗号化して保存します。id.yandex.ru/security でアプリを取り消したり権限を変えたりした場合は、もう一度 Authorize with Provider をクリックしてください。

パス: ファイルとフォルダーは disk:/folder/file.txt の形で指定し、ルートは disk:/、ゴミ箱の項目は trash:/... です。フォルダー名やファイル名を言うだけで構いません。AI は拡張子を含む正確な名前を使います。

変更はあなたの承認後: フォルダーの作成、コピー、移動や名前の変更、公開と公開停止、URL からのファイル保存、ゴミ箱からの復元は Disk を変更します。AI は何が起きるかを説明してあなたの確認を待ち、既存ファイルの上書きもあなたが同意した場合だけ行います。yandex_disk_publish はリンクを知っている誰もがファイルやフォルダーを開けるようにします。yandex_disk_unpublish はリンクを無効にし、再度公開すると新しいリンクが作られます。

インストール時はオフ: yandex_disk_delete。管理者が有効にすると、項目をゴミ箱へ移動し、yandex_disk_restore_from_trash で戻せます。完全に削除するのは、あなたがはっきり指示した場合だけです。

検索機能なし: Yandex Disk の API には名前や内容による検索がありません。ファイルを探すとき、AI は yandex_disk_list_folder でフォルダーを一覧したり、yandex_disk_list_files で全ファイルを（画像や文書だけなどに絞って）順に見て名前を比べたり、yandex_disk_list_last_uploaded で最近のアップロードを確認したりします。

ファイルの中身: このコネクタはファイルの中身を読み込んだりアップロードしたりしません。yandex_disk_get_download_link は開いて使える一時的なリンクを返し（フォルダーは zip でダウンロード）、yandex_disk_upload_from_url はすでにインターネット上にあるファイルを保存します。yandex_disk_get_public_resource は、自分のものでも他人のものでも、Yandex Disk の公開リンクを読み取れます。

バックグラウンド処理: 大きなフォルダーのコピー、移動、復元、削除と、URL からのアップロードはすべて Yandex 側でバックグラウンド実行されます。AI は処理が終わるまで yandex_disk_get_operation_status で進行状況を確認します。

よくあるエラー: 401 UnauthorizedError は、サインインがない、取り消された、または期限切れであることを示します。もう一度認可してください。403: アプリに手順 3 の権限がない（例: 変更に必要な cloud_api:disk.write）、Disk が容量を超えている、または読み取り専用モードです。404: パスが存在しません。綴り、拡張子、disk:/ の接頭辞を確認してください。409: 移動先がすでに存在するか、その親フォルダーがありません。423: 他の処理で項目がロックされているか、アップロードが一時停止中です。後で再試行してください。507: Disk の空き容量が足りません。429: リクエストが多すぎます。少し待って再試行してください。

このコネクタは、ファイルの中身の読み込みやアップロード、カスタムプロパティの編集、ゴミ箱を空にすること、特定の人とのフォルダー共有、Yandex 360 の管理設定の変更は行いません。

前提条件: YANDEX_DISK_CLIENT_ID, YANDEX_DISK_CLIENT_SECRET

ローカルでコネクタをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

http://localhost:3000/connectors/store を開き、 Yandex Disk を選択し、前提条件に記載された環境変数を入力します。

利用可能なツール

プロンプトの例

• 「Yandex Disk の空き容量はあとどれくらい？ゴミ箱のサイズは？」
• 「先週アップロードした写真はどれ？それぞれどのフォルダーにある？」
• 「Disk に Clients/Acme フォルダーを作って、Downloads にある Acme の契約書 PDF をそこへ移動して。」
• 「Presentations/Pitch.pdf の公開リンクを作って教えて。そのあと、ほかに公開しているものを一覧にして。」

次のステップ

• Claude に接続
• ChatGPT に接続