Harness · Cursor

Cursor.

Cursor reads MCP configs from two places: a project-level .cursor/mcp.json, which loads only when you open that project, and a user-level config in Settings → MCP, which loads everywhere. Pick whichever fits.

Auto-install

Paste this into Cursor

Click below to copy a self-install prompt. Paste it into Cursor's chat and Cursor will create the config file and reload its MCP servers for you.

Or follow the manual steps below.

1. Install the CLI

npm install -g @work.books/cli

2a. Project-level (recommended)

Create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "workbooks": {
      "command": "workbook",
      "args": ["mcp", "serve"]
    }
  }
}

2b. User-level (every project)

Open Cursor. ⌘+, → search for MCP → Add new MCP server. Paste the same JSON. Cursor writes this to ~/.cursor/mcp.json.

3. Verify

Open the chat panel. Type @ — you should see a workbooks tool group. Or just ask: "List my workbook groups."

Quirks & tips

Tools are off by default. Cursor sometimes ships with MCP tool calls disabled in Agent mode. Enable them in Settings → Beta → MCP tools if the agent ignores the server.
Per-project auth. When you run workbook publish via Cursor for the first time, the OAuth browser flow opens. Cursor will block the agent until you complete it; that's expected.
Hot reload. Editing .cursor/mcp.json reloads on save in recent Cursor builds. If it doesn't pick up, Cursor → Restart MCP servers from the command palette.