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:
- Open a spec in Circuit
- Click Copy to grab the full spec (title, metadata, all sections)
- 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
| Tool | Description |
|---|---|
circuit.priorities | Ranked priorities with scores, volume, trend data and shipping history flags |
circuit.spec | Full spec for any priority with all sections, plus related context from past ships |
circuit.act | Actions: build, ship, share, assign, correct, park, submit feedback, submit transcript |
circuit.ask | Search 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
- Morning: "What should I work on today?" —
circuit.prioritiesreturns your ranked list with revenue scores - Get context: "Show me the spec for priority #1" —
circuit.specreturns the full spec with file paths - Implement: Your coding tool uses the spec as context. File paths from GitHub keep it grounded.
- Ship:
circuit.act shipmarks 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 →