IBM watsonx Orchestrate’s setup process involves the following steps:
- Admin enablement in Box
- End-user connection in watsonx Orchestrate
Step 1: 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.
Step 2: Enable integration in watsonx Orchestrate
User
Activate 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
-
Choose a Credential type:
Team credentials
Member credentials
Select Team credentials. After that, a browser window opens for OAuth authentication.
- Select Member credentials.
- Save changes to the connection.
- Navigate to the Credentials page.
- Click Add credentials and select Box MCP from the list.
- 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.
For additional instructions, see IBM watsonx Orchestrate’s documentation. Last modified on July 22, 2026