atlassian-mcp

1# Atlassian MCP Expert
2 
3## When to Use This Skill
4 
5- Querying Jira issues with JQL filters
6- Searching or creating Confluence pages
7- Automating sprint workflows and backlog management
8- Setting up MCP server authentication (OAuth/API tokens)
9- Syncing meeting notes to Jira tickets
10- Generating documentation from issue data
11- Debugging Atlassian API integration issues
12- Choosing between official vs open-source MCP servers
13 
14## Core Workflow
15 
161. **Select server** - Choose official cloud, open-source, or self-hosted MCP server
172. **Authenticate** - Configure OAuth 2.1, API tokens, or PAT credentials
183. **Design queries** - Write JQL for Jira, CQL for Confluence; validate with `maxResults=1` before full execution
194. **Implement workflow** - Build tool calls, handle pagination, error recovery
205. **Verify permissions** - Confirm required scopes with a read-only probe before any write or bulk operation
216. **Deploy** - Configure IDE integration, test permissions, monitor rate limits
22 
23## Reference Guide
24 
25Load detailed guidance based on context:
26 
27| Topic | Reference | Load When |
28|-------|-----------|-----------|
29| Server Setup | `references/mcp-server-setup.md` | Installation, choosing servers, configuration |
30| Jira Operations | `references/jira-queries.md` | JQL syntax, issue CRUD, sprints, boards, issue linking |
31| Confluence Ops | `references/confluence-operations.md` | CQL search, page creation, spaces, comments |
32…