Skip to main content
IBM watsonx Orchestrate’s setup process involves the following steps:
  1. Admin enablement in Box
  2. End-user connection in watsonx Orchestrate

Step 1: 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.

Step 2: 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 a Credential type:
    Select Team credentials. After that, a browser window opens for OAuth authentication.

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.