AgentPickLink for M365

日本語 | English

v0.2.5 Beta — VS Code から、利用を承認した Microsoft 365 エージェントへ質問するためのローカル MCP ブリッジです。

Microsoft 365 にサインインしてエージェントを選び、ワークスペース単位で利用を承認すると、MCP 対応の AI クライアントから質問できるようになります。回答テキストや引用に加え、エージェントが生成したファイルを保存できます。

AgentPickLink は MIT ライセンスのオープンソースソフトウェア（OSS） です。利用している第三者ソフトウェアには、それぞれのライセンスが適用されます。

本ソフトウェアは Microsoft の公式製品ではありません。ベータ版のため、Microsoft 365 の画面変更やテナントの設定によって接続・取得に失敗する場合があります。

v0.2.5 の主な変更

• 添付ファイルのダウンロードやファイルカードが応答しない場合に、保存処理が待ち続ける問題を修正しました。待機上限に達したファイルは未保存として理由を返します。

• MCP クライアントからのキャンセルを受け取ると、ローカルの回答待ち・ファイル保存も終了します。送信済みの質問や Microsoft 365 側の生成処理を取り消すものではありません。

詳細と更新時の注意点は リリースノート を参照してください。

Related MCP server: DebugPilot

利用環境

• ローカルの VS Code 1.101 以降と、単一フォルダのワークスペース。

• Windows 11 と Microsoft Edge を主な対象としています。macOS は開発・検証向けで、Edge または Google Chrome を使用します。

• 対象エージェントを利用できる Microsoft 365 の職場または学校アカウント。必要なライセンス・利用権限は別途用意してください。

• MCP に対応した AI クライアント。

Node.js 22 以降を別途インストールすると実行環境を明示できます。未導入の場合、拡張機能は VS Code 内蔵ランタイムの利用を試みます。ソースからビルドする場合は Node.js 22 以降と npm が必要です。

WSL、Remote SSH、Dev Containers、Codespaces、複数ルートのワークスペース、リモート MCP サーバー、無人実行は対象外です。すべての Microsoft 365 エージェントや画面構成への対応を保証するものではありません。

Windows・macOS・Ubuntu の自動テストを公開 CI で実行します。Ubuntu は開発・CI 専用の検証対象で、通常利用の対象外です。実際の Microsoft 365 テナントと VS Code 画面での確認は CI に含まれません。詳しくは 検証範囲 を参照してください。

インストール

1. GitHub の Releases → v0.2.5 (Beta) で agent-pick-link-0.2.5.vsix をダウンロードします。

2. VS Code のコマンドパレットから Extensions: Install from VSIX… / 拡張機能: VSIX からのインストール… を実行し、ダウンロードしたファイルを選びます。

3. 再読み込みを求められた場合は、VS Code を再読み込みします。

ターミナルからもインストールできます。

code --install-extension agent-pick-link-0.2.5.vsix

VSIX には拡張機能、CLI、ローカル接続プロセス、MCP サーバーを同梱しています。npm パッケージや Marketplace からのインストールは、このベータ版の配布手順には含みません。

v0.2.3 以前からの更新

同じ手順で v0.2.5 の VSIX をインストールし、VS Code を再読み込みしてください。既存の設定・ワークスペース承認・専用ブラウザープロファイルはそのまま利用できます。パネルで接続状態を確認し、必要に応じて 接続して更新 / Connect and refresh を実行してください。外部 AI クライアントの MCP 接続も再起動して、新しいバージョンを読み込みます。v0.1.x で有効にした Codex / Claude Code / VS Code の連携設定は、起動時に新しい形式へ更新し、その旨を 1 回通知します。

拡張機能なしでインストールする

v0.2.0 から利用できます。 VS Code 拡張機能のインストールが許可されていない環境向けに、ポータブルアーカイブから直接インストールできます。

1. GitHub の Releases から、お使いの OS 用のアーカイブ（AgentPickLink-<版>-win-x64.zip など）をダウンロードし、任意の場所に展開します。

2. 展開したフォルダで cmd・PowerShell・ターミナルのいずれかを開きます。

3. ワークスペース（VS Code で開くフォルダ）のフルパスを指定して、次のコマンドを 1 回実行します。

   .\apl-setup C:\path\to\workspace          (Windows)
   ./apl-setup /path/to/workspace            (macOS)

