1. Home
  2. MCP Atlassian
  3. MCP Atlassian for Claude Code: Setup & Config

Data as of

MCP Atlassian for Claude Code: Setup & Config

MCP Atlassian connects Claude Code to Jira and Confluence for issue tracking and team documentation.

MCP Atlassian Claude Code configuration

  1. Choose Claude Code configuration scope

    For MCP Atlassian, open Project scope: .mcp.json at the repository root. Project JSON: merge into mcpServers; user scope: use the CLI.

  2. Add MCP Atlassian to Claude Code

    Use the mcp-atlassian entry below in mcpServers. Keep MCP Atlassian's documented stdio connection fields and your other Claude Code entries.

  3. Check MCP Atlassian in Claude Code

    MCP Atlassian: Inspect claude mcp list and /mcp status.

Config file · Project scope: .mcp.json at the repository root

JSON
{
  "mcpServers": {
    "mcp-atlassian": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "<your Jira instance URL>",
        "JIRA_USERNAME": "<your Jira account email>",
        "JIRA_API_TOKEN": "<your Jira Cloud API token>",
        "CONFLUENCE_URL": "<your Confluence instance URL>",
        "CONFLUENCE_USERNAME": "<your Confluence account email>",
        "CONFLUENCE_API_TOKEN": "<your Confluence Cloud API token>"
      }
    }
  }
}

CLI (POSIX shell)
claude mcp add-json --scope project 'mcp-atlassian' '{"type":"stdio","command":"uvx","args":["mcp-atlassian"],"env":{"JIRA_URL":"<your Jira instance URL>","JIRA_USERNAME":"<your Jira account email>","JIRA_API_TOKEN":"<your Jira Cloud API token>","CONFLUENCE_URL":"<your Confluence instance URL>","CONFLUENCE_USERNAME":"<your Confluence account email>","CONFLUENCE_API_TOKEN":"<your Confluence Cloud API token>"}}'

MCP Atlassian in Claude Code: stdio checks

  • If MCP Atlassian fails to start, check uvx mcp-atlassian (from uv, for Python tools), the working directory, and Claude Code's selected scope; inspect claude mcp list and /mcp.
  • MCP Atlassian: check CONFLUENCE_API_TOKEN, CONFLUENCE_URL, CONFLUENCE_USERNAME, JIRA_API_TOKEN, JIRA_URL, JIRA_USERNAME; keep credentials out of shared .mcp.json.
  • MCP Atlassian uses stdio here: Claude Code must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
Tools
jira_search, jira_get_issue, jira_create_issue

MCP Atlassian — details. Claude Code guide

Frequently asked questions

Register MCP Atlassian with the displayed claude mcp add-json --scope project command, or merge the JSON into .mcp.json at the repository root.

Claude Code's mcp-atlassian example uses stdio.

MCP Atlassian's Claude Code configuration invokes uvx mcp-atlassian (from uv, for Python tools).

Claude Code's MCP Atlassian example references CONFLUENCE_API_TOKEN, CONFLUENCE_URL, CONFLUENCE_USERNAME, JIRA_API_TOKEN, JIRA_URL, JIRA_USERNAME. Check these names if startup or authentication fails; the example alone does not distinguish required from optional values.

MCP Atlassian's stored list contains 10 tools, including jira_search, jira_get_issue, jira_create_issue. Compare those names with Claude Code's connected tool list; the stored list is not a live check.