Using with Cursor and Claude Code

Using Circuit·
4 min read
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 briefs directly into your editor without copy-pasting.

Quick Copy Method

Works with any coding tool:

  1. Open a brief in Circuit
  2. Click Copy to grab the full brief (title, metadata, all 5 sections)
  3. 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

ToolDescription
circuit.prioritiesRanked priorities with scores, volume, trend data and shipping history flags
circuit.briefFull spec for any priority with all five sections, plus related context from past ships
circuit.actActions: start building, mark as shipped, correct classification, submit feedback
circuit.askSearch 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

  1. Morning: "What should I work on today?"
  2. Get context: "Show me the brief for priority #1"
  3. Implement: Your coding tool uses the brief as context
  4. 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.

Related articles

Can't find what you're looking for?

Contact support