box-mcp-server

box-mcp-server

使用方法

以下が必要です。

• BOX_USER_ID

さらに、以下のいずれかが必要です。

• BOX_JWT_BASE64（推奨）
• BOX_JWT_CONFIG_PATH
• BOX_JWT

認証

JSON Web Token（JWT）認証（推奨）

JWT の取得方法

JWT 設定を使用すると、Box への接続を維持できます。

有料の Box エンタープライズアカウントが必要です。または、無料の開発者アカウントに登録できます（リンクをクリックする前に、Box からサインアウトしてください）。

Box Developer Consoleにアクセスし、新しいアプリケーションを作成します。認証タイプが JSON Web Token になっていることを確認してください。

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

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

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

JWT の Base64 エンコード

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

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

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

Claude Desktop の設定

{
  "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 Developer Token を設定します。

Box Developer Consoleにアクセスし、新しいアプリケーションを作成します。現在、すべてのアプリケーションで Box Developer Token がサポートされているため、認証タイプは問いません。

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

Claude Desktop の設定

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

機能

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

• PDF
• Word
• その他

開発

前提条件

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

• Node.js（v22 以降を推奨）
• npm
• git
• dotenv

開発環境のセットアップ

開発環境をセットアップするには、次の手順に従ってください。

1. リポジトリをフォークします

   • このリポジトリの右上にある「Fork」ボタンをクリックします
   • 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. watch を実行して index.js を最新の状態に保ちます。

   npm run watch
   

7. model context protocol 開発サーバーを起動します。

   dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
   

8. 開発サーバーで環境変数が正しく読み込まれなかった場合は、mcp inspector の左側の欄に BOX_DEV_TOKEN を設定します。