利用可能なツール

Box MCPサーバーには、AIエージェントがBoxのコンテンツや機能を操作するためのツールが用意されています。ツールはカテゴリ別に分類されているため、自身のシナリオに適した機能をすばやく見つけることができます。

ユーザーと認証

ユーザー認証を管理し、認証済みユーザーに関する情報を取得します。

ツール	説明
`who_am_i`	現在認証されているBoxユーザーの詳細情報を返します。

ファイルとフォルダ

Boxファイルとフォルダのリソースに対するアクセス、管理、変更が可能です。これらのツールにより、コンテンツ、メタデータ、バージョン管理を制御できます。

読み取り専用

ツール	説明
`get_download_url`	Boxからバイナリファイルをダウンロードするための一時的な1回限りのURLを発行します。構成の詳細については、こちらを参照してください。
`get_file_content`	Boxに保存されているファイルのコンテンツを返します。
`get_file_details`	メタデータ、権限、バージョンの詳細など、Boxから詳細なファイル情報を返します。
`get_file_preview`	Boxに保存されているファイルのプレビューウィジェットを返します。
`get_folder_details`	メタデータ、権限、コラボレーション設定など、詳細なフォルダ情報を取得します。
`list_folder_content_by_folder_id`	フォルダに含まれるファイル、フォルダ、ウェブリンクのページ分割されたリストを取得します。ルートフォルダには`folder_id`「0」を使用します。 `id`、`type`、`name`、`etag`は常に返されます。 `limit`は省略可能なフィールドです。

書き込み

