For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

Requirements

About Scopes

Box requires application scopes to be configured on the OAuth app itself, not at consent time. Scopes determine which Box objects the agent can read or modify (Files and Folders, Users, Groups, Webhooks, Enterprise Properties). Configure the scope set that matches the agent actions you want to allow. The scope set the MCP server requires is approved through your app's scope configuration.

Step 1: Create a Platform App in Box

  1. Sign in to Box and open the Developer Console.

  2. Select Platform Apps.

  3. Click New App.

  4. Enter an app name.

  5. In the App Type dropdown, select OAuth 2.0.

  6. Create the app.

Once OAuth 2.0 is selected, the app's authentication method cannot be changed. To switch later, create a new app.

Step 2: Configure the Redirect URI

  1. Open the app's Configuration page.

  2. Scroll to the OAuth 2.0 Redirect URI section.

  3. Add this URI:

  1. Save.

Redirect URIs must use HTTPS (HTTP is accepted only for localhost) and must match the configured value exactly.

Step 3: Configure Application Scopes

On the same Configuration page, scroll to the Application Scopes section and enable the scopes the agent needs to operate against Box. At minimum, enable read access on the object types the agent will touch.

Step 4: Copy the Client ID and Client Secret

On the app's Configuration page, find the OAuth 2.0 Credentials section. Copy the Client ID and Client Secret.

Step 5: Paste Credentials Into Cakewalk

  1. Go to All Connections.

  2. Find Box.

  3. Click Edit credentials.

  4. Paste the Client ID and Client Secret.

  5. Save.

Verifying It Works

The Box Connection card flips to Active on All Connections. From an agent platform connected to Cakewalk, ask the agent to list a folder in Box. If Box returns the folder contents, the Connection is live.

Troubleshooting

  • Invalid redirect URI on consent: the value in OAuth 2.0 Redirect URI must match https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback exactly. Box requires exact matches with no trailing slash.

  • Missing scope errors after authentication: enable the missing scope under Application Scopes on the app's Configuration page, then reconnect.

  • Cannot change authentication method: Box does not allow switching from OAuth 2.0 to another method on an existing app. Create a new app if a different auth method is needed.

Learn More

Last updated

Was this helpful?