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
- A Box enterprise account with the MCP server enabled by an admin. See Set up the MCP server.
- An IBM WatsonX Account. See Logging in to WatsonX.
Enable integration in Box
Admin- Sign in to the Box Admin Console.
- 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.
- Go to Configuration > Add Integration Credentials to generate new credentials.
- In Redirect URIs, change the Box redirect URIs to
https://dl.watson-orchestrate.ibm.com/mfe_connectors/api/v1/agentic/oauth/_callback - Copy the Client ID and Client Secret for later use. These are required later for WatsonX Orchestrate to authorize the connection.
- 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
UserActivate the connection
- In WatsonX Orchestrate, go to Manage > Connections.
- Select Pre-built connectors and search for Box.
- 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
- Server URL:
- 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.
- Option A: Team Credentials.
Add MCP Tools to an Agent
- On the agent page, navigate to Toolset.
- Select Add tool > Catalog > search for Box MCP Server.
- Select Add to Agent and then Connect.
- To add individual tools to the Agent, select Add tools > MCP server.
- Select the Box MCP server and add tools to the Agent.