Claude_CLI_Atlassian_MCP_install_guide.md

Atlassian MCP for Claude Code on Ubuntu

Prereqs

• claude --version
• node -v
• Atlassian Cloud access
• Browser login available for OAuth

Install

Claude Code now supports Atlassian directly over HTTP. Use /v1/mcp, not the old /v1/sse.

claude mcp add --transport http --scope user atlassian https://mcp.atlassian.com/v1/mcp

Verify the config:

claude mcp list
claude mcp get atlassian

Expected before login:

• atlassian: https://mcp.atlassian.com/v1/mcp (HTTP) - ! Needs authentication

Authenticate

Open Claude Code and you should see a warning on the right hand side to run /mcp.

Follow the instructions to trigger the OAuth flow and grant access to your Atlassian account. This will allow Claude Code to access resources like Jira and Confluence on your behalf.

Or run a real MCP prompt to trigger OAuth:

claude -p "Use atlassian MCP and list accessible resources."

Claude will print an Atlassian authorization URL. Open it in your browser and complete the consent flow.

Note: the first user authorizing a tenant may need Atlassian Site Admin access.

Test

After OAuth succeeds, run:

claude --dangerously-skip-permissions -p "Use atlassian MCP and list accessible resources."

Fallback

If direct HTTP OAuth is blocked or unstable, use the same mcp-remote proxy flow that works for Codex/Gemini:

claude mcp add --scope user atlassian -- npx -y mcp-remote@latest https://mcp.atlassian.com/v1/mcp

Troubleshooting

• Use https://mcp.atlassian.com/v1/mcp
• Do not use /v1/sse
• If the browser redirect fails, rerun claude mcp add with --callback-port <port>
• If org policy blocks auth, check Atlassian allowlists and MCP domain policy

nice!