atlassian-mcp-server

Connect Jira, Confluence, and Compass to AI agents via Atlassian's remote MCP server.

7|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/mcp-skills --skill atlassian-mcp-server-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: atlassian-mcp-server
Source: https://github.com/reason-machines/mcp-skills/tree/main/skills/atlassian-mcp-server
Command: npx skills add https://github.com/reason-machines/mcp-skills --skill atlassian-mcp-server-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @modelcontextprotocol/mcp-remote.

What problem does it solve? Teams using Jira, Confluence, and Compass must constantly switch between their IDE and Atlassian web apps to search issues, create tickets, or update documentation. This Skill connects AI agents and IDEs directly to Atlassian Cloud through the remote Rovo MCP server, enabling natural language interaction with Atlassian data while respecting existing permissions. ## Core Features & Use Cases - Jira Issue Management: Search issues with JQL, create and update tickets, add comments, and bulk-create issues from notes or requirements. - Confluence Page Operations: Search pages with CQL, create and update pages, and summarize documentation content. - Compass Component Tracking: Create components, query service dependencies, and bulk-import catalog entries. - Use Case: A developer finishes a sprint planning meeting and asks the agent to read the 'Feature Requests' Confluence page, then automatically create a linked Jira ticket for each item in the MYPROJ project. ## Quick Start Connect to the Atlassian MCP server and create a Jira story in project MYPROJ titled 'Add dark mode support'.

Frequently Asked Questions about atlassian-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Claude Desktop to the Atlassian MCP server?▼

Add an mcpServers entry in claude_desktop_config.json that runs npx @modelcontextprotocol/mcp-remote pointing to https://mcp.atlassian.com/v1/mcp with MCP_REMOTE_AUTH_TYPE set to oauth. On first use, a browser opens for the Atlassian OAuth consent flow.

How to create Jira issues from an IDE using MCP?▼

Ask the agent in natural language, for example to create a story in a project with a title and description. The agent calls the jira_createIssue tool with your cloudId, project key, summary, description, and issue type.

Does the Atlassian MCP server support headless authentication?▼

Yes, headless environments can use API token authentication instead of OAuth. An admin must enable API token auth in Atlassian Administration, then set ATLASSIAN_EMAIL, ATLASSIAN_API_TOKEN, and ATLASSIAN_CLOUD_ID environment variables.

Why does the Atlassian MCP OAuth flow fail with an admin authorization error?▼

The first user to connect must be a site admin because the app installs lazily on first authorization. Have a site admin complete the OAuth flow once, after which regular users can connect normally.

How do I reduce token usage with the Atlassian Rovo MCP server?▼

Add defaults to your project's AGENTS.md file specifying the Jira project key, Confluence spaceId, and cloudId so the agent skips getAccessibleAtlassianResources calls. Also set maxResults or limit to 10 on all JQL and CQL searches.

Can I use the Atlassian MCP server with multiple Atlassian sites?▼

Yes, configure separate MCP server entries in your client config, each with its own ATLASSIAN_CLOUD_ID pointing to a different site URL such as production and staging environments.