사용법

당신은 필요로 할 것이다:

• [T0]]

다음 중 하나 :

• BOX_JWT_BASE64 (추천)
• [T2]]
• [T3]

오

JSON Web Token (JWT) 인증 (추천)

###JWT를 얻는 방법

JWT Config을 사용하면 영구적인 연결이 가능합니다.

유료 박스 기업 계정이 필요하거나 무료 개발자 계정에 가입 할 수 있습니다 (그 링크를 클릭하기 전에 상자에서 서명해야합니다).

Box Developer Console을 방문하여 새로운 응용 프로그램을 만듭니다. 인증 유형이 JSON Web Token인지 확인하십시오.

Configuration > Add and Manage Public Keys로 이동하고 공공/개인 Keypair 생성. 이미 없다면 Box는 2 Factor 인증을 설정하고 Box 계정의 관리자로 응용 프로그램을 승인합니다. 당신은 필요:

1. 신청 App + Enterprise Access를 주고,
2. make API calls using the as-user header 옵션을 활성화

Box Application의 구성 페이지를 통해. **이 설정을 수정하는 경우 응용 프로그램을 재조정해야 **.

Base64 인코딩 JWT

Base64에서 JWT를 인코딩하려면 터미널에서 다음 명령을 사용할 수 있습니다

box-mcp-server

Usage

You will need:

• BOX_USER_ID

and one of the following:

• BOX_JWT_BASE64 (recommended)
• BOX_JWT_CONFIG_PATH
• BOX_JWT

Auth

JSON Web Token (JWT) Authorization (recommended)

How to get a JWT

Using a JWT Config allows persistent connection to Box.

You will need a paid Box enterprise account, or you can sign up for a free developer account (make sure you are signed out of Box before clicking that link).

Visit the Box Developer Console and create a new application. Make sure the authorization type is JSON Web Token.

Go to Configuration > Add and Manage Public Keys and Generate a Public/Private Keypair. If you have not already, Box prompt you to set up 2 factor authentication and Authorize the application as an administrator in your box account. You will need to:

1. give the application App + Enterprise Access, and
2. enable the make API calls using the as-user header option

via the Box Application’s Configuration page. Make sure to reauthorize the application if you are modifying these settings.

Base64 encoding JWT

To encode your JWT in Base64, you can use the following command in your terminal:

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

Replace /path/to/your/box-jwt-config.json with the actual path to your JWT configuration file. This will output the Base64 encoded JWT which you can then use in your environment variables.

Claude Desktop Configuration

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

Developer Token Authorization (easiest)

Using a developer token is the easiest way to integrate with Box, but will only last 60 minutes.

To get started, set the BOX_DEV_TOKEN to a Box Developer Token.

Begin by visiting the Box Developer Console and create a new application. The authorization type does not currently matter, as all support Box Developer Token.

Once your application is created, navigate to its configuration setings and click Generate Developer Token.

Claude Desktop Configuration

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

Capabilities

1. Searching files
2. Reading files

• [x] PDF
• [x] Word
• [ ] Others

Development

Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (recommended v22 or higher)
• npm
• git
• dotenv

Setting up Development Environment