MCP Setup Guide

Connect Claude or any MCP client to Dragon Planner for AI-powered project management.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants interact with external tools and data sources. Dragon Planner was built with MCP from day one — it's not a bolt-on chatbot, it's a full integration that gives AI assistants real tools with real permissions.

When you connect Claude (or any compatible MCP client) to Dragon Planner, the AI can:

Query your work items, sprints, and projects
Create and update work items with full hierarchy support
Get intelligent recommendations on what to work on next
Attach files to work items
View dashboards and sprint summaries

All actions are attributed in the audit trail — you always know what the AI did and when.

Prerequisites

A Dragon Planner account with a Builder seat
Claude Code or another MCP-compatible client
Your workspace must be on a plan that includes MCP access

Connecting to Dragon Planner

Claude Code

Add Dragon Planner to your Claude Code MCP configuration:

Claude Code MCP config

{
  "mcpServers": {
    "dragon-planner": {
      "type": "http",
      "url": "https://mcp.dragonplanner.com/mcp"
    }
  }
}

When you first use a Dragon Planner tool, Claude Code will walk you through the OAuth authentication flow automatically. Dragon Planner uses OAuth 2.0 with PKCE — your credentials are never shared with the AI.

Other MCP Clients

Any MCP client that supports HTTP transport and OAuth 2.0 dynamic client registration can connect to Dragon Planner. Point it at:

https://mcp.dragonplanner.com

The server publishes its OAuth metadata at /.well-known/oauth-protected-resource.

Available Tools

Dragon Planner exposes 16 tools via MCP:

Tool	Description
`list_workspaces`	List all workspaces you have access to
`list_projects`	List projects in a workspace
`list_work_items`	List work items with filtering and pagination
`get_work_item`	Get full details of a specific work item
`create_work_item`	Create a new work item (any type)
`update_work_item`	Update fields on an existing work item
`delete_work_item`	Delete a work item
`search_work_items`	Full-text search across work items
`mark_complete`	Mark a work item as done (with cascade)
`move_work_item`	Move a work item to a different parent
`get_next_recommendation`	Get AI-powered recommendation for what to work on next
`get_current_sprint`	Get the active sprint and its items
`get_sprint_summary`	Get sprint progress and stats
`assign_to_sprint`	Assign a work item to a sprint
`upload_attachment`	Attach a file to a work item
`get_dashboard`	Get project dashboard data

Rate Limits

MCP call limits vary by plan:

Plan	MCP Calls/min
Free	20
Starter	40
Pro	60
Max	90

Example Workflow

Here's a typical workflow using Claude with Dragon Planner:

You: What should I work on next?

Claude: [calls get_next_recommendation]
→ The highest-priority item is DPF-42: "Add bulk import for work items"
  (Story, 5 points, no blockers, assigned to current sprint)

You: Let's break that into tasks.

Claude: [calls create_work_item × 3]
→ Created:
  - DPF-43: "Design CSV import schema" (Task, child of DPF-42)
  - DPF-44: "Build import API endpoint" (Task, child of DPF-42)
  - DPF-45: "Add import UI to work items page" (Task, child of DPF-42)

You: Mark DPF-43 as done, I finished the schema.

Claude: [calls mark_complete]
→ DPF-43 marked as Done. Parent DPF-42 is 33% complete (1/3 tasks done).

Troubleshooting

Authentication Issues

If OAuth fails, check that:

Your account has a Builder seat (Collaborator seats don't include MCP)
Your workspace plan includes MCP access
You're using the correct MCP server URL: https://mcp.dragonplanner.com/mcp

Connection Timeouts

Dragon Planner's MCP server uses HTTP streaming for transport. Make sure your network allows long-lived HTTP connections. Some corporate proxies may terminate streaming connections prematurely.

On this page