Box

Obtaining Box API Credentials (JWT or Developer Token)

Option 1: JSON Web Token (JWT) Authorization (Recommended)

1. Sign Up for a Box Developer Account

   • Go to https://account.box.com/signup/n/developer.
   • Make sure you are signed out of Box before signing up if you do not already have a developer account.

2. Create a Box Application

   • Visit Box Developer Console.
   • Click "Create New App".
   • Select "Custom App".
   • For authentication method, choose "OAuth 2.0 with JWT (Server Authentication)" or similar wording (authorization type: JSON Web Token).
   • Name and create your application.

3. Configure Your Application

   • In your created app, go to "Configuration".
   • Under "Add and Manage Public Keys", generate a Public/Private Keypair.
   • Download and safely store the generated config file (e.g., box-jwt-config.json).

4. Set Additional Application Permissions

   • In your app’s Configuration page:
     • Set the application access to "App + Enterprise Access".
     • Enable the option "Make API calls using the as-user header".
   • If you modify these settings, confirm and reauthorize your application as prompted.

5. Base64 Encode Your JWT Config

   • On your computer, run:

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

   • Replace /path/to/your/box-jwt-config.json with your actual file path.
   • Copy the Base64-encoded output.

6. Find Your Box User ID

   • In the Box Web App, click your profile avatar → Account Settings.
   • Your "User ID" will be displayed under your profile information.

7. Fill in ENV Values in FastMCP

   • Press the "Install Now" button.
   • For BOX_USER_ID, enter your user ID from step 6.
   • For BOX_JWT_BASE64, paste your Base64 encoded string from step 5.

Option 2: Developer Token Authorization (Easiest, Expires in 60 Minutes)

1. Create a Box Application

   • Go to the Box Developer Console.
   • Create a new application (authorization type does not matter for developer tokens).

2. Generate Developer Token

   • In your app's configuration, click "Generate Developer Token".
   • Copy the generated token.

3. Fill in ENV Value in FastMCP

   • Press the "Install Now" button.
   • For BOX_DEV_TOKEN, enter the developer token you copied.

Note: Values should be filled in the FastMCP connection interface after pressing "Install Now". Follow the method best suited to your needs (JWT for persistent access; Developer Token for short-term/testing access).