# Connect Cursor

#### What You'll Need

* Cursor IDE installed
* A Kick account with access to at least one workspace

{% hint style="info" %}
**Tip**: Log in to your Kick account in your browser before starting. This makes the authorization step faster.
{% endhint %}

### Connect your account

Cursor supports remote MCP servers through its Tools & MCP settings.

**Step 1: Open MCP Settings**

1. Open **Cursor Settings**
2. Go to **Tools & MCP**
3. Click **Add new MCP server**

<figure><img src="/files/8Mgkpra1K0647wAAJsYd" alt=""><figcaption></figcaption></figure>

**Step 2: Configure the Kick Server**

1. Copy and paste the code below:

```jsonc
{
  "mcpServers": {
    "kick-mcp": {
      "url": "https://use.kick.co/mcp",
      "headers": {
        "Authorization": "Bearer {YOUR_PAT}"
      }
    }
  }
}
```

2. Replace {YOUR\_PAT} with the token you issued from Kick's Connectors page
3. Click **Save** (cmd+s)

<figure><img src="/files/N9BhxPQIdabi6ybf47zs" alt=""><figcaption></figcaption></figure>

**Step 3: Verify the Connection**

1. Check that Kick appears as connected in the MCP tools list under Cursor Settings

<figure><img src="/files/4Ep7g1d9ck6PykY2xb24" alt=""><figcaption></figcaption></figure>

2. In a Cursor conversation, ask:

```
List the Kick tools you can use and confirm the active workspace.
```

Cursor should respond with available tools (like `transactions_find`, `reports_profit_loss_get`, `workspaces_list`) and your active workspace name.

***

#### Authentication Options

Cursor supports two authentication methods for Kick MCP:

**OAuth (Recommended)**

Automatically redirects you to authorize Kick access through your browser. Choose this if your firm uses standard Kick login.

**Bearer Token**

Uses a personal access token generated in Kick. Choose this if your firm requires token-based authentication or you need more granular access control.

To use bearer token authentication:

1. Generate a personal access token in Kick (Settings → API)
2. Copy the token
3. In Cursor's MCP server settings, paste the token in the authentication field

***

#### Troubleshooting

**Kick Not Appearing in Tools List**

The server configuration didn't load successfully.

1. Go back to Cursor Settings → Tools & MCP
2. Verify the MCP server URL is correct: `https://use.kick.co/mcp`
3. Save the configuration again
4. Restart Cursor

**Authorization Failed**

The authentication didn't complete successfully.

1. Check that you're logged in to your Kick account
2. Try disconnecting and reconnecting the server
3. If using bearer token, verify the token is still valid in Kick settings

**Wrong Workspace Showing**

Your Kick account has access to multiple workspaces. Tell Cursor which workspace you want to use:

```
Please switch to the [workspace name] workspace.
```

***

#### **Data Privacy and Security**

* **Your data stays in Kick**: Cursor requests data through the MCP connection but doesn't store your Kick data permanently
* **Workspace permissions apply**: Cursor can only access workspaces you already have permission to view in Kick
* **You control access**: You can disconnect Kick at any time from the Tools & MCP settings
* **Confirmation required for changes**: Write operations require your explicit approval before execution

***

#### Next Steps

Now that you're connected:

1. Try a sample query: "List my workspaces" or "What tools can you use?"
2. Explore reports by asking Claude to generate financial reports for your clients
3. Check out the [Kick MCP Use Case Library](/ai/kick-mcp/mcp-use-case-library.md) for advanced use cases


---

# 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://docs.kick.co/ai/kick-mcp/connectors/connect-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.