Linux アーカイブは開発・CI 専用です。通常の serve は PLATFORM_UNSUPPORTED で停止します。M365_AGENT_ALLOW_UNSUPPORTED_OS=1 は開発者向けの例外で、一般利用の導入手順ではありません。Remote SSH・WSL・コンテナー等はこの指定でも利用できません。

Node.js は同梱されているため、別途インストールする必要はありません。アップグレードは、新しいアーカイブを展開して同じコマンドを再実行するだけです（apl-setup <ワークスペース>）。以前の版に戻す場合は apl self use <version> を実行します。

画面をブラウザーに表示する場合は --browser を追加します。--no-open を併用すると 一度だけ使えるURLを端末に表示します。操作は15分以内に完了してください。承認操作には対話端末が必要です。 --dry-run は設定を初期化・移行せず計画のみを表示します。apl self prune は旧版削除前に確認し、 --yes でこの削除確認を省略できます。拡張パネルの「機械インストールを更新」は自動実行されません。

管理者向けの詳細（書き込まれるファイル、実行制御ポリシー、許可リストの設定など）は 管理者向けノート を参照してください。

新しいバージョンの通知

VS Code 起動時に GitHub の公開リリースを確認し、新しいバージョンがあれば通知します。ベータ版も対象で、同じバージョンの通知は一度だけです。通知からリリースページを開き、VSIX をダウンロードして更新できます。自動インストールは行いません。

確認を止める場合は、VS Code の設定で agentpicklink.checkForUpdates を無効にします。オフライン時は通常の起動を続け、次回起動時に再確認します。確認時に質問やワークスペースの内容を送信することはありません。

最初のセットアップ

1. 利用するフォルダを VS Code で開き、内容を確認したうえでワークスペースを信頼します。

2. アクティビティバーの AgentPickLink を開き、環境をセットアップする / Set up environment を選びます。

3. サインイン画面が開いたら、職場または学校アカウントでサインインします。追加認証が必要な場合も、この専用ブラウザーで操作してください。

4. 一覧から、このワークスペースで利用するエージェントを選びます。

5. クライアント・ファイル設定 / Client and file settings で、必要なクライアント連携とファイル保存設定を選びます。

6. 承認して保存 / Approve and save を押し、確認画面で利用対象を承認します。

VS Code の MCP 定義は拡張機能から提供されます。追加で有効にした連携は、対応するクライアント設定に反映されます。外部クライアントが変更を認識しない場合は、そのクライアントを再起動してください。

設定済みのワークスペースを再度開くと、保存したエージェントと接続状態を復元します。新しいエージェントを取得したい場合は 接続して更新 / Connect and refresh を選びます。

AI クライアントからの利用

クライアントで m365-agents の MCP ツールを有効にし、例えば「利用可能な Microsoft 365 エージェントを確認し、選んだエージェントにこの質問を送って」と依頼します。実際の呼び出し可否は、クライアント側のツール設定と承認にも従います。

単発の質問では、回答取得後に会話を自動的に閉じます。複数ターンの会話では、作成したセッションを指定して質問を続け、終了時に閉じます。回答やファイル生成には数分かかることがあります。送信結果が不明な場合は自動再送しません。

生成ファイル

ファイル保存は初期設定で有効です。許可されたダウンロード先は、標準では *.sharepoint.com と onedrive.live.com です。保存先は、開いているワークスペースの APL_downloads/<workspace-key>/<request-id>/ です。

回答に含まれるファイルの共有リンクやダウンロード操作から取得します。SharePoint / OneDrive のリンクを開ける権限とサインイン状態が必要です。通常のページへのリンクがすべて保存対象になるわけではありません。

初期上限は 1 回の回答につき 10 ファイル、1 ファイル 25 MiB、合計 100 MiB です。保存したファイルを自動実行・変換することはありません。ファイルの正確さや安全性は、利用前に確認してください。保存先に機密情報が含まれる可能性があるため、Git への追加や外部同期に注意してください。

データと承認

質問は選択した Microsoft 365 エージェントへ送信され、取得した回答は呼び出し元の AI クライアントへ返されます。組織の規程に従い、必要最小限の情報だけを送ってください。ワークスペースの設定ファイルだけでは利用許可にならず、この端末での明示的な承認が必要です。

