MCP Server Setup¶

BMAtlassian needs an Atlassian MCP server to interact with Jira and Confluence. Two options are supported.

Option A: mcp-atlassian Standalone (Recommended)¶

The standalone mcp-atlassian server provides the full toolset including Jira Agile API support (sprint creation, sprint assignment, sprint queries).

Using uvx (recommended)Using Docker

{
  "mcpServers": {
    "atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      }
    }
  }
}

{
  "mcpServers": {
    "atlassian": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "JIRA_URL",
        "-e", "JIRA_USERNAME",
        "-e", "JIRA_API_TOKEN",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_USERNAME",
        "-e", "CONFLUENCE_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      }
    }
  }
}

Generate an API token at: https://id.atlassian.com/manage-profile/security/api-tokens

Option B: Claude Code Atlassian Plugin¶

If you use Claude Code, the built-in Atlassian plugin works for most operations:

claude plugin add atlassian@claude-plugins-official

The plugin handles authentication via OAuth -- no API tokens needed. However, it does not support sprint management (creating sprints, assigning issues to sprints). Sprint planning will fall back to JQL queries with manual sprint assignment in the Jira UI.

Capability Comparison¶

Operation	mcp-atlassian (standalone)	Claude Code Plugin
Create/edit issues	Yes	Yes
Search (JQL/CQL)	Yes	Yes
Transitions	Yes	Yes
Comments	Yes	Yes
Confluence pages	Yes	Yes
Create sprints	Yes	No (manual via Jira UI)
Assign issues to sprints	Yes	No (manual via Jira UI)
Query sprint contents	Yes	JQL fallback: `sprint in openSprints()`

All BMAtlassian workflow instructions use a dual-mode pattern: try the full tool first, then fall back gracefully if only the plugin is available.