> ## 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.

# IBM watsonx Orchestrate

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

<Badge color="orange" size="lg">Admin</Badge>

1. Sign in to the [Box Admin Console](https://app.box.com/master).
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

<Badge color="green" size="lg">User</Badge>

### 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**:

   <Tabs>
     <Tab title="Team credentials">
       Select **Team credentials**. After that, a browser window opens for OAuth authentication.
     </Tab>

     <Tab title="Member credentials">
       1. Select **Member credentials**.
       2. Save changes to the connection.
       3. Navigate to the **Credentials** page.
       4. Click **Add credentials** and select **Box MCP** from the list.
     </Tab>
   </Tabs>

### 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](https://www.ibm.com/docs/en/watsonx/watson-orchestrate/base?topic=agents-box).