How to connect Jira to Claude Code

CRUX team · · Commands checked on · 7 min read
The shortest way to connect Jira to Claude Code is Atlassian's official remote MCP server: run claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp in your terminal. Then run /mcp inside Claude Code and sign in to Atlassian in the browser, and Claude Code works in Jira with your own permissions. The server is made for Jira Cloud, so a Jira Server or Data Center site needs a different route.
How do I connect Jira to Claude Code?
You need three things beforehand:
- An Atlassian Cloud site with Jira. The server is cloud-hosted and made for Atlassian Cloud apps.
- A Jira account on that site. The server acts with that account's permissions.
- A browser for the sign-in.
Add the server:
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcpThen run this in a Claude Code session, choose atlassian and sign in:
/mcpClaude Code opens the Atlassian consent screen, where you sign in and approve the access. The sign-in uses OAuth 2.1, so you paste no token. From a shell, claude mcp login atlassian starts the same sign-in.
By default Claude Code saves the server for you in the current project only. Add --scope user to use it in all your projects, or --scope project to share it with your team through a .mcp.json file in the project root. That file holds an entry in Claude Code's format:
{
"mcpServers": {
"atlassian": {
"type": "http",
"url": "https://mcp.atlassian.com/v2/mcp"
}
}
}Sign-in with an API token. For setups without a browser Atlassian accepts an API token, once an organization admin switches this on. You create a scoped token at id.atlassian.com and send it as the header Authorization: Basic <base64(email:api_token)>, which Claude Code sets with the --header flag. With a token the set of tools may be smaller, and the token is not tied to one site.
What an admin controls. An organization admin can block the domains of AI tools that connect through OAuth, and if the organization has an IP allowlist, requests must come from an address on it. If tool calls fail after sign-in, ask your admin about both.
Older guides use https://mcp.atlassian.com/v1/sse, which Atlassian stopped supporting after 30 June 2026.
How do I check that the connection works?
In the terminal:
claude mcp listThe list shows a status next to each server: ✔ Connected, ! Needs authentication or ✘ Failed to connect. Inside a session, /mcp shows the server's tool count.
Then try the prompt Atlassian suggests:
List my Jira issues.If you get your tasks back, the connection works. If the result is empty, sign in again and check the scopes you approved.
What can Claude Code do in Jira after that, and what can it not do?
With the default tools Claude Code can:
- read a task, its comments, history, links, attachments and available transitions;
- search tasks with JQL;
- read boards, sprints and backlogs;
- create and edit tasks, and add or edit comments;
- move a task to another status through a transition;
- link tasks, upload attachments and manage sprints.
These tools call a task a "work item".
The limits:
- The tools that delete tasks, comments and attachments, and the tools that create or change projects, read workflows and edit screens, are off until an admin enables them.
- Claude Code sees and changes only what your Jira account can.
- Atlassian's cross-product search and context tools consume Rovo credits from your organization's pool.
- Atlassian asks you to confirm high-impact actions yourself, because language models are open to prompt injection.
- The server gives the agent tools. It does not tell the agent who owns a status in your team or what must exist before a task moves on.
What if the connection keeps dropping?
Claude Code refreshes the sign-in by itself and retries a dropped remote server a few times. When that is not enough:
- Open
/mcp, chooseatlassianand pick Re-authenticate, or runclaude mcp login atlassianfrom the shell. - Run
/mcp reconnect allto reconnect every server (Claude Code 2.1.284 and later). - Check the scopes you approved. Atlassian's advice for an expired or narrow token is to sign in again and check the granted scopes.
Other people have hit the same thing on Atlassian Community: The MCP Auth expires too fast, Unstable Atlassian MCP Server Connection and Atlassian MCP Integration with Claude Completely Stopped Working. The threads describe sessions that end after about half an hour and errors after a token refresh.
Does this work with Jira Data Center?
Atlassian's documentation describes a cloud-hosted server for Atlassian Cloud apps, and we found no mention of Server or Data Center there. Atlassian's public tracker has an open suggestion for a Data Center MCP server, JRASERVER-78874, with the status "Gathering Interest". Community MCP servers for Data Center exist.
Claude Code or the Claude app?
Claude Code is the agent in your terminal, and claude mcp add connects it. In the Claude app (claude.ai and Claude Desktop) the same server comes as a connector: Atlassian publishes its own Atlassian connector, and Anthropic's help page explains how to use connectors.
A connector you add in claude.ai also appears in Claude Code when you sign in to Claude Code with that claude.ai account. If you also added the server with claude mcp add, that server wins, and /mcp shows the connector as hidden.
What changes when three or more people do this?
For one developer the setup above is complete. With three people, four situations appear.
Nobody owns a status. A task sits in "Plan". Ryan thinks Emily, the PM, starts the planning step, and Emily thinks Ryan does. Either can ask Claude Code to move the task, and nothing says who approves that.
Each developer has their own prompts. Ryan asks the agent for a plan before code, and another developer asks for code at once. Similar tasks get different results depending on who ran them.
Answers stay in chat. Megan from QA answers the agent's question about an edge case in Ryan's session. The answer never reaches Jira, so the next session asks again.
Nobody sees who waits for whom. One session waits for Emily's answer and another waits for a review. Jira shows both tasks as "In progress".
How does CRUX handle the team part?
We build CRUX, so this part is about our own product, and it is in beta.
What the agent needs to know about the project is already in Jira: the task, its parent and the decisions already on it. CRUX lets the agent read that, and each status in your workflow has its own instructions, so nobody writes a prompt. CRUX is the workflow layer between a team's tracker and the coding agents the team already uses. For Jira it works like this:
- It supports Jira Cloud only.
- Each member connects their own Jira account through OAuth. There is no bot account.
- Each Jira status the workflow covers has an owner role.
- A person starts each step and approves the result at approval checkpoints.
- The agent can move a task only through a transition that Jira makes available to that person.
- Each step posts its artifact as a comment on the task, where the PM and QA read it.
The details are on the page A Claude Code and Codex workflow for teams on Jira Cloud.
When is the plain MCP server enough?
- You work alone, or nobody else touches your tasks.
- Tasks are small and need no approval from PM or QA.
- The agent reads a task and writes a comment, and you move statuses yourself.
- Your team already agreed who starts and approves each step, and keeps shared prompts in the repository.
Questions
Do I need a Jira admin to connect Claude Code to my tickets?
For the OAuth sign-in Atlassian's documentation names no admin step. An admin allows API tokens, enables the delete and project tools, and unblocks a domain or an IP address.
Is the Atlassian MCP server free?
Atlassian's pages do not say which plans include it. Its cross-product search and context tools consume Rovo credits from your organization's pool.
Can Claude Code close or move my Jira tickets?
It can move a task through any transition your account may use. Deleting a task is off until an admin enables the delete tools.
Try this on your own project. CRUX is free for one person, no card.
Start freeNext: How to connect Linear to Claude Code
See also: Jira integration for Claude Code and Codex teams
All articles