Atlassian MCP Server

Skill by ara.so — MCP Skills collection.

The Atlassian Rovo MCP Server is a cloud-based remote MCP server that bridges AI agents, IDEs, and other MCP clients with Atlassian Cloud (Jira, Confluence, Compass). It enables natural language interaction with Atlassian data using secure OAuth 2.1 or API token authentication, respecting user permissions.

What It Does

Search & Summarize: Query Jira issues, Confluence pages, and Compass components
Create & Update: Generate issues, pages, and components from natural language
Automate Workflows: Link content, bulk create items, extract data across Atlassian products
Respect Permissions: All actions honor existing Atlassian Cloud access controls

Server Endpoint

https://mcp.atlassian.com/v1/mcp

The server is hosted by Atlassian (remote MCP) — no local installation required. For desktop clients (Claude, Cursor, VS Code), you'll use the

mcp-remote

proxy package.

Installation & Configuration

For Desktop Clients (Claude, Cursor, VS Code)

1. Install mcp-remote Proxy

bash

# Using npm
npm install -g @modelcontextprotocol/mcp-remote

# Using npx (no install)
npx @modelcontextprotocol/mcp-remote

2. Configure Client

Claude Desktop (

~/Library/Application Support/Claude/claude_desktop_config.json

on macOS):

json

{
  "mcpServers": {
    "atlassian-rovo": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/mcp-remote",
        "https://mcp.atlassian.com/v1/mcp"
      ],
      "env": {
        "MCP_REMOTE_AUTH_TYPE": "oauth"
      }
    }
  }
}

Cursor (

.cursor/config.json

in project root):

json

{
  "mcpServers": {
    "atlassian-rovo": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/mcp-remote",
        "https://mcp.atlassian.com/v1/mcp"
      ],
      "env": {
        "MCP_REMOTE_AUTH_TYPE": "oauth"
      }
    }
  }
}

VS Code (settings.json):

json

{
  "mcp.servers": {
    "atlassian-rovo": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/mcp-remote",
        "https://mcp.atlassian.com/v1/mcp"
      ],
      "env": {
        "MCP_REMOTE_AUTH_TYPE": "oauth"
      }
    }
  }
}

3. Authentication Flow

On first use, the client will:

Open a browser to Atlassian OAuth consent screen
Prompt you to authorize access to Jira/Confluence/Compass
Store credentials securely for future sessions

For Headless/API Token Authentication

Admins must first enable API token auth in Atlassian Administration.

json

{
  "mcpServers": {
    "atlassian-rovo": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/mcp-remote",
        "https://mcp.atlassian.com/v1/mcp"
      ],
      "env": {
        "MCP_REMOTE_AUTH_TYPE": "apitoken",
        "ATLASSIAN_EMAIL": "${ATLASSIAN_EMAIL}",
        "ATLASSIAN_API_TOKEN": "${ATLASSIAN_API_TOKEN}",
        "ATLASSIAN_CLOUD_ID": "${ATLASSIAN_CLOUD_ID}"
      }
    }
  }
}

Required environment variables:

```
ATLASSIAN_EMAIL
```
: Your Atlassian account email
```
ATLASSIAN_API_TOKEN
```
: Rovo MCP scoped API token (from Atlassian account settings)

ATLASSIAN_CLOUD_ID

: Your site URL (e.g.,

https://yoursite.atlassian.net

)

For Web Clients (ChatGPT, Gemini CLI, GitHub Copilot)

Follow client-specific documentation to add the remote MCP server:

Server URL:
```
https://mcp.atlassian.com/v1/mcp
```
Auth Type: OAuth 2.1 (browser flow)

Example for OpenAI ChatGPT:

Go to Settings → Integrations → MCP
Add server URL:
```
https://mcp.atlassian.com/v1/mcp
```
Complete OAuth flow when prompted

Optimizing Performance with AGENTS.md

Reduce token usage and tool calls by setting defaults in your project's

AGENTS.md

markdown

## Atlassian Rovo MCP

When connected to atlassian-rovo-mcp:
- **MUST** use Jira project key = MYPROJ
- **MUST** use Confluence spaceId = "123456"
- **MUST** use cloudId = "https://mysite.atlassian.net" (do NOT call getAccessibleAtlassianResources)
- **MUST** use `maxResults: 10` or `limit: 10` for ALL Jira JQL and Confluence CQL search operations.

Replace with your actual values:

```
MYPROJ
```
: Your default Jira project key
```
123456
```
: Your Confluence space ID (get from space settings)
```
https://mysite.atlassian.net
```
: Your Atlassian Cloud site URL

Common Usage Patterns

Jira Operations

Search Issues

"Find all open bugs in project MYPROJ assigned to me"

The agent will use the

jira_searchForIssuesUsingJql

