CleanClean
Agents

Cursor

Connect Clean to Cursor — requires a manual paste into Cursor's MCP settings.

Cursor uses SSE transport and requires you to add the MCP server through its settings UI. The installer generates the config, but you need to paste it in manually.

Step 1 — Run the installer

npx @tryclean/create

Select Cursor when asked which agents to configure. The CLI will print the config block you need.

Step 2 — Open Cursor MCP settings

In Cursor, go to:

Settings → Features → MCP Servers → Add Server

Or open the MCP settings file directly at ~/.cursor/mcp.json.

Step 3 — Paste the config

The config the CLI generates looks like this:

{
  "mcpServers": {
    "clean": {
      "type": "sse",
      "url": "http://localhost:8000/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

If you're editing ~/.cursor/mcp.json directly, merge the clean entry into the existing mcpServers object (don't replace the whole file if you have other servers).

Step 4 — Restart Cursor

Restart Cursor completely for the MCP server to be detected.

Verify

Open Cursor's MCP panel — you should see clean listed as a connected server with the search_code, index_repo, and list_repos tools.

Dashboard onboarding

If you signed up via the dashboard, the onboarding flow at /dashboard/onboarding shows the exact config block for your instance — copy it from there.

On this page