atlassian-dc-mcp

This project provides a Model Context Protocol (MCP) integration for Atlassian Data Center products, including Jira, Confluence, and Bitbucket.

Official Anthropic quick start guide

To use these MCP connectors with Claude Desktop, add the following to your Claude Desktop configuration.

Set *_HOST variables only to domain + port without protocol (e.g., your-instance.atlassian.net). The https protocol is assumed.

You can leave only the services you need in the configuration.

macOS:

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

Windows:

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/jira"],
      "env": {
        "JIRA_HOST": "your-jira-host",
        "JIRA_API_TOKEN": "your-token"
      }
    },
    "atlassian-confluence-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/confluence"],
      "env": {
        "CONFLUENCE_HOST": "your-confluence-host",
        "CONFLUENCE_API_TOKEN": "your-token"
      }
    },
    "atlassian-bitbucket-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/bitbucket"],
      "env": {
        "BITBUCKET_HOST": "your-bitbucket-host",
        "BITBUCKET_API_TOKEN": "your-token"
      }
    }
  }
}

For Data Center installations, you'll need to generate Personal Access Tokens (PAT) for each service:

1. Log in to your Jira instance
2. Go to Profile > Personal Access Tokens
3. Click "Create token"
4. Give it a meaningful name and set appropriate permissions
5. Copy the generated token immediately (it won't be shown again)

1. Log in to your Confluence instance
2. Go to Settings > Personal Access Tokens
3. Click "Create token"
4. Name your token and set required permissions
5. Save and copy the token (only shown once)

1. Log in to Bitbucket
2. Go to Manage Account > HTTP access tokens
3. Click "Create token"
4. Set a name and permissions
5. Generate and copy the token immediately

Store these tokens securely and use them in your Claude Desktop configuration as shown above.

The Atlassian DC MCP allows AI assistants to interact with Atlassian products through a standardized interface. It provides tools for:

• Jira: Search, view, and create issues
• Confluence: Access and manage content
• Bitbucket: Interact with repositories and code

• Node.js 18 or higher
• npm 7 or higher (for workspaces support)
• Atlassian Data Center instance or Cloud instance
• API tokens for the Atlassian products you want to use

Clone the repository:

git clone https://github.com/b1ff/atlassian-dc-mcp.git
cd atlassian-dc-mcp

This project is structured as an npm monorepo using workspaces. The workspaces are organized in the packages/ directory, with separate packages for each Atlassian product integration.

To install all dependencies for all packages in the monorepo:

npm install

This will install:

• Root-level dependencies defined in the root package.json
• All dependencies for each package in the workspaces

To install a dependency for a specific package:

npm install <package-name> --workspace=@atlassian-dc-mcp/jira

To install a dependency at the root level:

npm install <package-name> -W

To build all packages:

npm run build

To build a specific package:

npm run build --workspace=@atlassian-dc-mcp/jira

To run a specific package in development mode:

npm run dev:jira     # For Jira
npm run dev:confluence  # For Confluence
npm run dev:bitbucket   # For Bitbucket

Create a .env file in the root directory with the following variables:

# Jira configuration
JIRA_HOST=your-instance.atlassian.net
JIRA_API_TOKEN=your-api-token

# Confluence configuration
CONFLUENCE_HOST=your-instance.atlassian.net
CONFLUENCE_API_TOKEN=your-api-token

# Bitbucket configuration
BITBUCKET_HOST=your-instance.atlassian.net
BITBUCKET_API_TOKEN=your-api-token

MIT