tool with JQL:

jql

project = MYPROJ AND status = Open AND assignee = currentUser() AND type = Bug

Create Issue

"Create a story in MYPROJ titled 'Add dark mode support' with description 'Users want dark theme option'"

The agent calls

jira_createIssue

with payload:

javascript

{
  "cloudId": "https://mysite.atlassian.net",
  "fields": {
    "project": { "key": "MYPROJ" },
    "summary": "Add dark mode support",
    "description": "Users want dark theme option",
    "issuetype": { "name": "Story" }
  }
}

Bulk Create from Notes

"Create Jira tickets from these requirements:
1. User authentication via OAuth
2. Password reset flow
3. Email verification"

Agent creates 3 issues sequentially using

jira_createIssue

Update Issue

"Update MYPROJ-123 to set status to In Progress and add comment 'Working on this now'"

Uses

jira_editIssue

and

jira_addComment

Confluence Operations

Search Pages

"Find all Confluence pages about API documentation in the DEV space"

Uses

confluence_searchByCQL

with CQL:

cql

space = DEV AND text ~ "API documentation"

Create Page

"Create a Confluence page in space DEV titled 'API Integration Guide' with content:
# Authentication
Use OAuth 2.0 for all API requests."

Calls

confluence_createPage

javascript

{
  "cloudId": "https://mysite.atlassian.net",
  "spaceId": "123456",
  "status": "current",
  "title": "API Integration Guide",
  "body": {
    "representation": "storage",
    "value": "<h1>Authentication</h1><p>Use OAuth 2.0 for all API requests.</p>"
  }
}

Summarize Page

"Summarize the Q2 Planning page in DEV space"

Agent fetches page content and provides summary.

Compass Operations

Create Component

"Create a Compass component called 'api-gateway' of type SERVICE with description 'Main API gateway service'"

Uses

compass_createComponent

javascript

{
  "cloudId": "https://mysite.atlassian.net",
  "name": "api-gateway",
  "typeId": "SERVICE",
  "description": "Main API gateway service"
}

Query Dependencies

"What services depend on the api-gateway component?"

Uses

compass_searchComponents

to find dependencies.

Bulk Import

"Import these components from JSON:
[
  {\"name\": \"auth-service\", \"typeId\": \"SERVICE\"},
  {\"name\": \"user-db\", \"typeId\": \"DATABASE\"}
]"

Cross-Product Workflows

Link Jira to Confluence

"Link Jira issues MYPROJ-100, MYPROJ-101, MYPROJ-102 to the 'Sprint Planning' Confluence page"

Agent retrieves page, updates content with Jira macros or links.

Create Issues from Confluence

"Read the 'Feature Requests' Confluence page and create a Jira ticket for each item"

Agent:

Fetches Confluence page content
Parses items
Creates Jira issues using
```
jira_createIssue
```

Advanced Configuration

Custom Scopes

If you need specific Atlassian API scopes, configure during OAuth:

```
read:jira-work
```
: Read Jira data
```
write:jira-work
```
: Create/update Jira issues
```
read:confluence-content.all
```
: Read Confluence pages
```
write:confluence-content
```
: Create/update Confluence pages
```
read:compass:*
```
: Read Compass data
```
write:compass:*
```
: Write Compass data

The MCP server requests appropriate scopes automatically based on available tools.

IP Allowlisting

If your organization uses IP allowlisting:

Ensure your current IP is allowed in Atlassian Administration
Requests through MCP server must originate from allowed IPs
Configure VPN if working remotely

Multiple Sites

To work with multiple Atlassian sites, configure separate MCP server entries:

json

{
  "mcpServers": {
    "atlassian-prod": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/mcp-remote", "https://mcp.atlassian.com/v1/mcp"],
      "env": {
        "MCP_REMOTE_AUTH_TYPE": "oauth",
        "ATLASSIAN_CLOUD_ID": "https://prod.atlassian.net"
      }
    },
    "atlassian-staging": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/mcp-remote", "https://mcp.atlassian.com/v1/mcp"],
      "env": {
        "MCP_REMOTE_AUTH_TYPE": "oauth",
        "ATLASSIAN_CLOUD_ID": "https://staging.atlassian.net"
      }
    }
  }
}

Available Tools (Partial List)

The server exposes 50+ tools. Key examples:

Jira

```
jira_searchForIssuesUsingJql
```
```
jira_createIssue
```
```
jira_editIssue
```
```
jira_addComment
```
```
jira_getIssue
```
```
jira_deleteIssue
```
```
jira_assignIssue
```

Confluence

```
confluence_searchByCQL
```
```
confluence_createPage
```
```
confluence_updatePage
```
```
confluence_getPage
```
```
confluence_deletePage
```
```
confluence_getSpaces
```

Compass

