Box MCP

Boxの公式Remote MCPサーバーを通じて、Boxに保存されたファイルやコンテンツに安全にアクセスできます。

概要

Boxは公式Remote MCPサーバー（https://mcp.box.com）を提供しています。このサーバーを通じて、AIエージェントがBoxに保存されたファイルの検索、閲覧、管理を行い、Box AI機能を活用できます。

QueryPie AIPでは、この公式MCPサーバーを事前構成されたRemote MCPとして提供しています。連携にはBox Developer ConsoleでClient IDとClient Secretを取得する必要があります。

サポート機能

Box公式MCPサーバーは以下の機能をサポートしています：

• ファイル管理: ファイルの閲覧、アップロード、プロパティ更新
• フォルダ管理: フォルダの作成、詳細表示、コンテンツ一覧
• 検索: キーワードベースのファイル検索、メタデータベースの検索、フォルダ検索
• Box AI: メタデータ抽出（フリーフォーム・構造化、Enhanced対応）
• コラボレーション: ファイルコメント、コラボレーター一覧、タスク管理
• Hubs: Hubの作成、管理、アイテム追加

サポートするMCPツール

ユーザー管理ツール

who_am_i

現在認証されているBoxユーザーのプロフィール情報を取得します。

ファイル管理ツール

get_file_details

ファイルの詳細情報（名前、サイズ、作成/更新日時、権限など）を取得します。

get_file_content

ファイルのテキストコンテンツを抽出します（50MB以下）。PDF、ドキュメント、スプレッドシート、プレゼンテーション、コードファイルなどをサポートしています。テキスト表現がないファイルはエラーが返されます。

upload_file

Boxに新しいファイルをアップロードします。対象フォルダを指定できます。

upload_file_version

既存ファイルの新しいバージョンをアップロードします。upload_fileと同様にテキストコンテンツのみサポートしています。

update_file_properties

ファイルの名前、説明、タグ、コレクションなどのメタデータを更新します。

フォルダ管理ツール

list_folder_content_by_folder_id

フォルダ内のファイル、フォルダ、Webリンクの一覧を取得します。ルートフォルダにはID "0" を使用します。

get_folder_details

フォルダの詳細情報を取得します。

create_folder

新しいフォルダを作成します。

update_folder_properties

フォルダの名前、説明、タグ、コレクションなどのメタデータを更新します。

検索ツール

search_files_keyword

キーワードでファイルを検索します。拡張子フィルター、日付範囲、メタデータフィルターをサポートしています。

search_folders_by_name

フォルダ名で検索します。特定の親フォルダ内に範囲を制限できます。

search_files_metadata

SQLライクなメタデータクエリでファイルを検索します。

Box AIツール

ai_extract_structured_from_metadata_template

既存のメタデータテンプレートに基づいて、ファイルから構造化メタデータを抽出します。

ai_extract_structured_from_metadata_template_enhanced

Enhanced Extract Agentを使用して、メタデータテンプレートベースの高度な抽出を行います。標準ツールよりコストが高いため、明示的にリクエストされた場合にのみ使用されます。

ai_extract_structured_from_fields_enhanced

カスタムフィールド定義に基づいて、Enhanced Extract Agentを使用して構造化メタデータを抽出します。string、float、date、enum、multiSelectタイプをサポートしています。標準ツールよりコストが高いため、明示的にリクエストされた場合にのみ使用されます。

コラボレーションツール

list_file_comments

ファイルのコメント一覧を取得します。

create_file_comment

ファイルにコメントを追加します。

list_item_collaborations

ファイルとフォルダのコラボレーター一覧を取得します。最大10アイテムを同時に照会できます。

list_tasks

ファイルに割り当てられたタスク一覧を取得します。

Hubsツール

list_hubs

アクセス可能なHub一覧を取得します。

get_hub_details

特定のHubの詳細情報を取得します。

get_hub_items

Hub内のアイテム（ファイル、フォルダ、Webリンク）を取得します。

create_hub

新しいHubを作成します。

add_items_to_hub

Hubにファイル、フォルダ、Webリンクを追加します。

update_hub

Hubのタイトルや説明を更新します。

Client ID / Secretの取得方法

Step 1: Box Developer Consoleにアクセス

1. Box Developer Console にアクセスします。
2. Boxアカウントでログインします。

Step 2: OAuthアプリの作成

1. Create New Appをクリックします。
2. Custom Appを選択し、認証方式としてUser Authentication (OAuth 2.0)を選択します。
3. アプリ名を入力します（例：QueryPie AIP）。
4. アプリ作成後、Configurationタブに移動します。

Step 3: OAuth設定

1. OAuth 2.0 Redirect URIにAIPが提供するOAuthコールバックURLを入力します。
2. Application ScopesでWrite all files and folders stored in Boxをチェックします。
3. Client IDとClient Secretをコピーします。

Step 4: AIPでの連携設定

1. QueryPie AIP管理画面でBox MCP項目を選択します。
2. 取得したClient IDとClient Secretを入力します。
3. 連携を完了します。

参考資料

• Box公式ドキュメント: Remote Box MCP server 
• Box Developer Console