box-mcp-server

使用法

必要なもの:

• BOX_USER_ID

および次のいずれか:

• BOX_JWT_BASE64 （推奨）

• BOX_JWT_CONFIG_PATH

• BOX_JWT

Related MCP server: mcp-pdf-tools

認証

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 でエンコードするには、ターミナルで次のコマンドを使用します。

cat /path/to/your/box-jwt-config.json | base64

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

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

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["box-mcp-server"],
      "env": {
        "BOX_JWT_BASE64": "YOUR_BASE64_ENCODED_JWT",
        "BOX_USER_ID": "123456"
      }
    }
  }
}

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

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

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

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

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

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

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["box-mcp-server"],
      "env": {
        "BOX_DEV_TOKEN": "YOUR_DEV_TOKEN_GOES_HERE"
      }
    }
  }
}

機能

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を設定します。