Skip to main content

MCP-Atlassian Integration Guide

· 2 min read

Pre-requisites​

Install Docker (if not already installed) Visit https://docs.docker.com/engine/install/ and follow the instructions.

🔐 Authentication Setup​

  1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
  2. Click Create API token, name it
  3. Copy the API_TOKEN immediately

Integrate MCP Server​

With Cursor​

Source: Cursor MCP, Usage

To use the cloud-based server with Cursor:

  • Open your Cursor account.

  • On the upper right-hand side, click the gear icon to open the Cursor Settings dialog.

  • In the left sidebar, click Tools & Integrations.

  • Under MCP Tools, click New MCP Server to open the editor for the mcp.json file.

image.png Configuration mcp.json examples

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CONFLUENCE_URL",
        "-e",
        "CONFLUENCE_USERNAME",
        "-e",
        "CONFLUENCE_API_TOKEN",
        "-e",
        "JIRA_URL",
        "-e",
        "JIRA_USERNAME",
        "-e",
        "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://f8a.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "long.tran@f8a.io",
        "CONFLUENCE_API_TOKEN": "API_TOKEN",
        "JIRA_URL": "https://f8a.atlassian.net",
        "JIRA_USERNAME": "long.tran@f8a.io",
        "JIRA_API_TOKEN": "API_TOKEN"
      }
    }
  }
}

With Intellij Github Copilot​

Source: intellij-github-copilot-mcp

In JetBrains IDEs: Click the GitHub Copilot icon -> Edit settings -> find the MCP Servers section.

img.png

Configuration mcp.json examples

{
    "servers": {
        "mcp-atlassian": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e", "CONFLUENCE_URL",
                "-e", "CONFLUENCE_USERNAME",
                "-e", "CONFLUENCE_API_TOKEN",
                "-e", "JIRA_URL",
                "-e", "JIRA_USERNAME",
                "-e", "JIRA_API_TOKEN",
                "ghcr.io/sooperset/mcp-atlassian:latest"
            ],
            "env": {
                "CONFLUENCE_URL": "https://f8a.atlassian.net/wiki",
                "CONFLUENCE_USERNAME": "long.tran@f8a.io",
                "CONFLUENCE_API_TOKEN": "API_TOKEN",
                "JIRA_URL": "https://f8a.atlassian.net",
                "JIRA_USERNAME": "long.tran@f8a.io",
                "JIRA_API_TOKEN": "API_TOKEN"
            }
        }
    }
}

Log work magically​

Log work for issues CEX-149, CEX-150, CEX-151, CEX-145, CEX-219 
across date range August 18-22
distributing 8 hours per day across the issues.
Date format is yyyy-MM-dd'T'HH:mm:ss.SSSZ