MCP Atlassian Docker

A Model Context Protocol (MCP) server for Atlassian products (Jira & Confluence) running in Docker.

Prerequisites

• Docker and docker-compose installed
• Atlassian personal access tokens for Jira and Confluence

Installation

Using npx (recommended)

npx mcp-atlassian-docker

Global installation

npm install -g mcp-atlassian-docker
mcp-atlassian-docker

Configuration

For Claude Desktop or MCP Clients

Add this to your MCP configuration file (e.g., .mcp.json or Claude Desktop config):

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "npx",
      "args": ["-y", "mcp-atlassian-docker"],
      "env": {
        "CONFLUENCE_URL": "https://your-confluence.atlassian.net",
        "CONFLUENCE_PERSONAL_TOKEN": "your_confluence_token",
        "CONFLUENCE_SSL_VERIFY": "true",
        "JIRA_URL": "https://your-jira.atlassian.net",
        "JIRA_PERSONAL_TOKEN": "your_jira_token",
        "JIRA_SSL_VERIFY": "true"
      }
    }
  }
}

Environment Variables

| Variable | Description | Required | Default | |----------|-------------|----------|---------| | CONFLUENCE_URL | Your Confluence instance URL | Yes | - | | CONFLUENCE_PERSONAL_TOKEN | Confluence personal access token | Yes | - | | CONFLUENCE_SSL_VERIFY | Enable SSL verification for Confluence | No | true | | JIRA_URL | Your Jira instance URL | Yes | - | | JIRA_PERSONAL_TOKEN | Jira personal access token | Yes | - | | JIRA_SSL_VERIFY | Enable SSL verification for Jira | No | true |

Getting Personal Access Tokens

Confluence

1. Go to your Confluence settings
2. Navigate to Personal Access Tokens
3. Create a new token with appropriate permissions

Jira

1. Go to your Jira settings
2. Navigate to Personal Access Tokens
3. Create a new token with appropriate permissions

Usage

Once configured in your MCP client, the server will be automatically started when needed.

Manual Testing

You can test the server manually:

CONFLUENCE_URL="https://your-confluence.atlassian.net" \
CONFLUENCE_PERSONAL_TOKEN="your_token" \
JIRA_URL="https://your-jira.atlassian.net" \
JIRA_PERSONAL_TOKEN="your_token" \
npx mcp-atlassian-docker

Features

This MCP server provides access to:

• Jira issues, projects, and workflows
• Confluence pages and spaces
• Search and query capabilities
• Create, update, and delete operations

For detailed API documentation, refer to the mcp-atlassian project.

Troubleshooting

Docker not found

Ensure Docker and docker-compose are installed and in your PATH:

docker --version
docker-compose --version

Permission denied

On Linux/macOS, you may need to add your user to the docker group:

sudo usermod -aG docker $USER

SSL verification issues

If you're using self-signed certificates or encountering SSL errors, set:

CONFLUENCE_SSL_VERIFY=false
JIRA_SSL_VERIFY=false

License

MIT

Credits

This package wraps the excellent mcp-atlassian Docker image by sooperset.