Cursor

Early access — Cursor MCP JSON shape varies by release channel. If this block fails, paste the error in the Product Brain Community. UI screenshots: coming soon.

Cursor can work with Product Brain through MCP or the pb CLI. In both paths, you speak normally; Cursor (your agent) runs Product Brain on your behalf.

Two paths

Path	When it fits
MCP	You want tools inside Cursor without relying on a shell.
Terminal (`pb`)	The agent already runs commands in your repo and you want tight git/test integration.

MCP configuration (`.cursor/mcp.json`)

Create or merge this block (replace the API key with one from Settings → API keys in the app):

{
  "mcpServers": {
    "productbrain": {
      "url": "https://mcp.productbrain.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Restart Cursor after saving. Then ask:

Use Product Brain MCP to orient for the task we're about to do.

API key flow (human)

Open work.productbrain.io → your workspace.
Settings → API keys → create key (read vs read-write per need).
Paste into .cursor/mcp.json as shown above.

Screenshot of the keys screen: coming soon.

Recommended `.cursorrules` snippet

Before substantive edits, use Product Brain (MCP or pb) to orient for the current task and respect captured DEC/STD/TEN context. Start a session before writes; close it when done.

Working pattern

Orient with the task (natural language → MCP orient or pb orient --task).
Read relevant Chain entries.
Make the code or docs change.
Capture durable decisions or tensions.
Close the session.

Troubleshooting

Symptom	Fix
Tools never appear	Restart Cursor; confirm JSON path and trailing `/mcp`.
401 / unauthorized	Rotate key; check `Bearer` prefix and workspace.
Writes blocked	Use read-write key; start MCP session tools before capture.

Pick your tool

Install & wiring

Workspace setup

Two paths

MCP configuration (`.cursor/mcp.json`)

API key flow (human)

Recommended `.cursorrules` snippet

Working pattern

Troubleshooting

​Two paths

​MCP configuration (.cursor/mcp.json)

​API key flow (human)

​Recommended .cursorrules snippet

​Working pattern

​Troubleshooting

​Related

Two paths

MCP configuration (`.cursor/mcp.json`)

API key flow (human)

Recommended `.cursorrules` snippet

Working pattern

Troubleshooting

Related