Open a spec, click Copy to take the title, metadata and all sections, and paste it into your editor's chat.
01The quick way, any tool
02Set up Cursor
Annsa MCP is a remote server — nothing to install. Open Settings → MCP → Add server and paste:
https://app.annsa.ai/mcp
03Set up Claude Code
Run once:
claude mcp add --transport http annsa https://app.annsa.ai/mcp
The first run opens a browser for OAuth on Annsa’s consent screen — approve once and the tools appear.
04Any other client
Same URL in that client’s MCP settings: Codex CLI (config.toml), ChatGPT (Developer Mode → custom connector), Claude web/desktop (Connectors), VS Code, Windsurf, Figma Make, Lovable, Bolt, v0, Replit. OAuth runs in the browser on first use.
05The four tools
| Tool | What it does |
|---|---|
annsa.priorities | Ranked priorities with scores, volume, trend and shipping-history flags |
annsa.spec | Full spec for any priority, plus related context from past ships |
annsa.act | Build, ship, share, assign, correct, park, submit feedback or a transcript |
annsa.ask | Search feedback, priorities, specs and help articles |
06What 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?"
07A day of it
Morning: "what should I work on today?" — annsa.priorities returns the ranked list with revenue scores.
Get context: "show me the spec for priority #1" — annsa.spec returns the full spec with file paths.
Implement: your coding tool works from the spec. File paths from GitHub keep it grounded.
Ship: annsa.act ship marks it shipped and notifies customers, without leaving the terminal.
08Connect GitHub first
It's what puts real file paths in Files to Touch, so your coding tool knows where to go. Use specific prompts ("implement the spec for [priority name]") and the Done When criteria to know when you're finished.
09When it doesn't connect
"MCP not found" (Cursor): check ~/.cursor/mcp.json.
"MCP not found" (Claude Code): run claude mcp add --transport http annsa https://app.annsa.ai/mcp.
"Not authenticated": re-authenticate from your client (Claude Code: /mcp → annsa → Authenticate) — the browser reopens Annsa’s consent screen.
"No priorities": import some feedback first.