Docs / Cursor

Connect Cursor to Carbon

A few lines in Cursor's MCP settings.

Steps

  1. Get a key: in your Carbon workspace open Connect AI tools, pick Cursor and click Connect. The key is shown once; tick Read-only if the tool should only read.
  2. In Cursor open Settings → MCP → Add new global MCP server (or edit ~/.cursor/mcp.json) and paste:
    {
      "mcpServers": {
        "carbon": {
          "url": "https://www.carbon.app/api/mcp",
          "headers": {
            "Authorization": "Bearer carb_YOUR_KEY"
          }
        }
      }
    }
  3. Enable the server; the carbon tools appear in the agent's tool list.

Cursor's agent then sees the ten Carbon tools; ask it to read your README before it starts on a task.

Then, in the first chat

Connected tools know they have the Carbon actions but not when to use them. A good first message:

Call carbon_overview and read my README. Then write down what you already know about this project in README.md (what it is, how the docs are organised) and decisions.md (what has been decided and why), so other tools can pick it up. Keep both current as we work.

Every save is attributed to the connection and kept in history, so you can see on the workspace's Home and Activity pages exactly what Cursor changed. The full tool reference is on the MCP server page.