📘 Introduction

Jira issues often contain the real context behind a coding task: bug reports, acceptance criteria, priorities, comments, and links to related work.

In this tutorial, you will learn how to connect the Codex App to Jira with MCP. We will not build our own Jira MCP server. Instead, we will use the official Atlassian Rovo MCP Server and connect to it through the local mcp-remote proxy.

💡 What are we implementing?

We will set up this workflow:

Codex App -> Codex MCP config -> mcp-remote -> official Atlassian Rovo MCP Server -> Jira

Once connected, Codex can use Jira context for coding workflows such as:

  • reading a Jira issue
  • summarizing acceptance criteria
  • turning a bug report into an implementation plan
  • checking whether code changes match a Jira story
  • drafting a pull request summary from a Jira ticket

✅ Prerequisites

Before we start, you should have:

☑️ Codex App installed
☑️ A Codex workspace where you can edit MCP configuration
☑️ Node.js 18 or newer installed
☑️ npx available in your terminal
☑️ Access to an Atlassian Cloud site with Jira
☑️ Permission to connect MCP clients to your Atlassian account

🔍1️⃣ Check Node.js and npx

The Atlassian setup for desktop clients uses a Node.js-based proxy tool called mcp-remote. First, check that Node.js and npx are available:

node --version
npx --version

Atlassian recommends Node.js 18 or later for this setup. If Node.js is missing, install it first and restart your terminal.

📦2️⃣ Install package

You do not need to install or build a custom Jira MCP server. We will use mcp-remote through npx.

Run this command once to test the Atlassian MCP connection and trigger the authorization flow:

npx -y mcp-remote@latest https://mcp.atlassian.com/v1/mcp/authv2

Your browser should open so you can authorize access to your Atlassian account. Keep the terminal open while testing the connection.

Atlassian notes that older setups using https://mcp.atlassian.com/v1/sse will no longer be supported after June 30, 2026. Use the newer /mcp/authv2 endpoint shown above.

🧩3️⃣ Add the Atlassian MCP server to Codex App

Now add the MCP server to the Codex configuration.

You can view this post with the tier: Academy Membership

Join academy now to read the post and get access to the full library of premium posts for academy members only.

Join Academy Already have an account? Sign In