# Cursor

Cursor accepts a one-click `cursor://` deep link to install a custom MCP server. Cakewalk's Set Up Flow generates that link with your gateway URL and per-user token baked in. Click once and approve in Cursor.

## Install Method

Deep link. Cakewalk renders a `cursor://anysphere.cursor-deeplink/mcp/install?...` link in the Set Up Flow. Clicking it launches Cursor with the cakewalk server config staged for approval.

## Step 1: Open the Cakewalk Set Up Flow

1. Open <https://app.getcakewalk.io>.
2. Go to **My Agents**.
3. Click **Set up** on the Cursor card.
4. Cakewalk surfaces a one-click option to open the install in Cursor.

## Step 2: Click Open in Cursor

1. Click the Cursor install option.
2. Your browser hands the `cursor://` link to Cursor.
3. Cursor opens with the cakewalk server config pre-filled.
4. Approve the install when prompted.

## Step 3: Authenticate

Cursor starts an OAuth flow in your browser on first use of a cakewalk tool. Sign in with your Cakewalk account and approve the Connection.

## Verifying It Works

In Cursor, open the MCP panel and confirm that **cakewalk** appears as Connected. In Cakewalk, the Cursor card on **My Agents** flips to **Connected** after the first agent call.

## Troubleshooting

* **Browser does not hand the link to Cursor:** confirm Cursor is installed and that your browser is configured to handle the `cursor://` scheme. Restarting the browser usually resolves handler registration.
* **Cursor opens but the cakewalk server does not appear:** the deep link may have failed to parse. Use the JSON config alternative below.
* **Tool list looks empty:** Cursor caps total active tools across MCP servers. If you have many servers connected, trim some and reload.

## Other Install Paths

If the deep link does not work, or you prefer to manage MCP config in source control, edit one of:

* **Workspace:** `.cursor/mcp.json` in the project root. The server appears only when you open that project.
* **Global:** `~/.cursor/mcp.json` in your home directory. The server appears in every Cursor project on this machine.

The shape is:

```json
{
  "mcpServers": {
    "cakewalk": {
      "url": "https://mcp-gateway.getcakewalk.io/mcp"
    }
  }
}
```

Workspace scope takes precedence over global scope.

## Learn more

* [Model Context Protocol in Cursor](https://cursor.com/docs/context/mcp) from Cursor.


---

# 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-platforms/cursor.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.