atlassian-mcp

Jeffallan/claude-skillsProduct ManagementReview advisedSnapshot a87be86a38b3

Installs: 0

Summary

Integrates with Atlassian products to manage project tracking and documentation via MCP protocol. Use when querying Jira issues with JQL filters, creating and updating tickets with custom fields, searching or editing Confluence pages with CQL, managing sprints and backlogs, setting up MCP server authentication, syncing documentation, or debugging Atlassian API integrations.

SKILL.md

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

Select server - Choose official cloud, open-source, or self-hosted MCP server
Authenticate - Configure OAuth 2.1, API tokens, or PAT credentials
Design queries - Write JQL for Jira, CQL for Confluence; validate with maxResults=1 before full execution
Implement workflow - Build tool calls, handle pagination, error recovery
Verify permissions - Confirm required scopes with a read-only probe before any write or bulk operation
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

# 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

# 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"

{
  "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}"
      }
    }
  }
}

atlassian-mcp

Summary

SKILL.md

Atlassian MCP Expert

When to Use This Skill

Core Workflow

Reference Guide

Quick-Start Examples

JQL Query Samples

CQL Query Samples

Minimal MCP Server Configuration

Constraints

MUST DO

MUST NOT DO

Output Templates

Related skills