> For the complete documentation index, see [llms.txt](https://www.cakewalk.security/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.cakewalk.security/docs/ai-agent-access/connections-and-integrations/agent-connections/box.md).

# Box

Connect your company's Box account to Cakewalk so agents can search files, read and share folders, manage uploads and work with metadata through the gateway. A Box admin creates integration credential

Connect your company's Box account to Cakewalk's MCP Gateway. Every agent tool call against Box passes through the gateway and is evaluated against your Policies.

## Setup Flow: Integration Credentials From the Admin Console

Box runs its own remote MCP server at `https://mcp.box.com`. Box does not register MCP clients automatically, so a Box admin creates one set of integration credentials for Cakewalk in the Box Admin Console and hands the Client ID and Client Secret to your Cakewalk Admin. That happens once per company. After that, each employee signs in with their own Box account.

## Requirements

* A Box admin who can open the Box Admin Console.
* A Cakewalk Admin, to add the Connection and enter the credentials.

## Step 1: Create Integration Credentials in Box

1. Open the Box Admin Console at [app.box.com/master](https://app.box.com/master) and select **Integrations** in the sidebar.
2. On the **Integrations** tab, search for **Box MCP Server**.
3. Hover over **Custom Box MCP Server** and select **Configure**.
4. Under **Additional Configuration**, select **+ Add Integration Credentials**.
5. Enter a name your team recognizes, for example Cakewalk, and select **Save**.
6. Expand the new entry and copy the **Client ID**.
7. Select **Reset** next to the Client Secret to generate it, then copy the **Client Secret**.
8. In the **Redirect URI** field, enter Cakewalk's redirect URI:

   ```
   https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback
   ```
9. Under **Access Scopes**, select `root_readwrite` and `ai.readwrite`.

{% hint style="info" %}
Box also offers the `docgen.readwrite` scope for Box Doc Gen tools. It requires a Box Enterprise Advanced license, and the Connection works without it.
{% endhint %}

## Step 2: Choose Which Tools Box Exposes (Optional)

On the **Box MCP Server** tab of the Integrations page, a Box admin decides per tool category which tools the MCP server offers: **Authentication & Users**, **Search**, **Files & Folders** and **Collaboration**. Each category can allow read and write tools or a custom configuration. The defaults work with Cakewalk. Narrowing them here limits what any connected agent can do in Box, on top of your Cakewalk Policies.

## Step 3: Add the Connection in Cakewalk

1. Open <https://app.getcakewalk.io>.
2. Go to **Connections**, select **Add org connection**, then **Browse catalog**.
3. Select **Box** and select **Continue**.
4. Enter the **Client ID** and **Client Secret** from Step 1.
5. Select **Confirm**.

Credentials are encrypted in your browser before they reach Cakewalk.

## Step 4: Employees Connect

No credentials change hands again. From an agent platform connected to Cakewalk, the employee connects Box, signs in with their own Box account and grants access. Each call then runs with that employee's Box permissions, and each call is still evaluated against your Policies.

{% hint style="warning" %}
Box marks the Custom Box MCP Server as billable. Calls made through integration credentials you create yourself count toward your Box plan's API and AI unit allowances. See [Box MCP Server pricing](https://docs.box.com/en/box-mcp/pricing) before rolling the Connection out widely.
{% endhint %}

## Verifying It Works

The Box Connection card flips to Active on All Connections. From an agent platform connected to Cakewalk, ask the agent to find a file in Box by name. If Box returns it, the Connection is live.

## Troubleshooting

* **Box shows an invalid redirect URI error on sign in.** The **Redirect URI** on the integration credentials must match `https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback` exactly, with no trailing slash.
* **Box rejects the Client Secret.** The secret is generated with **Reset**. Selecting **Reset** again invalidates the previous secret, so enter the newest one in Cakewalk.
* **The agent cannot reach certain files or actions.** Check the tool categories on the **Box MCP Server** tab (Step 2) and the access scopes on the integration credentials (Step 1). The employee's own Box permissions also apply.
* **The Connection does not appear in the catalog.** Add Box as a custom Connection instead: Connection type **OAuth with client ID and secret**, **MCP Url** `https://mcp.box.com`. See [Add a Custom Connection](https://www.cakewalk.security/docs/ai-agent-access/how-to-guides/connections/add-a-custom-connection.md).

## Learn More

* [Box remote MCP server](https://developer.box.com/guides/box-mcp/remote/)
* [Managing Box MCP Servers](https://support.box.com/hc/en-us/articles/43847256139923-Managing-Box-MCP-Servers)
* [Box MCP Server pricing](https://docs.box.com/en/box-mcp/pricing)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.cakewalk.security/docs/ai-agent-access/connections-and-integrations/agent-connections/box.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
