> ## Documentation Index
> Fetch the complete documentation index at: https://docs.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 利用可能なツール

<div className="article_labels_list" style={{display: 'none'}} dangerouslySetInnerHTML={{__html: "End User , Box MCP , Overview , Article , Product Utilization , Established"}} />

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

## ユーザーと認証

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

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

## ファイルとフォルダ

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

### 読み取り専用

| ツール                                | 説明                                                                                                                                         |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `get_file_content`                 | Boxに保存されているファイルのコンテンツを返します。                                                                                                                |
| `get_file_details`                 | メタデータ、権限、バージョンの詳細など、Boxから詳細なファイル情報を返します。                                                                                                   |
| `get_file_preview`                 | Boxに保存されているファイルのプレビューウィジェットを返します。                                                                                                          |
| `get_folder_details`               | メタデータ、権限、コラボレーション設定など、詳細なフォルダ情報を取得します。                                                                                                     |
| `list_folder_content_by_folder_id` | フォルダに含まれるファイル、フォルダ、ウェブリンクのページ分割されたリストを取得します。 <br />ルートフォルダには`folder_id`「0」を使用します。 `id`、`type`、`name`、`etag`は常に返されます。 `limit`は省略可能なフィールドです。 |

### 書き込み

| ツール                        | 説明                                                                                                                                                    |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `copy_file`                | 既存のファイルをBox内の保存先フォルダにコピーします。                                                                                                                          |
| `create_folder`            | Box内にフォルダを作成します。 このフォルダは、外部コラボレーションが有効になっていない親フォルダまたは共有リンクが設定されていない親フォルダ内でのみ作成可能です。 この制限は親フォルダの親にも適用されます。                                             |
| `create_metadata_template` | Enterpriseメタデータテンプレートを作成します。 `enterprise`スコープ、`display_name`、および省略可能な`fields`配列が必要です。                                                                 |
| `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ファイルの共有リンクを作成または更新します。                                | Claudeのみ、まもなく他のクライアントにも対応予定 |
| `add_folder_shared_link` | Boxフォルダの共有リンクを作成または更新します。                                | Claudeのみ、まもなく他のクライアントにも対応予定 |
| `create_collaboration`   | ユーザーまたはグループをファイル、フォルダ、またはHubに招待します。                      | Claudeのみ、まもなく他のクライアントにも対応予定 |
| `create_file_comment`    | ファイルにコメントを作成します。 外部コラボレータまたは共有リンクが設定されていないファイルにのみ利用可能です。 | すべてのクライアント                  |
| `update_collaboration`   | ファイル、フォルダ、またはHubのコラボレーションを更新します。                         | Claudeのみ、まもなく他のクライアントにも対応予定 |

## Box AI

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

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

## フィードバック

Box MCPサーバーについてフィードバックの提供や質問を行うには、Box Developer Communityフォーラムの[Box AI APIスレッド](https://community.box.com/box-ai-api-8)を参照してください。