Codex_CLI-Atlassian MCP.md

Atlassian MCP for Codex CLI on Ubuntu

1. Prerequisites

• codex installed and working (codex --version)
• Atlassian Cloud access (Jira/Confluence) with browser login available

2. Configure Codex

Edit ~/.codex/config.toml and add:

[mcp_servers.atlassian]
url = "https://mcp.atlassian.com/v1/mcp/authv2"

Authenticate:

codex mcp login atlassian

Validate config:

codex mcp list
codex mcp get atlassian

Expected:

• atlassian appears as enabled
• transport is HTTP / streamable HTTP
• Auth uses OAuth after login

3. Test the Integration

Run:

codex exec --skip-git-repo-check "Use Atlassian MCP and list available tools."

Expected:

• Atlassian MCP initializes
• Jira + Confluence tools are available
• tool calls succeed using your Atlassian permissions

4. Functional Test (Real Query)

Example:

codex

Then prompt:

Use the Atlassian MCP to search Jira or Confluence for any topic I can access.

Expected:

• search returns matching Confluence/Jira results
• fetch can open specific page/issue results
• returned data matches your Atlassian permissions

5. Troubleshooting

• If auth is stale: run codex mcp logout atlassian, then codex mcp login atlassian.
• If the browser does not open: copy the login URL from the terminal into your browser.
• If org policy blocks access: verify Atlassian MCP access and site permissions.