Docs menuConnect Cursor

Connect Cursor

Use with AI

Connect Cursor to Colliedesk. Cursor has no place to keep a secret apart from its configuration, so the token ends up in your own ~/.cursor/mcp.json or in an environment variable.

On this page

Before you start

  1. Sign in to Colliedesk and open Settings → AI & agents → External AI agents.
  2. Name the token (for example "Cursor on my laptop"), choose what it may do (follow a role, or pick permissions; leaving out sending to customers is a good start) and choose Create token. See Agent tokens.
  3. Copy the token. It starts with cdk_agent_ and is shown once.

The steps below use https://desk.example.com: put the address you open Colliedesk at in its place. Under Connect your agent, Settings shows these steps for Cursor with your address already in.

Connect

From Colliedesk (one click). After you create the token, Settings shows Add to Cursor. It opens Cursor, which asks you to install the Colliedesk server, with the token in its configuration (~/.cursor/mcp.json in your home folder, readable by programs you run). Use a read or draft token for it, and revoke the token when you stop using it.

By hand, with an environment variable. Put the token in your shell profile:

export COLLIEDESK_TOKEN=<your token>

then add this to ~/.cursor/mcp.json (create the file if it does not exist; keep any other servers in mcpServers):

{
  "mcpServers": {
    "colliedesk": {
      "url": "https://desk.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:COLLIEDESK_TOKEN}"
      }
    }
  }
}

Cursor reads ${env:COLLIEDESK_TOKEN} only when it is started from a terminal that has the variable (cursor .); started from the Dock or the Start menu, it sends no token and Colliedesk answers 401.

In Cursor Settings → MCP, colliedesk shows its tools when it is connected.

Try it

Ask Cursor: "Who am I in Colliedesk?" It calls colliedesk_whoami, which answers with your name, your workspace, your roles, the token's permissions and the tools it may use. Then, for example: "Triage the open conversations nobody owns: tag billing questions with billing and leave a note with a summary."

What the agent can do

Colliedesk has 250 tools. The agent acts as you, with the permissions you gave the token, never more than you hold now. A tool it has the permissions for runs at once; any other is refused with the permission it lacks. See Roles and permissions.

Every tool and what it needs: Connect an AI agent (MCP).

Remove it

Delete the colliedesk entry from ~/.cursor/mcp.json, or turn it off in Cursor Settings → MCP. Then revoke the token in Settings → AI & agents → External AI agents (its ⋯ menu, Revoke): it stops working at once, wherever it was copied.

Other hosts

Was this page helpful?

Updated

This page is rendered from the repository. Spot a mistake? Open an issue or a pull request.