ツールのアクセス権限の仕組み
Box MCPサーバーツールのアクセス権限は、企業全体と、個別の統合またはPlatformアプリの2つのレベルで制御できます。
すべての公開されている統合と未公開Platformアプリは、デフォルトで、企業全体の構成に従います。 このデフォルト構成は、個々の統合またはアプリの [Box MCPサーバー] タブで [カスタム構成] を設定するまで適用されたままになります。設定したカスタム構成は、その統合またはアプリに対してのみ優先的に適用されます。
Boxでは、以下の順に設定が適用されます。
- [カスタム構成] — 統合またはPlatformアプリに設定されている場合、その統合またはアプリにのみ適用されます。
- [グローバル構成] — 独自のカスタム構成が設定されていない統合またはPlatformアプリに適用されます。
企業全体のアクセス権限
グローバル構成は、すべてのユーザーと、独自のカスタム構成が設定されていない統合またはPlatformアプリに適用されます。 企業全体のツール設定を開くには、以下の手順に従います。- [管理コンソール] を開きます。
- 左のサイドバーで、[統合] を選択します。
- [Box MCPサーバー] タブを選択します。
- ツールカテゴリごと
- 個々のツールごと
- その両方
![ツールカテゴリが表示されている、管理コンソールの [Box MCPサーバー] タブ。各ツールカテゴリに [有効化] ドロップダウンと 構成] ボタンがあります。
[Box Hubs] や [Box AIとエージェント] などの一部のカテゴリは、すべての企業で利用できるとは限りません。 詳細については、お客様のサブスクリプションを確認してください。
カテゴリ全体のアクセス権限の設定
カテゴリ全体のアクセス権限を設定するには、以下の手順に従います。- Box MCPサーバーの表で、構成するカテゴリを見つけます。
- [有効化] ドロップダウンを選択します。
- 以下のアクセスレベルのいずれかを選択します。
- [すべてのツールを無効にする] — このカテゴリのツールは利用できなくなります。
- [読み取り専用ツールを有効にする] — データを読み取るツールのみが利用可能です。
- [読み取りおよび書き込み可能なツールを有効にする] — このカテゴリのすべてのツール (データを作成または変更するツールを含む) が利用可能です。
- [カスタム構成] — このカテゴリのどのツールを利用可能にするかを個別に選択します。
個々のツールのアクセス権限の設定
カテゴリ内の特定のツールへのアクセス権限を制御するには、以下の手順に従います。- Box MCPサーバーの表で、構成するカテゴリを見つけます。
- [構成] を選択します。
![カテゴリ設定ウィンドウ。個々のツールの切り替えボタンが \[読み取り専用のMCPツール\] と \[書き込み可能なMCPツール\] に分類されています。](https://mintcdn.com/product-docs/FMO6xwrbfPypBoFJ/images/box-mcp/images/Individual_Tools.png?fit=max&auto=format&n=FMO6xwrbfPypBoFJ&q=85&s=26f69d82978bdc2327be1bf770215c37)
- [有効化] オプションを選択すると、カテゴリ内の切り替えボタンがすべて更新されます。
- 個々の切り替えを変更すると、[有効化] の選択内容が更新されます。
- 読み取り専用ツールのみを有効にすると、[読み取り専用ツールを有効にする] が選択されます。
- すべてのツールを有効にすると、[読み取りおよび書き込み可能なツールを有効にする] が選択されます。
- すべてのツールを無効にすると、[すべてのツールを無効にする] が選択されます。
- それ以外の組み合わせでは、[カスタム構成] が選択されます。
特定の統合またはアプリのアクセス権限
特定の統合またはPlatformアプリに対してツールのアクセス権限を設定し、その統合やアプリに限定して、企業全体のデフォルト設定を上書きすることもできます。 これにより、各AIプラットフォームを個別に管理しつつ、それ以外のすべてについて企業全体で統一的な基準を維持できます。 各統合およびPlatformアプリには専用の [Box MCPサーバー] タブがあり、そこで、ツールのアクセス権限の適用方法を選択できます。- [グローバル構成] — 企業全体の設定を継承します。 これがデフォルトです。
- [カスタム構成] — その統合またはアプリ専用のツールのアクセス権限を設定し、企業全体の設定を上書きします。
カスタム構成は、その統合またはアプリにアクセスできるすべてのユーザーに適用されます。ユーザー単位やグループ単位でのアクセス制御には対応していません。
統合に対するツールのアクセス権限の設定
- [管理コンソール] を開きます。
- 左のサイドバーで、[統合] を選択します。
- 構成する統合を見つけます。 リストを絞り込むには、[MCP] カテゴリでフィルタをかけるか、名前で検索します。
- 対象の統合の [構成] を選択します。
- 表示されたウィンドウで、[Box MCPサーバー] タブを選択します。
- [カスタム構成] を選択します。
- カテゴリを選択して展開し、各ツールの切り替えボタンを使用してツールを有効または無効にします。 リストを特定のスコープに絞り込むには、カテゴリの上にある [すべて]、[読み取り専用]、または [書き込み専用] フィルタを選択します。
- [保存] を選択します。
![[カスタム構成] が選択された、Claude統合の [Box MCPサーバー] タブ。[すべて]、[読み取り専用]、[書き込み専用] の各フィルタが表示されているほか、ファイルとフォルダ] カテゴリが展開され、個々のツールの切り替えボタンが表示されています。
[Box MCPサーバー] タブを使用すると、統合で使用可能なツールを制御できます。 管理対象ユーザーとグループがその統合にアクセスできるかどうかを制御するには、代わりに [利用状況] タブを使用してください。 どちらのタブにも [カスタム構成] オプションがありますが、管理する対象が異なります。
Platformアプリに対するツールのアクセス権限の設定
- [管理コンソール] を開きます。
- 左のサイドバーで、[Platform] を選択します。
- ウィンドウの上部にある [Platformアプリ] タブを選択します。
- 構成するアプリを探して、その名前を選択します。
- アプリの詳細ページで [Box MCPサーバー] タブを選択します。
- [カスタム構成] を選択します。
- カテゴリを選択して展開し、各ツールの切り替えボタンを使用してツールを有効または無効にします。 変更はすぐに適用されます。
ツールを無効にした場合
企業全体、または特定の統合やPlatformアプリに対してツールを無効にすると、以下のようになります。- MCPクライアントに返されるツールリストから削除されます。
- エージェントはそのツールを検出することも使用することもできなくなります。
- Boxは、実行時にその変更を適用します。
- Box MCPサーバーから次のようなエラーが返されます。
Tool has been disabled by the enterprise admin. Contact your enterprise admin for more information. (ツールは企業の管理者によって無効になっています。詳細については、企業の管理者にお問い合わせください。)アクティブなセッション中は、代わりに一般的なエラー (「ツールが見つかりません」など) がユーザーに表示される場合があります。 正確なメッセージはMCPクライアントによって異なります。
一部のMCPクライアントではツールリストがキャッシュされます。 ツールを有効または無効にした後も、エージェントは、キャッシュされたリストを参照して、使用できなくなったツールを呼び出そうとする可能性や新しく有効になったツールをまだ認識していない可能性があります。 その場合は、MCPクライアントを一度閉じて再度起動すると、更新されたツールリストを取得できます。
書き込み可能なツールのセキュリティガードレール
セキュリティガードレールは、Enterprise Advancedアカウントでのみ利用できます。
- [コンテンツの制限]: ツールがアクションを実行できる場所。例えば、特定のフォルダやHub、特定の分類ラベルが設定されたコンテンツなど。
- [管理対象ユーザーの基準]: ツールの対象にできる管理対象ユーザー。
- [外部ユーザーの基準]: ツールが外部ユーザーとどのようにやり取りできるか。
サポートされているツール
ガードレールは、[ファイルとフォルダ] および [コラボレーション] カテゴリの一部の書き込み可能なツールで使用できます。 ガードレールをサポートしているツールを確認するには、利用可能なツールのガードレール列を確認してください。 ガードレールは読み取り専用ツールには適用されません。 エージェントが読み取ることのできるコンテンツを制御するには、Shieldのスマートアクセスポリシーを使用します。ガードレールの構成
企業全体のBox MCPサーバー設定では、ツールを有効にする際に、ツールごとにガードレールを構成します。 Box MCPサーバーツールを有効または無効にする場合と同じ管理者権限が必要です。 ツールのガードレールを構成するには、以下の手順に従います。- [管理コンソール] を開きます。
- 左のサイドバーで、[統合] を選択します。
- [Box MCPサーバー] タブを選択します。
- 対象のツールが含まれているカテゴリを見つけ、[構成] を選択します。
- [書き込み可能なMCPツール] でツールを有効にし、そのツールのガードレール設定を開きます。
- 必要に応じて、[コンテンツの制限]、[管理対象ユーザーの基準]、[外部ユーザーの基準] を設定します。 利用可能な基準はツールによって異なります。 各オプションの詳細については、高度なガードレールの構成を参照してください。
- [保存] を選択します。
- ツールが企業全体と統合またはアプリの両方で有効になっている場合は、企業全体のガードレールが適用されます。
- ツールが統合またはアプリでのみ有効になっていて、企業全体では有効になっていない場合、ガードレールは適用されません。
ガードレールは、企業レベルまたはフォルダレベルの制限を上書きするものではありません。 MCPクライアントを接続したユーザーの権限も、選択したガードレールに加えて引き続き適用されます。
ガードレールによってアクションがブロックされる場合
リクエストがガードレールのルールに違反している場合、Boxはそのアクションを実行しません。 Box MCPサーバーから、セキュリティガードレールによってアクションがブロックされたことを示す構造化エラーがエージェントに返されます。 MCPクライアントによっては、エージェントがこのエラーをユーザーに表示するか、別の方法を試す場合があります。ツールの変更の監査
特定の統合またはPlatformアプリに対する変更を含め、ツールの設定がいつ、どのように変更されたかを確認するには、以下の手順に従います。- [管理コンソール] を開きます。
- 左のサイドバーで、[レポート] をクリックします。
- [レポート作成] を選択し、[セキュリティログ] を選択します。
- [統合] で [MCPツールの有効化ステータスの変更] を選択します。
詳細については、[セキュリティログ] レポートを参照してください。
Boxでは、セキュリティガードレールの構成に対するすべての変更も、Enterprise Event Streamに記録されます。 これらのイベントを取得するには、Events APIを使用します。