Docs

Specs out

Cursor & Claude Code

Editor
>What are my top priorities?
circuit.priorities
1.Bulk CSV import142 users
2.Slack thread replies87 users
3.Dashboard load time74 users

Using with Cursor and Claude Code

Circuit integrates with AI coding tools via MCP. Pull priorities and specs directly into your editor without copy-pasting. This is how to integrate product management with Cursor and how to use Claude Code for product management — connected to your actual customer feedback.

Quick Copy Method

Works with any coding tool:

  1. Open a spec in Circuit
  2. Click Copy to grab the full spec (title, metadata, all sections)
  3. Paste into your editor's chat

MCP Integration (Recommended)

For direct access without copy-paste. Package: circuit-mcp on npm.

Cursor Setup

Run once:

npx circuit-mcp setup

Claude Code Setup

Run:

claude mcp add circuit -- npx circuit-mcp

Authenticate

First run opens a browser for OAuth. Token is cached at ~/.circuit/token.json.

Available Tools

ToolDescription
circuit.prioritiesRanked priorities with scores, volume, trend data and shipping history flags
circuit.specFull spec for any priority with all sections, plus related context from past ships
circuit.actActions: build, ship, share, assign, correct, park, submit feedback, submit transcript
circuit.askSearch across feedback, priorities, specs and help articles

Priorities flag when they match your shipping history. Specs include context from past ships when relevant. The more you ship, the richer the context.

What You Can Ask

  • "What are my top priorities?"
  • "Get the spec for the checkout bug"
  • "What feedback mentions performance?"
  • "Implement the spec for dark mode"
  • "Mark priority #1 as shipped"
  • "Have we shipped anything like this before?"

Workflow

How to integrate product management with Cursor

  1. Morning: "What should I work on today?" — circuit.priorities returns your ranked list with revenue scores
  2. Get context: "Show me the spec for priority #1" — circuit.spec returns the full spec with file paths
  3. Implement: Your coding tool uses the spec as context. File paths from GitHub keep it grounded.
  4. Ship: circuit.act ship marks as shipped and notifies customers — without leaving the terminal

How to use Claude Code for product management

Same workflow via Claude Code. Run claude mcp add circuit once. Then ask Claude Code "what should I build next?" and it pulls your priorities directly. Specs flow with codebase context from GitHub, so Claude Code knows which files to touch.

Tips

  • Connect GitHub first so specs include real file paths
  • Use specific prompts: "Implement the spec for [priority name]"
  • The Files to Touch section helps your coding tool navigate the codebase
  • Use Done When criteria to know when you're finished

Where this fits

Pulling priorities and specs into Cursor or Claude Code is one part of where autonomous product intelligence is heading — customer signal reaching the builder without manual translation.

Troubleshooting

"MCP not found" (Cursor): Check ~/.cursor/mcp.json configuration.

"MCP not found" (Claude Code): Run claude mcp add circuit -- npx circuit-mcp.

"Not authenticated": Delete ~/.circuit/token.json and re-run. A browser will open for OAuth.

"No priorities": Import feedback in Circuit first.


Further reading: Using Cursor and Claude Code with a product management system →

Can't find what you're looking for?

Contact support