Box MCP Server

box-mcp-server

使用法

必要なもの:

• BOX_USER_ID

および次のいずれか:

• BOX_JWT_BASE64 （推奨）
• BOX_JWT_CONFIG_PATH
• BOX_JWT

認証

JSON Web Token (JWT) 認証 (推奨)

JWTを取得する方法

JWT Config を使用すると、Box への永続的な接続が可能になります。

有料の Box エンタープライズ アカウントが必要になります。または、無料の開発者アカウントにサインアップすることもできます (リンクをクリックする前に、Box からサインアウトしていることを確認してください)。

Box開発者コンソールにアクセスし、新しいアプリケーションを作成します。認証タイプがJSON Web Tokenであることを確認してください。

Configuration > Add and Manage Public Keysに移動し、公開鍵と秘密鍵のペアを生成してください。まだ設定していない場合は、2要素認証の設定と、Boxアカウントでアプリケーションを管理者として承認するよう求められます。以下の手順が必要です。

1. アプリケーションにApp + Enterprise Access付与し、
2. make API calls using the as-user header有効にする

Boxアプリケーションの設定ページから設定できます。これらの設定を変更する場合は、必ずアプリケーションを再認証してください。

Base64エンコードされたJWT

JWT を Base64 でエンコードするには、ターミナルで次のコマンドを使用します。

/path/to/your/box-jwt-config.jsonをJWT設定ファイルへの実際のパスに置き換えてください。これにより、Base64エンコードされたJWTが出力され、環境変数で使用できます。

クロードデスクトップ構成

開発者トークンの承認（最も簡単）

開発者トークンを使用するのが Box と統合する最も簡単な方法ですが、有効期間は 60 分のみです。

開始するには、 BOX_DEV_TOKEN Box 開発者トークンに設定します。

まず、Box開発者コンソールにアクセスして新しいアプリケーションを作成します。すべてのアプリケーションがBox開発者トークンをサポートしているため、認証の種類は現在のところ問いません。

アプリケーションが作成されたら、その構成設定に移動して、 Generate Developer Tokenクリックします。

クロードデスクトップ構成

機能

1. ファイルの検索
2. ファイルの読み取り

• [x] PDF
• [x] 単語
• [ ] その他

発達

前提条件

始める前に、以下がインストールされていることを確認してください。

• Node.js（v22以上を推奨）
• npm
• ギット
• ドテンヴ

開発環境の設定

開発環境をセットアップするには、次の手順に従います。

1. リポジトリをフォークする
   • このリポジトリの右上隅にある「フォーク」ボタンをクリックします
   • これにより、Githubアカウントの下にリポジトリのコピーが作成されます。
2. フォークのクローンを作成する:
   git clone https://github.com/YOUR_USERNAME/box-mcp-server.git cd box-mcp-server
3. 上流リモートを追加
   git remote add upstream https://github.com/hmk/box-mcp-server.git
4. dotenvファイルをコピーする
   cp .env.template .env
5. 依存関係をインストールします:
   npm install
6. index.js を最新の状態に保つために watch を実行します。
   npm run watch
7. モデル コンテキスト プロトコル開発サーバーを起動します。
   dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
8. 開発サーバーが環境変数を正しくロードしなかった場合は、mcp インスペクターの左側でBOX_DEV_TOKENを設定します。