サインインには専用ブラウザープロファイルを使用します。通常のブラウザープロファイルを指定しないでください。プロファイルや承認情報はローカルに保存されます。詳細は セキュリティとデータの扱い を参照してください。

利用規約と商標

AgentPickLink は、Microsoft 365 Copilot の Web 画面を、利用者自身のサインイン済みセッションで、専用ブラウザープロファイルから自動操作します。Microsoft のサービス規約・製品条件、および所属組織の方針（テナント管理者の設定を含む）に従って利用してください。自動操作が許可されるかどうかは契約や組織の方針によって異なるため、導入前に管理者や担当部門へ確認することを推奨します。規約の順守と送信するデータについての責任は利用者にあります（MIT ライセンス の無保証条項を参照）。

本ツールは Microsoft と提携・承認・後援の関係にない独立したソフトウェアです。Microsoft、Microsoft 365、Microsoft Edge、Copilot、Visual Studio Code は Microsoft グループ企業の商標です。名称中の「for M365」は対応する製品を示すためのもので、Microsoft の商標やロゴは使用していません。その他の製品名・会社名は各社の商標です。

ドキュメント・ソース

• 設定ガイド

• トラブルシューティング

• 開発者向けビルド・テスト手順

• リリースノート

• ライセンス: MIT

• 利用 OSS・第三者ソフトウェア一覧

• 第三者ソフトウェアの著作権・ライセンス全文

開発者向けには agent-pick-link-0.2.5-source.zip を配布します。依存関係は package-lock.json に固定しており、展開したソースのみでインストール・テスト・ビルドできます。

CLI の出力・削除時の確認

--json のコマンド結果は stdout の単一 JSON オブジェクトです。進捗・確認は stderr に出ます（serve は MCP 通信専用、ヘルプ・版表示は対象外）。doctor は正常 0、問題あり 1、診断実行失敗 2。install は完了・dry-run 0、拒否・引数不正・導入失敗 1、クライアント未反映 2、一部導入・選択したクライアントの書き込み失敗・検証失敗 3 です（書き込めなかったクライアントは clientErrors に出ます）。integrations write / remove は、要求したクライアントをすべて反映できた場合 0、書き込み・削除できなかったクライアントがある場合 1 です。理由は errors に出ます。skipped は対応不要の項目だけです。

doctor --auth は認証状態、doctor --agent <エイリアス> は指定したエージェントの利用可否も確認します。認証が必要、アクセス拒否、無効、未確認の結果は findings に表示され、終了コードは 1 になります。これらのオプションを指定しない場合、検査していないことを失敗とは扱いません。診断は質問を送信せず、実際の回答やファイル取得を保証しません。

self prune は保持版・ランチャー・版記録・削除対象を照合します。不明なファイルやディレクトリー、不完全なパッケージ、リンク、不整合がある場合は何も削除せず停止します。--yes でも検証は省略しません。対象フォルダーを確認し、必要なファイルを別の場所に保管してから、壊れた情報を同じ場所への再インストールで修復してください。現行パッケージを配置しないソース参照インストールでは旧版整理を実行できません。

doctor は接続・認証・エージェント検査でエラーが起きても、該当項目に理由を含む診断結果を返して終了します（ok: false、終了コード 1）。診断結果自体を作れない場合は終了コード 2 です。解析できない連携設定は invalid として報告し、空のファイルは設定なしとして扱います。

integrations remove は解析できない設定を変更せず、errors の invalid-configuration と終了コード 1 で報告します。--force でも解析エラーは回避できません。integrations status は該当クライアントを invalid と表示します。self uninstall は削除できない連携設定を理由付きの skippedIntegrations に残し、アンインストールを続行します。残った設定は構文を修正してから手動で削除してください。

self uninstall は正規のインストール情報と実体を検証し、対象ブローカーの終了を確認してから削除します。--yes は確認の省略だけです。--purge-data は共有データを削除するため、別インストールのブローカーが稼働中なら拒否します。削除後も起動競合を防ぐ空の broker/startup.lock は残します。壊れたインストールは同じ場所に再インストールして修復してから削除してください。