Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.box.com/llms.txt

Use this file to discover all available pages before exploring further.

Prerequisites

Enable integration in Box

Admin
  1. Sign in to the Box Admin Console.
  2. Go to Integrations and find Custom Box MCP Server either by using the MCP Category filter, or by using the search bar at the top of the page.
  3. Go to Configuration > Add Integration Credentials to generate new credentials.
  4. In Redirect URIs, change the Box redirect URIs to https://dl.watson-orchestrate.ibm.com/mfe_connectors/api/v1/agentic/oauth/_callback
  5. Copy the Client ID and Client Secret for later use. These are required later for WatsonX Orchestrate to authorize the connection.
  6. Check the Access scopes:
    • Scopes define the maximum set of actions. Users can only access content they already have permission to view or edit in Box.
    • Read all files and folders stored in Box.
    • Read and write all files and folders stored in Box.
    • Manage AI Requests.

Enable integration in WatsonX Orchestrate

User

Activate the connection

  1. In WatsonX Orchestrate, go to Manage > Connections.
  2. Select Pre-built connectors and search for Box.
  3. Edit the Box MCP connector with the following values:
    • Server URL: https://mcp.box.com
    • Token URL: https://api.box.com/oauth2/token
    • Authorization URL: https://account.box.com/api/oauth2/authorize
    • Client ID: your client ID
    • Client Secret: your client secret
  4. Choose Credential type:
    • Option A: Team Credentials.
      • Select Team credentials.
      • A browser window will open for OAuth authentication.
    • Option B: Member Credentials.
      • Select Member credentials.
      • Save changes to the connection.
      • Navigate to the Credentials page.
      • Click Add credential.
      • Select Box MCP from the list.

Add MCP Tools to an Agent

  1. On the agent page, navigate to Toolset.
  2. Select Add tool > Catalog > search for Box MCP Server.
  3. Select Add to Agent and then Connect.
  4. To add individual tools to the Agent, select Add tools > MCP server.
  5. Select the Box MCP server and add tools to the Agent.
For additional instructions, see IBM WatsonX Orchestrate’s documentation.