# Dropbox

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

## Requirements

* A Dropbox account owner or member who can create apps in the [Dropbox App Console](https://www.dropbox.com/developers/apps).
* Permission from your Dropbox admin to register or connect apps. If you cannot create an app, contact your team admin.

## Required Scopes

Permissions the Dropbox app must enable under the **Permissions** tab:

```
files.metadata.read
files.content.read
files.content.write
sharing.write
account_info.read
```

## Step 1: Create a Dropbox App

1. Open the [Dropbox App Console](https://www.dropbox.com/developers/apps).
2. Click **Create app**.
3. Configure the app:
   * **API**: Scoped access
   * **Access type**: Full Dropbox
   * **App name**: Choose a unique name (for example, `Cakewalk`).
4. Click **Create app**.

You land on the app's Settings page.

## Step 2: Add the Required Scopes

1. Open the **Permissions** tab.
2. Check every scope listed in [Required Scopes](#required-scopes) above.
3. Click **Submit** to save.

## Step 3: Configure the Redirect URI

1. Return to **Settings**.
2. Under **OAuth 2** > **Redirect URIs**, paste this URL and click **Add**:

```
https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback
```

## Step 4: Paste Credentials Into Cakewalk

1. Still on **Settings**, copy the **App key** and **App secret**.
2. Open <https://app.getcakewalk.io>.
3. Go to All Connections.
4. Find Dropbox.
5. Click Edit credentials.
6. Paste the App key and App secret.
7. Save.

## Verifying It Works

The Dropbox Connection card flips to Active on All Connections. From an agent platform connected to Cakewalk, ask the agent to list recent Dropbox files. If Dropbox returns results, the Connection is live.

## Troubleshooting

* `Insufficient permissions` after authentication: open the **Permissions** tab on the Dropbox app, confirm every scope from [Required Scopes](#required-scopes) is checked, click **Submit**, then reconnect Dropbox in Cakewalk. Dropbox requires reconnection any time the app's scopes change.
* Redirect URI mismatch on consent: the value under **OAuth 2 Redirect URIs** must match `https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback` exactly, with no trailing slash.
* `Cannot create app` in the App Console: your Dropbox admin restricts app registration. Ask your admin to either allow app creation for your account or create the app on your behalf.

## Learn More

* [How to connect the Dropbox remote MCP server](https://help.dropbox.com/integrations/mcp-server-remote)
* [Dropbox OAuth Guide](https://developers.dropbox.com/oauth-guide)


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.