MCP 服务器

Jira MCP Server

Enables users to fetch and search Jira tickets, comments, and attachments directly within Claude Code. It features JQL support and automatically exports linked Figma designs to provide comprehensive project context.

README

Jira MCP Server

A Model Context Protocol (MCP) server that brings Jira ticket context directly into Claude Code. Fetch complete ticket information including descriptions, comments, attachments, and linked Figma designs without leaving your development environment.

Overview

When working on development tasks, context switching between Jira and your code editor breaks flow and wastes time. This MCP server solves that by:

Fetching complete ticket context - Get descriptions, comments, status, and metadata instantly
Downloading attachments - Image attachments are downloaded and displayed inline
Auto-fetching Figma designs - Linked Figma URLs are automatically detected and exported as images
Enabling natural queries - Search tickets with JQL directly from Claude Code

Features

Feature	Description
Full Ticket Details	Summary, description, status, priority, assignee, reporter, sprint, parent
Comments	All comments with author and timestamp
Attachments	Auto-download image attachments (PNG, JPG, GIF, WebP)
Linked Issues	View related tickets and their relationships
Figma Integration	Auto-detect and export Figma designs linked in tickets
JQL Search	Search across your Jira instance with powerful queries

Installation

Prerequisites

Node.js 18+
Claude Code CLI
Jira Cloud account with API access

Step 1: Add to Claude Code

claude mcp add --transport stdio jira -- npx -y @rui.branco/jira-mcp

Step 2: Get Your Jira API Token

Go to Atlassian API Tokens
Click "Create API token"
Enter a label (e.g., "Claude Code MCP")
Click "Create"
Copy the token (you won't be able to see it again)

Step 3: Configure Credentials

Run the setup with your credentials:

npx @rui.branco/jira-mcp setup "your@email.com" "YOUR_API_TOKEN" "https://company.atlassian.net"

Parameter	Description	Example
Email	Your Atlassian account email	`john@company.com`
API Token	The token you created in Step 2	`ATATT3xFfGF0...`
Base URL	Your Jira instance URL	`https://company.atlassian.net`

Or run interactively (will prompt for each value):

npx @rui.branco/jira-mcp setup

Step 4: Verify

Restart Claude Code and run /mcp to verify the server is connected.

Alternative: Manual Installation

If you prefer to install manually:

git clone https://github.com/rui-branco/jira-mcp.git ~/.config/jira-mcp
cd ~/.config/jira-mcp && npm install
node setup.js

Then add to Claude Code:

claude mcp add --transport stdio jira -- node $HOME/.config/jira-mcp/index.js

Usage

Fetch a Ticket

> Get ticket PROJ-123

# Returns full ticket with description, comments, attachments, and Figma designs

Search Tickets

> Search for my open tickets

# Uses JQL: assignee = currentUser() AND status != Done

Example Output

# PROJ-123: Implement user authentication

Status: In Progress | Type: Story | Priority: High
Assignee: John Doe | Reporter: Jane Smith

## Description
Implement OAuth2 authentication flow...

## Comments (2)
### Jane Smith - Jan 15, 2025
Please ensure we support Google SSO...

## Attachments (1)
- mockup.png (image/png, 245KB)
  [Image displayed inline]

## Figma Designs (1)
### Auth Flow Design - Login Screen
- Exported 3 image(s):
  - Login Form: ~/.config/figma-mcp/exports/...
  - Error States: ~/.config/figma-mcp/exports/...
  - Success State: ~/.config/figma-mcp/exports/...

Figma Integration

This MCP automatically detects Figma URLs in ticket descriptions and comments. When figma-mcp is configured:

Figma links are automatically fetched
Large frames are split into sections for better readability
Images are exported at 2x scale for clarity
All images are displayed inline in Claude Code

To enable Figma integration:

Install and configure figma-mcp
Restart Claude Code
Figma links will be auto-fetched when you get a ticket

API Reference

Tools

Tool	Description	Parameters
`jira_get_ticket`	Fetch a ticket by key	`issueKey` (required), `downloadImages`, `fetchFigma`
`jira_search`	Search with JQL	`jql` (required), `maxResults`

Configuration

Config stored at ~/.config/jira-mcp/config.json:

{
  "email": "your@email.com",
  "token": "YOUR_API_TOKEN",
  "baseUrl": "https://company.atlassian.net"
}

Error Handling

The server provides clear error messages:

Error	Meaning
`Figma API rate limit exceeded`	Too many Figma requests, wait a few minutes
`Figma access denied`	Check Figma token or file permissions
`Figma not configured`	Install and configure figma-mcp