name: create-jira-mcp description: Sets up Jira MCP server integration for Claude Code. Use when setting up Jira, connecting to Atlassian, configuring MCP for ticket management, or adding Jira capabilities. allowed-tools: Bash, Read, AskUserQuestion

Create Jira MCP Integration

Purpose

Guide users through setting up the Official Atlassian Rovo MCP server to enable Claude Code to interact with Jira and Confluence.

Overview

This skill uses the Official Atlassian Rovo MCP Server which provides:

OAuth 2.1 authentication (no API tokens to manage)
Full Jira support including issue transitions
Confluence integration
Compass integration
Always up-to-date with Atlassian Cloud

Note: This only works with Atlassian Cloud (*.atlassian.net). For self-hosted Jira Server/Data Center, a different setup is required.

Available Tools After Setup

Jira Tools

createJiraIssue - Create issues
getJiraIssue - Get issue details
editJiraIssue - Modify issues
transitionJiraIssue - Change issue status
getTransitionsForJiraIssue - View available transitions
addCommentToJiraIssue - Add comments
addWorklogToJiraIssue - Add time tracking
searchJiraIssuesUsingJql - JQL search
lookupJiraAccountId - User lookup

Confluence Tools

Page creation and updates
Content retrieval and search
Comment management

Instructions

1. Check Prerequisites

Run this command to verify Node.js v18+ is installed:

node --version

If Node.js is not installed or version is below 18, inform the user they need to install Node.js v18+ first.

2. Check Existing Configuration

Run this command to check if Atlassian MCP is already configured:

claude mcp list 2>/dev/null | grep -i atlassian

If the output shows "atlassian" is already configured, inform the user and skip to Step 4 (Display Notice).

3. Add the Official Atlassian MCP Server

Run this command to add the Official Atlassian Rovo MCP server:

claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sse -s project

This registers the MCP server at project scope (creates .mcp.json in project root, can be committed for team sharing).

If the user specifically requests global/user scope, use this instead:

claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sse -s user

4. Display Restart and Auth Notice

IMPORTANT: After completing setup, you MUST display this notice to the user:

================================================
  RESTART REQUIRED + OAUTH LOGIN
================================================
  The Atlassian MCP server has been configured.

  Next steps:
  1. Restart Claude Code
  2. On first use, a browser window will open
     for OAuth authentication with Atlassian
  3. Log in with your Atlassian account
  4. Grant the requested permissions

  After authentication:
  - Run /mcp to verify the server is connected
  - Test with: "List all Jira projects"
  - Try: "Transition PROJ-123 to Done"
================================================

Output Format

Execute the setup commands directly using Bash tool. Do not just display commands for the user to copy - actually run them.

After running the setup, always end with the restart/auth notice - this is mandatory.

Troubleshooting

OAuth login fails:

Ensure you have access to the Atlassian Cloud site
Try a different browser if the OAuth window doesn't open
Check browser popup blockers

Frequent re-authentication:

This is a known issue with the Rovo MCP server
Re-run any command to trigger a new OAuth flow when needed

MCP not connecting:

Restart Claude Code after adding the server
Check /mcp shows the atlassian server
Verify with: claude mcp list

"Not supported" errors:

The Official Atlassian MCP only works with Atlassian Cloud
Self-hosted Jira Server/Data Center requires a different MCP server

Node.js issues:

Ensure Node.js v18+ is installed
The MCP proxy requires Node.js to run locally

Removing the Server

To remove the Atlassian MCP server:

claude mcp remove atlassian -s project

Or for user/global scope:

claude mcp remove atlassian -s user

Example

User: "Set up Jira MCP for my project"

Assistant actions:

Run node --version to verify Node.js v18+ is installed
Run claude mcp list to check if Atlassian MCP is already configured
If not configured, run claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sse -s project
Display the RESTART + OAUTH notice
Explain that a browser window will open on first use for authentication

The skill should execute the commands directly, not just display them for the user to copy.