JIRA MCP Integration logo

JIRA MCP Integration

by MankowskiNick

The JIRA MCP Integration is a Model Context Protocol server that allows Claude to create JIRA tickets directly within conversations. It integrates JIRA with Claude, enabling seamless ticket creation and management.

View on GitHub

Last updated: N/A

What is JIRA MCP Integration?

The JIRA MCP Integration is a server that connects JIRA with the Claude AI assistant using the Model Context Protocol. It enables users to create and manage JIRA tickets directly from their Claude conversations.

How to use JIRA MCP Integration?

To use the JIRA MCP Integration, you need to clone the repository, install dependencies, build the project, and configure the claude_desktop_config.json file with your JIRA credentials and custom field settings. Once configured, you can ask Claude to create JIRA tickets by providing the necessary details in your conversation.

Key features of JIRA MCP Integration

  • Create JIRA tickets with summary, description, acceptance criteria, and issue type

  • Assign story points to Story tickets

  • Automatically create linked Test tickets for Stories with points

  • Seamless integration with Claude desktop application

  • Simple configuration using Claude's desktop configuration file

Use cases of JIRA MCP Integration

  • Creating bug reports directly from Claude conversations.

  • Generating tasks for new features based on discussions in Claude.

  • Creating user stories with acceptance criteria defined through Claude.

  • Automating the creation of test tickets linked to user stories.

FAQ from JIRA MCP Integration

How do I get a JIRA API token?

Log in to your Atlassian account, go to Security > API tokens, and create a new token.

Where is the claude_desktop_config.json file located?

On macOS, it's located at ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows, it's located at %APPDATA%\Roaming\Claude\claude_desktop_config.json.

What are the required JIRA environment variables?

The required environment variables are JIRA_HOST, JIRA_USERNAME, JIRA_API_TOKEN, and JIRA_PROJECT_KEY.

How do I create a ticket with acceptance criteria?

Include the acceptance criteria in your request to Claude, and it will be stored in the configured JIRA_ACCEPTANCE_CRITERIA_FIELD.

Why are my tickets not being created?

Check your JIRA credentials, the path to the index.js file, and ensure Claude has permission to use tools. Also, check Claude's console logs for error messages.