リモートBox MCPサーバー
リモートBox MCPサーバー
リモートBox MCPサーバーは、AIエージェントがBoxなどのサードパーティ製アプリケーションに接続して操作するための標準的な方法で、プラットフォーム間でのコンテンツやAI機能へのシームレスなアクセスを可能にします。Box MCPサーバーは、主要なAIエージェントプラットフォーム (Copilot Studio、Claude Enterprise、Mistral Le Chatなど) が未加工のファイルコンテンツを公開することなく、BoxのデータやAIを活用したツールを安全に照会および利用できるようにする橋渡しの役割を果たします。OAuth承認により、ユーザーは、自身のBoxアカウントへの制限付きアクセスをAIエージェントに許可することができるため、このような外部のAI環境内で直接、インテリジェントなドキュメント処理、高度な検索、複数ファイルのAIクエリが可能になります。
あらかじめ定義されたBox MCPサーバーにアクセスして管理する
- Box管理コンソールのサイドバーにある [統合] をクリックします。
- [カテゴリ] フィルタを使用して [MCP] を選択するか、ウィンドウ上部にある検索フィールドであらかじめ定義されたBox MCPサーバーを検索します。
- 選択したMCPサーバーの横にある状態をクリックし、有効にする状態を選択します。
リストに記載されていないBox MCPサーバーを作成する
- Box管理コンソールのサイドバーにある [統合] をクリックします。
- ウィンドウ上部にある検索フィールドでBox MCP Serverを検索します。
- [Box MCP Server] アプリケーションにカーソルを合わせ、[構成] をクリックします。
- [追加の構成] セクションで [+ 統合資格情報を追加] をクリックします。
- 生成されたクライアントIDとクライアントシークレットをコピーします。
- 外部MCPクライアントから提供されたリダイレクトURIを入力します。
- [スコープ] で [AIリクエストの管理] が選択されていることを確認します。
クライアント側でBox MCPサーバーを追加する
AIエージェントプラットフォームからBoxに接続するには、以下の操作を行う必要があります。
- エンドポイントURL:
https://mcp.box.com
- クライアントIDとクライアントシークレット: これらは、上記のBox MCPサーバーの構成時に管理コンソールの統合資格情報のセクションで生成されます。
- MCP名を渡す:
box-remote-mcp
authorization_token
を指定する
正確な手順はAIプラットフォームによって異なる場合があります。クライアント側での設定手順については、お使いのプラットフォームのドキュメントを参照してください。参考までに、次のサンプルコードを確認してください。
response = await client.beta.messages.create(
model="claude-3-opus-20240229", # Or your preferred model
max_tokens=4096,
messages=conversation_history,
mcp_servers=[
{
"type": "url",
"url": "https://mcp.box.com",
"name": "box-remote-mcp",
"authorization_token": BEARER_TOKEN,
}
],
betas=["mcp-client-2025-04-04"]
)
Claude
ClaudeでリモートBox MCPサーバーの使用を開始するには、Claudeアプリの設定に移動し、[Connectors (コネクタ)] をクリックします。このビューで [Browse connectors (コネクタを参照)] をクリックして [Box] を選択し、ClaudeにBoxへのアクセスを許可します。
Box MCPをClaudeデスクトップアプリと関連付ける方法を紹介するデモ動画をご確認ください。
Copilot Studio
リモートBox MCPサーバーを追加するには、Copilot Studio側が提供する手順に従います。詳細な手順とガイダンスは、こちらのMicrosoftの公式ドキュメントで確認できます: Add an MCP Server in Copilot Studio
Azure API Center
Azure API CenterのEnterprise RegistryにリモートBox MCPサーバーを追加するには、Azureが提供する手順に従います。詳細な手順とガイダンスは、こちらのMicrosoftの公式ドキュメントで確認できます: Add an MCP Server in Azure API Center's Enterprise Registry
AnthropicのMessages API
リモートBox MCPサーバーをAnthropicのMessages APIと関連付けます。こちらのサンプルチャットボットプロジェクトを複製すると、すぐに作業を開始できます。これにより、Anthropicモデルとの会話が可能になり、BoxのリモートMCPサーバーが提供するツールにアクセスできます。
リモートBox MCPを利用しているReactベースのチャットボットのデモプロジェクトを紹介する動画をご覧ください。
Mistral AIのLe Chat
Mistral AIのLe Chatに対してBox MCPを有効にするには、コネクタのページにアクセスし、[Connect (接続)] をクリックして、Boxへのアクセスを許可します。または、チャットビューから直接、[Tools (ツール)] をクリックして [Box] を選択します。
MCPサーバーでのBox AIの機能の使用
サードパーティ製アプリケーションでBox AIを使用すると、Box MCPサーバー経由でアプリケーションにアクセスするため、最適なエクスペリエンスと質の高い結果を得ることができます。これにより、すべての機能、パフォーマンスの向上、シームレスなユーザーエクスペリエンスが実現します。
利用可能なツール
リモートBox MCPサーバーには、使用できるツールがいくつかあります。
ツール | 説明 |
---|---|
who_am_i | 現在認証されているBoxユーザーの詳細な情報を返します。 |
get_file_content | Boxに保存されているフ ァイルのコンテンツを返します。 |
search_folders_by_name | キーワードの照合を使用して、名前でBox内のフォルダを検索します。 |
list_folder_content_by_folder_id | フォルダ内のファイル、フォルダ、ウェブリンクのリストを取得します。 |
search_files_keyword | キーワードを使用してファイルを検索します。メタデータフィルタ、ファイル拡張子によるフィルタ処理、フィールドの選択がサポートされています。 |
search_files_metadata | SQLに似たメタデータクエリを使用してファイルを検索します。パラメータを使用した複雑なフィルタ処理、フィールドの選択、フォルダの範囲指定がサポートされています。 |
ai_qa_single_file | Box AIを使用して単一のファイルに質問します。 |
ai_qa_multi_file | Box AIを使用して複数のファイルに質問します。 |
ai_qa_hub | Box AIを使用してBox Hubに質問します。 |
ai_extract_freeform | Box AIを使用して、ファイルから自由形式でメタデータを抽出します。あらかじめ定義されたテンプレート構造は必要ありません。 |
ai_extract_structured | Box AIを使用して、ファイルから、カスタムフィールドの定義または既存のメタデータテンプレートに基づいて構造化メタデータを抽出します。 |