Plane MCP¶
Official Plane MCP server for Cursor — tickets, Kanban, cycles, comments.
URL¶
https://mcp.rafaelgonzalezalbes.com/http/mcp
Deployed via plane/mcp/docker-compose.yml (makeplane/plane-mcp-server).
Cursor configuration¶
"plane": {
"url": "https://mcp.rafaelgonzalezalbes.com/http/mcp"
}
OAuth on first use — log in with your Plane account (Rafael or Alex).
Typical agent tasks¶
- Create issue: "Create BIOS-15 for adding docs site"
- Move Kanban card: "Move PORT-3 to In Review"
- Add comment: "Comment on BIOS-12 that CI passed"
- Search issues before coding
Workflow integration¶
Per project Kanban: Backlog → Ready → In Progress → In Review → CI Green → QA → Done
Branch naming: feature/{PREFIX}-{N}-description
Close on merge: fixes {PREFIX}-{N}
CI integration (separate from MCP)¶
Woodpecker posts CI status via REST API (notify-plane-ci.sh) when branch contains PREFIX-N. This is not the MCP server — both work together.
Troubleshooting¶
| Issue | Fix |
|---|---|
| MCP down | bash scripts/bootstrap-plane-platform.sh on VPS |
| OAuth fails | Check secrets/plane-mcp.enc.env OAuth client ID/secret |
| 401 on tools | Re-authorize OAuth in Cursor |
See Monitoring — Kuma monitors mcp.*.