# Connect an MCP Client

Connecting an MCP client to Cakewalk takes a few minutes. You add the server URL, authorize access, and you're ready to go.

### Server URL

All clients use the same URL:

```
https://mcp.getcakewalk.io/mcp
```

***

### Before You Start

* You need an active Cakewalk account with at least the **User** role.
* Your AI assistant must support MCP with OAuth authentication.

***

### Cursor

Click the button below to install automatically:

[Install Cakewalk MCP in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=cakewalk-mcp\&config=eyJ1cmwiOiJodHRwczovL21jcC5nZXRjYWtld2Fsay5pby9tY3AifQ==)

Or manually:

1. Open Cursor and go to **Settings > MCP**.
2. Click **Add new MCP server**.
3. Set the URL to `https://mcp.getcakewalk.io/mcp` and authentication to **OAuth**.
4. Cursor will open your browser to Cakewalk's authorization page.
5. Review the requested scopes and click **Authorize**.
6. Return to Cursor. The connection is active.

***

### Claude Desktop

Run this in your terminal:

```bash
claude mcp add --transport http cakewalk-mcp https://mcp.getcakewalk.io/mcp
```

{% hint style="warning" %}
The CLI install requires the latest Claude Desktop release. If the command doesn't work yet, add it manually through **Settings > MCP Servers** using the server URL and OAuth authentication.
{% endhint %}

***

### Claude Cloud, Cursor Cloud and Other Clients

For any MCP client with a UI for adding servers:

1. Add a new MCP server.
2. Set the URL to `https://mcp.getcakewalk.io/mcp`.
3. Set authentication to **OAuth**.
4. The client will redirect you to Cakewalk's authorization page.
5. Review the requested scopes and click **Authorize**.
6. Done.

***

### Authorization and Scopes

During setup, Cakewalk's consent screen asks you to approve specific scopes. Each scope controls what data the AI assistant can access:

| Scope                | What It Grants                                          |
| -------------------- | ------------------------------------------------------- |
| `mcp:users.read`     | Read user profiles and access details                   |
| `mcp:workapps.read`  | Read app data (names, permission levels, custom fields) |
| `mcp:requests.read`  | View access requests                                    |
| `mcp:requests.write` | Create and manage access requests                       |

***

### Troubleshooting

**"Authorization failed" or blank screen after clicking Authorize** Make sure you are logged into Cakewalk in the same browser. Try clearing cookies for `idp2.getcakewalk.io` and retrying.

**Client says "server not found" or "connection refused"** Double check the URL: `https://mcp.getcakewalk.io/mcp`. The trailing `/mcp` is required.

**Tools not showing up in the assistant** Your granted scopes determine which tools are available. If you only authorized `mcp:users.read`, you will not see app or request tools. Reconnect and authorize additional scopes.

***

### Next Steps

* [MCP Tool Reference](https://docs.getcakewalk.io/open-api-and-mcp/introduction-to-mcp/mcp-tool-reference): See all available tools, what they do, and what scopes they need.