利用可能なツール

Box MCPサーバーでは、AIエージェントがBoxのコンテンツや機能を操作できるようにするツールを利用できます。これらのツールはカテゴリ別に分類されているため、シナリオに適合した機能をすばやく見つけることができます。 [デフォルト] 列に [オフ] と表示されているツールは、管理者が有効にする必要があります。手順については、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スレッドを参照してください。

​ユーザーと認証

​ファイルとフォルダ

​読み取り専用

​書き込み

​検索

​コラボレーション

​読み取り専用

​書き込み

​Box AI

​Hub

​読み取り専用

​書き込み

​Doc Gen

​読み取り専用

​書き込み

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

​フィードバック

ユーザーと認証

ファイルとフォルダ

読み取り専用

書き込み

検索

コラボレーション

読み取り専用

書き込み

Box AI

Hub

読み取り専用

書き込み

Doc Gen

読み取り専用

書き込み

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

フィードバック