Yandex Disk MCPでMicrosoft Copilotと連携

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

Yandex Disk + Microsoft Copilot

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

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

YANDEX_DISK_CLIENT_ID, YANDEX_DISK_CLIENT_SECRET

ステップ 1 — 認証情報を取得

設定は 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 の管理設定の変更は行いません。

ステップ 2 — アダプターをインストール

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

ステップ 3 — Microsoft Copilot にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。Yandex Disk のツールが必要になる依頼をしてみましょう。
6. Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。

ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。

利用可能なツール

プロンプトの例

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

FAQ

どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。

何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。

エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Gemini に接続
• Meta Muse に接続