ツール	説明
`copy_file`²	既存のファイルをBox内の保存先フォルダにコピーします。
`copy_folder`²	既存フォルダをBox内の保存先の親フォルダにコピーします。
`create_folder`²	Box内にフォルダを作成します。
`create_metadata_template`	Enterpriseメタデータテンプレートを作成します。 `enterprise`スコープ、`display_name`、および省略可能な`fields`配列が必要です。
`get_upload_url`	Boxからバイナリファイルをアップロードするための一時的な1回限りのURLを発行します。構成の詳細については、こちらを参照してください。
`move_file`²	既存のファイルをBox内の保存先フォルダに移動します。ファイルIDは変更されず、`parent_folder_id`は必須です。
`move_folder`²	Box内のフォルダを新しい親フォルダに移動します。フォルダIDは変更されず、`parent_folder_id`は必須です。
`set_file_metadata`²	テンプレート用にファイルのカスタムメタデータを作成または更新 (アップサート) します。 `scope`、`template_key`、`fields`を確認するには、`list_metadata_templates`および`get_metadata_template_schema`を使用します。
`set_folder_metadata`²	テンプレート用にフォルダのカスタムメタデータを作成または更新 (アップサート) します。 `scope`、`template_key`、`fields`を確認するには、`list_metadata_templates`および`get_metadata_template_schema`を使用します。
`update_file_properties`²	名前、説明、タグ、コレクションなど、ファイルのプロパティを更新します。名前は最大255文字で指定でき、特に指定がない限り、ファイル拡張子は保持されます。説明は最大256文字で指定できます。タグは最大100個まで追加または更新できます。
`update_folder_properties`²	名前、説明、タグ、コレクションなど、フォルダのプロパティを更新します。名前は最大255文字で指定できます。`/`、`\`、`.`、`..`、先頭や末尾のスペースは使用しないでください。説明は最大256文字で指定できます。タグは最大100個まで更新できます。
`update_metadata_template`	アトミックスキーマ操作 (`addField`、`editField`、`removeField`など) を使用して、メタデータテンプレートのスコープと`template_key`を更新します。
`upload_file`²	新規ファイルをBoxにアップロードします。
`upload_file_version`²	ファイルコンテンツ全体を提供して新しいファイルバージョンをアップロードすることで、Box内の既存のファイルを更新します。

検索

キーワード、名前、または構造化メタデータクエリと省略可能なフィルタやスコープを使用して、コンテンツとコンテナを検索します。

ツール	説明
`get_metadata_template_schema`	メタデータテンプレートのスキーマとフィールドキーを返します。
`list_metadata_templates`	利用可能なBoxメタデータテンプレート (enterpriseまたはglobal) のリストを取得します。
`search_files_keyword`	キーワードを使用してファイルを検索します。メタデータフィルタ、ファイル拡張子によるフィルタ処理、フィールドの選択がサポートされています。
`search_files_metadata`	SQLに似たメタデータクエリを使用してファイルを検索します。パラメータ、フィールドの選択、フォルダの範囲指定を使用した複雑なフィルタ処理がサポートされています。
`search_folders_by_name`	キーワードの照合を使用して、Box内のフォルダを名前で検索します。

コラボレーション

コメント、共有リンク、コラボレーション管理ツールによりチームのコラボレーションを可能にします。

読み取り専用

ツール	説明
`list_file_comments`	ファイルのすべてのコメントのリストを取得します。
`list_item_collaborations`	項目の既存のすべてのコラボレーションのリストを取得します。
`list_tasks`	ファイルのすべてのタスク (ステータス、メッセージ、期日を含む) のリストを取得します。

書き込み

ツール	説明
`add_file_shared_link`¹	Boxファイルの共有リンクを作成または更新します。公開共有リンクの作成または組織外部からのコラボレータの追加が可能です。デフォルトではオフになっています。
`add_folder_shared_link`¹	Boxフォルダの共有リンクを作成または更新します。公開共有リンクの作成または組織外部からのコラボレータの追加が可能です。デフォルトではオフになっています。
`create_collaboration`¹	ユーザーまたはグループをファイル、フォルダ、またはHubに招待します。公開共有リンクの作成または組織外部からのコラボレータの追加が可能です。デフォルトではオフになっています。
`create_file_comment`²	ファイルにコメントを作成します。
`update_collaboration`¹	ファイル、フォルダ、またはHubのコラボレーションを更新します。公開共有リンクの作成または組織外部からのコラボレータの追加が可能です。デフォルトではオフになっています。

Box AI

AIを活用したツールを使用して、質問、インサイトの抽出、ファイルやHubでのコンテンツの分析を行います。

ツール	説明
`ai_extract_freeform`	Box AIを使用して、自然言語のプロンプト (固定テンプレートなし) でファイルからメタデータを抽出します。テキストレプリゼンテーションは最大1 MBまで対応しています。ドキュメント、PDF、プレゼンテーション、テキストをサポートしています。 1つ以上の`file_ids`を使用できます。
`ai_extract_structured`	Box AI抽出エージェント (強化) とカスタムフィールドの定義を使用して、ファイルからキーと値による構造化メタデータを抽出します。
`ai_extract_structured_from_fields`	Box AIとカスタムフィールドの定義を使用して、ファイルから構造化メタデータを抽出します。 1つ以上のファイルを使用できます。フィールドタイプには、`string`、`date`、`float`、`enum`、`multiSelect`が含まれます。
`ai_extract_structured_from_fields_enhanced`	Box AI抽出エージェント (強化) とカスタムフィールドの定義を使用して、ファイルから構造化メタデータを抽出します。ユーザーが抽出エージェント (強化) を指定した場合にのみ使用します。このツールは、標準のBox AI Extractツールよりもコストがかかります。フィールドタイプには、`string`、`date`、`float`、`enum`、`multiSelect`が含まれます。
`ai_extract_structured_from_metadata_template`	既存のBoxメタデータテンプレートを使用して、ファイルから構造化メタデータを抽出します。 `template_key`と`scope` (例: `enterprise`や`global`) が必要です。ファイルコンテンツのテキストレプリゼンテーションを処理します。
`ai_extract_structured_from_metadata_template_enhanced`	既存のBoxメタデータテンプレートと抽出エージェント (強化) を使用して、ファイルから構造化メタデータを抽出します。ユーザーが抽出エージェント (強化) を指定した場合にのみ使用します。このツールは、標準のBox AI Extractツールよりもコストがかかります。
`ai_qa_hub`	Box Hubについて質問し、そのHubのコンテンツに基づいて回答を返します。可能な場合は、引用情報も表示します。
`ai_qa_multi_file`	Box AIを使用して複数のファイルについて質問します。可能な場合は、引用情報も表示します。
`ai_qa_single_file`	Box AIを使用して単一のファイルについて質問します。可能な場合は、引用情報も表示します。テキストレプリゼンテーションは最大1 MBまで対応しています。ファイルがこのサイズを超える場合は、最初の1 MBのみ処理されます。

Hubs

Box Hubsを作成および管理して、特定のトピックやプロジェクトに関するコンテンツとリソースのコラボレーションを整理します。

読み取り専用

ツール	説明
`get_hub_details`	特定のHubに関する詳細情報を取得します。
`get_hub_items`	特定のHubに関連付けられた項目 (ファイルやフォルダ) を取得します。
`list_hubs`	認証済みユーザーがアクセス可能なすべてのHubのリストを取得します。

書き込み

ツール	説明
`add_items_to_hub`²	ファイル、フォルダ、またはウェブリンクをHubに追加します。
`copy_hub`²	既存のHubのコピー (構造と設定を含む) を作成します。元のHubは変更されません。新しいタイトルは最大50文字で指定可能です。指定しなかった場合は、デフォルトのタイトルが使用されます。
`create_hub`	Hubを作成します。
`update_hub`²	Hubのタイトルと説明を更新します。

Doc Gen

プレースホルダタグ付きのテンプレートを使用してドキュメント生成を自動化し、カスタムドキュメントを大規模に作成します。

読み取り専用

ツール	説明
`get_docgen_template_by_id`	Doc Genテンプレートの詳細を取得します。
`list_docgen_templates`	認証済みユーザーがアクセス可能なすべてのBox Doc Genテンプレートのリストを取得します。

書き込み

ツール	説明
`create_docgen_batch`	指定されたデータをプレースホルダタグに入力して、Doc Genテンプレートからドキュメントを生成します。
`create_docgen_template`	Boxファイル (`.docx`または`.pptx`) を、ドキュメント生成を自動化するためのDoc Genテンプレートとして設定します。

アップロードとダウンロードのURLのツール

アップロードとダウンロードのURLのツールを使用するには、AIエージェントがファイル転送のために直接ネットワークリクエストを実行する必要があります。宣言型エージェントにはその機能がないため、これらのツールはエージェント型 (コード実行可能な) 環境でのみサポートされています。

一部のクライアントでは、アップロードとダウンロードのURLが正しく機能するように、ドメインを許可リストに登録する必要があります。 Zonesを利用していないお客様の場合、許可リストには以下のドメインが含まれます。

upload.box.com
upload.app.box.com
upload.ent.box.com
dl.boxcloud.com
public.boxcloud.com

必要なドメインは、ご利用のBox Zoneによって異なります。詳細なリストについては、Box Zonesの新しいドメインを参照してください。また、ワイルドカードドメインを使用して、すべてのサブドメインを許可することもできます。

upload.*.box.com
*.boxcloud.com
*.box.com

フィードバック

Box MCPサーバーについてフィードバックの提供や質問を行うには、Box Developer CommunityフォーラムのBox AI APIスレッドを参照してください。

¹ Claudeのみ、まもなく他のクライアントにも対応予定。 ² 以下の条件をすべて満たしている項目でのみ機能します。

項目自体に外部コラボレータが存在しない

項目自体に共有リンクが存在しない

ルートフォルダに至るまでのすべての親フォルダに外部コラボレータまたは共有リンクが存在しない

​ユーザーと認証

​ファイルとフォルダ

​読み取り専用

​書き込み

​検索

​コラボレーション

​読み取り専用

​書き込み

​Box AI

​Hubs

​読み取り専用

​書き込み

​Doc Gen

​読み取り専用

​書き込み

​アップロードとダウンロードのURLのツール

​フィードバック

ユーザーと認証

ファイルとフォルダ

読み取り専用

書き込み

検索

コラボレーション

読み取り専用

書き込み

Box AI

Hubs

読み取り専用

書き込み

Doc Gen

読み取り専用

書き込み

アップロードとダウンロードのURLのツール

フィードバック