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 aut

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 CQL Query Samples Minimal MCP Server Configuration Note: Always load JIRA API TOKEN and CONFLUENCE API TOKEN from environment variables or a secrets manager — never hardcode credentials. Constraints MUST DO Respect user permissions and workspace access controls Validate JQL/CQL queries before execution (use maxResults=1 probe first) Handle rate limits with exponential backoff Use pagination for large result sets (50 100 items per page) Implement error recovery for network failures Log API calls for debugging and audit trails Test with read only operations first Document required permission scopes Confirm before any write or bulk operation against production data MUST NOT DO Hardcode API tokens or OAuth secrets in code Ignore rate limit headers from Atlassian APIs Create issues without validating required fields Skip input sanitization on user provided query strings Deploy without testing permission boundaries Update production data without confirmation prompts Mix different authentication methods in same session Expose sensitive issue data in logs or error messages Output Templates When implementing Atlassian MCP features, provide: 1. MCP server configuration (JSON/environment vars) 2. Query examples (JQL/CQL with explanations) 3. Tool call implementation with error handling 4. Authentication setup instructions 5. Brief explanation of permission requirements [Documentation](https://jeffallan.github.io/claude skills/skills/platform/atlassian mcp/)

atlassian-mcp