atlassian-mcp

# Atlassian MCP Expert ## When to Use This Skill - Querying Jira issues with JQL filters - Searching or creating Confluence pages - Automating sprint workflows and backlog management - Setting up MCP server authentication (OAuth/API tokens) - Syncing meeting notes to Jira tickets - Generating documentation from issue data - Debugging Atlassian API integration issues - Choosing between official vs open-source MCP servers ## Core Workflow 1. **Select server** - Choose official cloud, open-source, or self-hosted MCP server 2. **Authenticate** - Configure OAuth 2.1, API tokens, or PAT credentials 3. **Design queries** - Write JQL for Jira, CQL for Confluence; validate with `maxResults=1` before full execution 4. **Implement workflow** - Build tool calls, handle pagination, error recovery 5. **Verify permissions** - Confirm required scopes with a read-only probe before any write or bulk operation 6. **Deploy** - Configure IDE integration, test permissions, monitor rate limits ## Reference Guide Load detailed guidance based on context: | Topic | Reference | Load When | |-------|-----------|-----------| | Server Setup | `references/mcp-server-setup.md` | Installation, choosing servers, configuration | | Jira Operations | `references/jira-queries.md` | JQL syntax, issue CRUD, sprints, boards, issue linking | | Confluence Ops | `references/confluence-operations.md` | CQL search, page creation, spaces, comments | | Authentication | `references/authentication-patterns.md` | OAuth 2.0, API tokens, permission scopes | | Common Workflows | `references/common-workflows.md` | Issue triage, doc sync, sprint automation | ## Quick-Start Examples ### JQL Query Samples ``` # Open issues assigned to current user in a sprint project = PROJ AND status = "In Progress" AND assignee = currentUser() ORDER BY priority DESC # Unresolved bugs created in the last 7 days project = PROJ AND issuetype = Bug AND status != Done AND created >= -7d ORDER BY created DESC # Validate before bulk: test with maxResults=1 first project = PROJ AND sprint in openSprints() AND status = Open ORDER BY created DESC ``` ### CQL Query Samples ``` # Find pages updated in a specific space recently space = "ENG" AND type = page AND lastModified >= "2024-01-01" ORDER BY lastModified DESC # Search page text for a keyword space = "ENG" AND type = page AND text ~ "deployment runbook" ``` ### Minimal MCP Server Configuration ```json { "mcpServers": { "atlassian": { "command": "npx", "args": ["-y", "@sooperset/mcp-atlassian"], "env": { "JIRA_URL": "https://your-domain.atlassian.net", "JIRA_EMAIL": "[email protected]", "JIRA_API_TOKEN": "${JIRA_API_TOKEN}", "CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki", "CONFLUENCE_EMAIL": "[email protected]", "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}" } } } } ``` > **Note:** Always load `JIRA_API_TOKEN` and `CONFLUENCE_API_TOKEN` from environment variables or