利用可能なツール

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

ユーザーと認証

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

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

ファイルとフォルダ

Boxのファイルやフォルダにあるリソースにアクセスして、管理と変更を行うことができます。このツールを使用して、コンテンツ、メタデータ、バージョン管理を制御できます。

読み取り専用

ツール	説明
`get_download_url`	Boxからバイナリファイルをダウンロードするための、1回のみ使用できる一時的なURLを発行します。構成の詳細については、アップロードURLツールとダウンロード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を発行します。構成の詳細については、アップロードURLツールとダウンロードURLツールを参照してください。
`move_file`¹	既存のファイルをBox内の宛先フォルダに移動します。ファイルIDは変更されず、`parent_folder_id`の指定が必須です。
`move_folder`¹	フォルダをBox内の新しい親フォルダに移動します。フォルダIDは変更されず、`parent_folder_id`の指定が必須です。
`set_file_metadata`¹	テンプレート用のファイルに対して、カスタムメタデータを作成または更新 (アップサート) します。`list_metadata_templates`と`get_metadata_template_schema`を使用して、`scope`、`template_key`、および`fields`を検索します。
`set_folder_metadata`¹	テンプレート用のフォルダに対して、カスタムメタデータを作成または更新 (アップサート) します。`list_metadata_templates`と`get_metadata_template_schema`を使用して、`scope`、`template_key`、および`fields`を検索します。
`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のみ処理されます。

Hub

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

読み取り専用

ツール	説明
`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`) を、ドキュメント生成を自動化するためのドキュメント生成テンプレートとして設定します。

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

アップロードURLツールとダウンロードURLツールを使用するには、AIエージェントがファイル転送リクエストをネットワークに直接送信できる必要があります。宣言型エージェントはそのようなリクエストを実行できないため、これらのツールはエージェント型 (コード実行型) 環境でのみ動作します。クライアントによっては、アップロードURLとダウンロードURLが機能するために、特定のドメインを許可リストに登録しておく必要があります。 Box Zonesをお使いでない場合は、以下のドメインを許可リストに追加します。

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

必要となるドメインは、ご利用のBox Zoneに応じて異なります。詳細なリストについては、Boxアプリケーションおよびサービス用のファイアウォールの設定を参照してください。ワイルドカードドメインを使用して、すべてのサブドメインを許可することもできます。

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

フィードバック

Box MCPサーバーに関するフィードバックや質問を共有するには、Box Developer CommunityフォーラムのBox AI APIスレッドを参照してください。

¹ Only works on items that meet all of the following:

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

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

ルートフォルダを含むすべての親フォルダに、外部コラボレータや共有リンクが存在しない

​ユーザーと認証

​ファイルとフォルダ

​読み取り専用

​書き込み

​検索

​コラボレーション

​読み取り専用

​書き込み

​Box AI

​Hub

​読み取り専用

​書き込み

​Doc Gen

​読み取り専用

​書き込み

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

​フィードバック

ユーザーと認証

ファイルとフォルダ

読み取り専用

書き込み

検索

コラボレーション

読み取り専用

書き込み

Box AI

Hub

読み取り専用

書き込み

Doc Gen

読み取り専用

書き込み

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

フィードバック