```
compass_createComponent
```
```
compass_searchComponents
```
```
compass_getComponent
```
```
compass_updateComponent
```
```
compass_deleteComponent
```

Utility

```
getAccessibleAtlassianResources
```
(list available sites - avoid if using AGENTS.md defaults)

Troubleshooting

"Your site admin must authorize this app"

Cause: First user to connect must be a site admin.

Solution:

Have a site admin complete OAuth flow first
Once installed, regular users can connect

"You don't have permission to connect from this IP address"

Cause: IP allowlisting is enabled and your IP isn't allowed.

Solution:

Check Atlassian Administration → Security → IP allowlist
Add your IP range or VPN IP
Contact your admin if you can't modify settings

OAuth flow doesn't open browser

Cause: Headless environment or browser not configured.

Solution:

Switch to API token authentication (see headless setup above)
Or ensure
```
BROWSER
```
environment variable points to valid browser

"App not appearing in Connected apps"

Cause: Wrong account, wrong site, or permissions issue.

Solution:

Verify you're logged into correct Atlassian account
Check site URL matches
```
cloudId
```
in config
Ensure you have access to Jira/Confluence/Compass on that site
Try revoking and re-authorizing from Atlassian account settings

High token usage / slow responses

Cause: Agent calling

getAccessibleAtlassianResources

repeatedly or searching without limits.

Solution:

Add AGENTS.md configuration with
```
cloudId
```
, project, and space defaults
Always specify
```
maxResults
```
or
```
limit
```
in search queries
Cache site/project/space IDs in conversation context

Rate limiting errors

Cause: Too many API requests in short time.

Solution:

Batch operations where possible
Add delays between bulk creates
Use search with pagination instead of fetching all results

Skills for Claude Desktop

Pre-built skills available in

skills/

directory:

create-jira-issue.md: Create Jira issues from natural language
search-confluence.md: Search and summarize Confluence pages
link-content.md: Link Jira issues to Confluence pages

To use:

Copy skill file to

~/Library/Application Support/Claude/skills/

Restart Claude Desktop
Reference skill: "Use the create-jira-issue skill to make a new bug"

Admin Considerations

First-Time Setup (Admin)

First user must have access to all Atlassian products being integrated (Jira, Confluence, Compass)
Complete OAuth flow to install app (lazy/JIT installation)
App appears in Atlassian Administration → Apps → Connected apps

Enabling API Token Auth (Admin)

Go to Atlassian Administration → Security → Rovo MCP Server
Enable "API token authentication"
Users can then create scoped API tokens from account settings

Monitoring Usage

View audit logs in Atlassian Administration → Audit log
Filter by "Rovo MCP Server" to see all actions
Logs include user, timestamp, action, IP address

Revoking Access

Organization-wide:

Atlassian Administration → Apps → Connected apps
Find "Atlassian Rovo MCP Server"
Click "Revoke" or "Uninstall"

Per-user:

User profile → Account settings → Security
Connected apps → Revoke "Atlassian Rovo MCP Server"

Security Best Practices

Never commit API tokens: Use environment variables (
```
${ATLASSIAN_API_TOKEN}
```
)
Use scoped tokens: Request only needed permissions
Rotate tokens regularly: Refresh API tokens every 90 days
Monitor audit logs: Review MCP actions weekly
Enable IP allowlisting: Restrict access to known networks
Educate users: Train on what data agents can access
Revoke unused access: Remove old OAuth authorizations

atlassian-mcp-server

NPX Install

Tags

SKILL.md Content

Atlassian MCP Server

What It Does

Server Endpoint

Installation & Configuration

For Desktop Clients (Claude, Cursor, VS Code)

1. Install mcp-remote Proxy

2. Configure Client

3. Authentication Flow

For Headless/API Token Authentication

For Web Clients (ChatGPT, Gemini CLI, GitHub Copilot)

Optimizing Performance with AGENTS.md

Common Usage Patterns

Jira Operations

Search Issues

Create Issue

Bulk Create from Notes

Update Issue

Confluence Operations

Search Pages

Create Page

Summarize Page

Compass Operations

Create Component

Query Dependencies

Bulk Import

Cross-Product Workflows

Link Jira to Confluence

Create Issues from Confluence

Advanced Configuration

Custom Scopes

IP Allowlisting

Multiple Sites

Available Tools (Partial List)

Jira

Confluence

Compass

Utility

Troubleshooting

"Your site admin must authorize this app"

"You don't have permission to connect from this IP address"

OAuth flow doesn't open browser

"App not appearing in Connected apps"

High token usage / slow responses

Rate limiting errors

Skills for Claude Desktop

Admin Considerations

First-Time Setup (Admin)

Enabling API Token Auth (Admin)

Monitoring Usage

Revoking Access

Security Best Practices

Resources