# 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](/docs/open-api-and-mcp/introduction-to-mcp/mcp-tool-reference.md): See all available tools, what they do, and what scopes they need.


---

# 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/open-api-and-mcp/introduction-to-mcp/connect-an-mcp-client.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.