https://mcp.box.com) を使用します。エージェントがコードを実行する場合は、Box API、SDK、またはを使用します。いずれの場合も、エージェントが参照できるのは、認証されたユーザーまたはアプリケーションがすでにアクセス権限を持っているファイルのみです。
どのようなエージェントプラットフォームをBoxに接続しても、ファイル権限を回避することはありません。Boxはすべてのリクエストでコラボレーション、ウォーターフォール型のフォルダ権限、およびアプリケーションスコープを確認します。
アクセス権限の仕組み
すべてのリクエストに以下の3つのレイヤーが適用されます。
MCPサーバーが他のユーザーになりすましたり、IDがすでに権限を持っていない限り企業内を検索したりすることはありません。 を参照してください。
IDを選択する
エンドユーザーOAuth (MCPのデフォルト)
エンドユーザーOAuth (MCPのデフォルト)
エージェントは、サインインしたBoxユーザーとして動作します。この方法は、そのユーザーのファイルを操作するアシスタントに使用します。たとえば、Copilot、Cursor、Claude、Foundry Toolsなどのクライアントが該当します。管理コンソールでMCPを有効にし、統合資格情報を作成したうえで、エージェントに必要なスコープのみをリクエストします。を参照してください。
サービスアカウントまたはCCG (自動化)
サービスアカウントまたはCCG (自動化)
サーバー側ジョブ (アップロード時の抽出、Hubへの公開、スケジュール設定されたレビュー) では通常、を利用するサービスアカウントとして認証します。そのサービスアカウントを特定のフォルダにコラボレータとして追加します。対話型エージェントに対して、サービスアカウントを隠れたスーパーユーザーとして利用しないでください。また、資格情報をブラウザや信頼できない実行環境に渡す場合は、トークンをダウンスコープします。を参照してください。
本番環境とローカルテスト
ツールを学習する段階では、とサンプルファイルを利用します。チュートリアルでは、ローカルの設定について説明し、コーディングエージェントに本番環境のコンテンツへのアクセスを許可しないよう注意喚起しています。 本番環境の場合:- 管理者が管理コンソールでMCPを有効にします (またはPlatformアプリを承認します)。
- 専用の統合資格情報を作成し、必要なスコープのみをリクエストします。
- Boxユーザーまたはサービスアカウントを慎重に選択します。エージェントがアクセスする必要があるフォルダにコラボレータとして追加します。
- そのIDでテストを実施します。検索や質問でファイルが表示されない場合は、モデルではなく、まずコラボレーションを確認してください。
Microsoftのエージェントプラットフォーム
GitHub CopilotおよびMicrosoft Foundry Toolsは、MCPを介してBoxに接続します。権限モデルは以下のように他のクライアントと同じです。- 接続を承認したBoxユーザーがIDとなります。
- 管理者が構成したスコープにより、クライアントがリクエストできるアクション数の上限が決まります。
- Boxファイルに対する権限がSharePointやGraphの権限に置き換えられることはありません。
関連パターン
- HubsとAskを利用して、厳選されたナレッジベースに対してクエリを実行する:
- ベクトルインデックスにエクスポートする前にまずBoxによって管理される取得を利用する:
