Box

公式

Box AIを通じてインテリジェントコンテンツ管理プラットフォームと連携します。

GitHub

102

Box MCPで何ができますか？

ファイルとフォルダの検索 — box_tools_search を使用して、キーワード、ファイルタイプ、またはメタデータでBox内のコンテンツを検索します。
フォルダの一覧表示、作成、管理 — box_tools_folders を使用して、フォルダの内容を参照したり、新しいフォルダを作成したり、既存のフォルダを更新・削除したりします。
ファイルの読み取り、アップロード、ダウンロード — box_tools_files を使用して、ファイルの内容を取得したり、新しいバージョンをアップロードしたり、ファイルをダウンロードしたりします。
共有リンクの管理 — box_tools_shared_links を使用して、ファイル、フォルダ、およびWebリンクの共有リンクを作成、更新、または削除します。
AIによるファイルのクエリ — box_tools_ai を通じて、ファイルの内容やハブデータについて質問します。
メタデータテンプレートの処理 — box_tools_metadata を使用して、メタデータテンプレートを作成・管理し、ファイルにインスタンス値を適用します。

ドキュメント

Box MCP サーバー

[!WARNING] このリポジトリは廃止され、メンテナンスは終了しました。 Box は現在、最高のエクスペリエンスと完全な機能を備えた、公式サポートのホスト型 MCP サーバーを提供しています。ホスト型 MCP サーバーに移行してください: Box MCP サーバーのセットアップ →

クイックスタート

リポジトリのクローン:

git clone https://github.com/box-community/mcp-server-box.git
cd mcp-server-box

仮想環境と依存関係管理のための `uv` のインストール (オプションですが推奨):

Homebrew (macOS)

brew install uv

WinGet (Windows)

winget install --id=astral-sh.uv  -e

macOS および Linux の場合

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows の場合

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

仮想環境のセットアップと依存関係のインストール:

uv sync

環境変数の設定:

Box 認証用に以下の環境変数を .env ファイルまたはシステム環境に設定してください。

認証設定の包括的なオプションについては、認証ガイドを参照してください。

Box アプリでの OAuth2.0 の使用

BOX_CLIENT_ID = YOUR_CLIENT_ID
BOX_CLIENT_SECRET = YOUR_CLIENT_SECRET
BOX_REDIRECT_URL = http://localhost:8000/callback

# MCP Server Authentication (for HTTP transports)
BOX_MCP_SERVER_AUTH_TOKEN = YOUR_BOX_MCP_SERVER_AUTH_TOKEN
OAUTH_PROTECTED_RESOURCES_CONFIG_FILE = .oauth-protected-resource.json

注意:

BOX_MCP_SERVER_AUTH_TOKEN は、--mcp-auth-type=token を使用する際に MCP クライアントを MCP サーバーに対して認証するために使用されます (Box 認証とは独立しています)

STDIO モードでの MCP サーバーの実行:

uv run src/mcp_server_box.py

Box コミュニティ MCP サーバーツール

利用可能なツールの概要は以下のとおりです:

利用可能なツール	説明
box_tools_ai	AI を活用したファイルおよびハブのクエリ
box_tools_collaboration	ファイル/フォルダーのコラボレーション管理
box_tools_docgen	ドキュメント生成とテンプレート管理
box_tools_files	ファイル操作 (読み取り、アップロード、ダウンロード)
box_tools_folders	フォルダー操作 (一覧表示、作成、削除、更新)
box_tools_generic	汎用 Box API ユーティリティ
box_tools_groups	グループ管理とクエリ
box_tools_metadata	メタデータテンプレートとインスタンスの管理
box_tools_search	ファイルとフォルダーの検索
box_tools_shared_links	ファイル/フォルダー/Webリンクの共有リンク管理
box_tools_tasks	タスクとタスク割り当ての管理
box_tools_users	ユーザー管理とクエリ
box_tools_web_link	Web リンクの作成と管理

Box コミュニティ MCP サーバー操作の詳細

コマンドラインインターフェースパラメータ

特定の設定で MCP サーバーを実行するには、以下のコマンドラインパラメータを使用できます:

uv run src/mcp_server_box.py --help

usage: mcp_server_box.py [-h] [--transport {stdio,sse,http}] [--host HOST] [--port PORT] [--mcp-auth-type {oauth,token,none}] [--box-auth-type {oauth,ccg,jwt,mcp_client}]

Box Community MCP Server

options:
  -h, --help            show this help message and exit
  --transport {stdio,sse,http}
                        Transport type (default: stdio)
  --host HOST           Host for SSE/HTTP transport (default: localhost)
  --port PORT           Port for SSE/HTTP transport (default: 8005)
  --mcp-auth-type {oauth,token,none}
                        Authentication type for MCP server (default: token)
  --box-auth-type {oauth,ccg,jwt,mcp_client}
                        Authentication type for Box API (default: oauth)

認証タイプ、設定、ユースケースの詳細については、認証ガイドを参照してください。

Claude Desktop 設定

STDIO モード

claude_desktop_config.json を編集します:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the configuration:

{
    "mcpServers": {
        "mcp-server-box": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-box",
                "run",
                "src/mcp_server_box.py"
            ]
        }
    }
}

Claude が実行中の場合は再起動します。

HTTP モード

MCP サーバーが https://mcp.myserver.com/mcp で実行されていると仮定します

Claude -> 設定 -> コネクタに移動します
Add custom connector を選択します
設定:
1. 名前を付けます
2. URL を入力します (例: https://mcp.myserver.com/mcp)
3. オプションで client id と client secret を入力します
追加をクリックします
接続をクリックします。OAuth フローが開始されます。フローを完了します
Claude に戻り、設定をクリックします。利用可能なすべてのツールが表示されるはずです。

Box