Using with Cursor and Claude Code
Circuit integrates with AI coding tools via MCP. Pull priorities and briefs directly into your editor without copy-pasting.
Quick Copy Method
Works with any coding tool:
- Open a brief in Circuit
- Click Copy to grab the full brief (title, metadata, all 5 sections)
- Paste into your editor's chat
MCP Integration (Recommended)
For direct access without copy-paste. Package: circuit-mcp on npm.
Cursor Setup
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"circuit": {
"command": "npx",
"args": ["circuit-mcp"]
}
}
}
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.brief | Full spec for any priority with all five sections, plus related context from past ships |
circuit.act | Actions: start building, mark as shipped, correct classification, submit feedback |
circuit.ask | Search across feedback, priorities, briefs and help articles |
Priorities flag when they match your shipping history. Briefs 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 brief for the checkout bug"
- "What feedback mentions performance?"
- "Implement the brief for dark mode"
- "Mark priority #1 as shipped"
- "Have we shipped anything like this before?"
Workflow
- Morning: "What should I work on today?"
- Get context: "Show me the brief for priority #1"
- Implement: Your coding tool uses the brief as context
- Ship: Mark as Shipped in Circuit. Customers notified.
Tips
- Connect GitHub first so briefs include real file paths
- Use specific prompts: "Implement the brief 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
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.