> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minidesk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Connect miniDesk to Cursor and other editors.

Useful when you want the conversation that reported a bug in front of you as
you fix it.

## Get a token first

In the dashboard, go to **Settings → MCP** and create a credential.

## Cursor

<Steps>
  <Step title="Open MCP settings">
    **Settings → Cursor Settings → MCP → Add new global MCP server**. That
    opens `~/.cursor/mcp.json`.
  </Step>

  <Step title="Add the server">
    ```json theme={null}
    {
      "mcpServers": {
        "minidesk": {
          "url": "https://api.minidesk.ai/mcp",
          "headers": {
            "Authorization": "Bearer mdsk_mcp_YOUR_TOKEN"
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Check it is green">
    Back in MCP settings, `minidesk` should show as connected with its tools
    listed. Hit refresh if it does not.
  </Step>
</Steps>

For one project only, put the same JSON in `.mcp.json` at the repo root
instead.

<Warning>
  A project-level `.mcp.json` holds a live token. Add it to `.gitignore` before
  you commit anything.
</Warning>

## VS Code

Add it to `.vscode/mcp.json`:

```json theme={null}
{
  "servers": {
    "minidesk": {
      "type": "http",
      "url": "https://api.minidesk.ai/mcp",
      "headers": {
        "Authorization": "Bearer mdsk_mcp_YOUR_TOKEN"
      }
    }
  }
}
```

Then pick **Agent** mode in Copilot Chat and the tools become available.

## Try it

> Read ticket ACME-1042 and tell me which file is likely responsible.

> What are customers reporting most this week?

> Draft a reply for ACME-1042 saying the fix ships tomorrow.

## Keeping the token out of git

Both editors read environment variables in config values, so you can keep the
secret out of the file:

```json theme={null}
{
  "mcpServers": {
    "minidesk": {
      "url": "https://api.minidesk.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MINIDESK_MCP_TOKEN}"
      }
    }
  }
}
```

Then export `MINIDESK_MCP_TOKEN` in your shell profile.