de en es ja ko ru zh

Jira MCP Server

Name: Jira MCP Server
Author: rui-branco

by rui-branco

Overview Schema Related Servers Score Discussions

JavaScript

Remote

Jira MCP 服务器

一个 Model Context Protocol (MCP) 服务器，将 Jira 工单上下文直接引入 Claude Code。无需离开开发环境，即可获取完整的工单信息，包括描述、评论、附件和关联的 Figma 设计。

概述

在进行开发任务时，在 Jira 和代码编辑器之间切换上下文会打断思路并浪费时间。此 MCP 服务器通过以下方式解决了这个问题：

获取完整的工单上下文 - 即时获取描述、评论、状态和元数据
下载附件 - 自动下载图像附件并内联显示
自动获取 Figma 设计 - 自动检测关联的 Figma URL 并将其导出为图像
支持自然语言查询 - 直接从 Claude Code 使用 JQL 搜索工单

Related MCP server: JIRA MCP Server

功能

功能	描述
完整的工单详情	摘要、描述、状态、优先级、经办人、报告人、冲刺、父级
评论	包含作者和时间戳的所有评论
附件	自动下载图像附件 (PNG, JPG, GIF, WebP)
关联问题	查看相关工单及其关系
Figma 集成	自动检测并导出工单中关联的 Figma 设计
JQL 搜索	使用强大的查询功能搜索您的 Jira 实例

安装

前置要求

Node.js 18+
Claude Code CLI
具有 API 访问权限的 Jira Cloud 账户

第 1 步：添加到 Claude Code

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

第 2 步：获取您的 Jira API 令牌

前往 Atlassian API 令牌
点击 “Create API token”
输入标签（例如 “Claude Code MCP”）
点击 “Create”
复制令牌（之后将无法再次查看）

第 3 步：配置凭据

使用您的凭据运行设置：

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

参数	描述	示例
Email	您的 Atlassian 账户邮箱	`john@company.com`
API Token	您在第 2 步中创建的令牌	`ATATT3xFfGF0...`
Base URL	您的 Jira 实例 URL	`https://company.atlassian.net`

或者以交互方式运行（将提示输入每个值）：

npx @rui.branco/jira-mcp setup

第 4 步：验证

重启 Claude Code 并运行 /mcp 以验证服务器是否已连接。

替代方案：手动安装

如果您更喜欢手动安装：

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

然后添加到 Claude Code：

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

使用方法

获取工单

> Get ticket PROJ-123

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

搜索工单

> Search for my open tickets

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

添加带有提及的评论

使用 @FirstName LastName 语法在评论中提及用户：

> Add a comment to PROJ-123: "@John Doe Please review this implementation"

# The mention is automatically resolved and the user gets notified

示例输出

# 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 集成

此 MCP 会自动检测工单描述和评论中的 Figma URL。当配置了 figma-mcp 时：

自动获取 Figma 链接
将大型框架拆分为多个部分以提高可读性
图像以 2 倍比例导出以保持清晰度
所有图像均在 Claude Code 中内联显示

要启用 Figma 集成：

安装并配置 figma-mcp
重启 Claude Code
当您获取工单时，Figma 链接将自动获取

API 参考

工具

工具	描述	参数
`jira_get_myself`	获取当前已认证用户的 accountId 和信息（用于分配工单）	无
`jira_get_ticket`	通过键值获取工单，包含描述、评论、附件和 Figma 设计	`issueKey` (必填), `downloadImages`, `fetchFigma`
`jira_search`	使用 JQL 搜索工单	`jql` (必填), `maxResults`
`jira_add_comment`	向工单添加评论（支持 @提及）	`issueKey` (必填), `comment` (必填)
`jira_reply_comment`	回复特定评论（带引用和提及）	`issueKey` (必填), `commentId` (必填), `reply` (必填)
`jira_edit_comment`	编辑现有评论（支持 @提及）	`issueKey` (必填), `commentId` (必填), `comment` (必填)
`jira_delete_comment`	删除评论（不可逆）	`issueKey` (必填), `commentId` (必填)
`jira_transition`	按名称或 ID 更改工单状态（自动处理中间步骤）	`issueKey` (必填), `targetStatus` 或 `transitionId`
`jira_update_ticket`	更新工单字段（摘要、描述、经办人、优先级、标签）	`issueKey` (必填), 以及可选的字段参数

Confluence 工具

此 MCP 还通过相同的 Atlassian 凭据公开 Confluence。在 Atlassian Cloud 上，您为 Jira 配置的 API 令牌也适用于 Confluence，且 Confluence 的基础 URL 推导为 <jiraBaseUrl>/wiki —— 无需额外设置。只需针对任何已配置的实例使用下方的 confluence_* 工具即可。

对于 Confluence 位于不同主机的服务器/数据中心部署，请在 config.json 的已存储实例中显式设置 confluenceBaseUrl。

工具	描述	参数
`confluence_get_spaces`	列出全局空间 (`key`, `name`, `id`)	`instance`
`confluence_get_space`	获取单个空间及其描述和主页	`spaceKey` (必填), `instance`
`confluence_create_space`	创建新的全局空间	`spaceKey` (必填), `name` (必填), `description`, `instance`
`confluence_update_space`	更新空间的名称和/或描述	`spaceKey` (必填), `name`, `description`, `instance`
`confluence_delete_space`	删除空间（在 Cloud 上为异步）	`spaceKey` (必填), `instance`
`confluence_search`	CQL 文本搜索 (`text ~ "<query>" AND type = <type>`)	`query` (必填), `spaceKey`, `type`, `limit`, `instance`
`confluence_get_recent_pages`	最近 N 天内修改的页面	`sinceDays` (默认 30), `spaceKey`, `limit`, `instance`
`confluence_get_space_root_pages`	空间中具有 `childTypes.page` 的顶级页面	`spaceKey` (必填), `limit`, `instance`
`confluence_get_page_children`	页面的直接子页面	`pageId` (必填), `limit`, `instance`
`confluence_get_page`	包含 `body.view`、`body.storage` 以及（默认）合并后的 v2 `body.atlas_doc_format` 的完整页面	`pageId` (必填), `includeAdf`, `instance`
`confluence_get_comments`	列出页面上的评论	`pageId` (必填), `limit`, `instance`
`confluence_add_comment`	添加页脚评论（默认包装为存储 XHTML 的纯文本）	`pageId` (必填), `body` (必填), `format` (`text`/`storage`), `instance`
`confluence_update_page`	更新标题/正文；如果未提供，则自动增加版本号	`pageId` (必填), `title`, `body` (存储 XHTML), `version`, `instance`
`confluence_create_page`	创建带有可选父级的页面	`spaceKey`, `title`, `body` (存储 XHTML) (均为必填), `parentId`, `instance`
`confluence_delete_page`	删除页面	`pageId` (必填), `instance`
`confluence_get_labels`	列出页面上的标签	`pageId` (必填), `instance`
`confluence_add_label`	向页面添加标签	`pageId` (必填), `label` (必填), `instance`
`confluence_remove_label`	从页面移除标签	`pageId` (必填), `label` (必填), `instance`
`confluence_list_attachments`	列出页面上的附件	`pageId` (必填), `limit`, `instance`
`confluence_upload_attachment`	从磁盘或 base64 内容上传文件	`pageId` (必填), `filePath` 或 `fileContent`+`fileName`, `comment`, `instance`
`confluence_download_attachment`	按文件名将附件下载到本地附件目录	`pageId` (必填), `filename` (必填), `instance`

为什么 confluence_get_page 使用 ADF？ v1 body.atlas_doc_format 扩展在现代 Cloud 页面上不可靠 —— 表格单元格背景颜色和一些较新的节点类型只能在 v2 /api/v2/pages/<id>?body-format=atlas_doc_format 端点中保留。因此，confluence_get_page 会并行执行两个请求，并将 v2 ADF 正文合并到 v1 响应中，以便调用者一次性获得 body.view、body.storage 和 body.atlas_doc_format。

配置

配置存储在 ~/.config/jira-mcp/config.json：

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

错误处理

服务器提供清晰的错误消息：

错误	含义
`Figma API rate limit exceeded`	Figma 请求过多，请等待几分钟
`Figma access denied`	检查 Figma 令牌或文件权限
`Figma not configured`	安装并配置 figma-mcp

安全性

API 令牌存储在本地 ~/.config/jira-mcp/config.json 中
配置文件通过 .gitignore 从 git 中排除
令牌除发送至 Jira/Figma API 外，绝不会被记录或传输
附件下载至 ~/.config/jira-mcp/attachments/

许可证

MIT

相关

figma-mcp - 用于 Claude Code 的 Figma MCP 服务器
Model Context Protocol - MCP 规范

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

7moRelease cycle

2Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Jira MCP Server
Project Management Command Line
SunWooBang
A
license
C
quality
D
maintenance
Connects Jira with Claude, enabling users to search issues, view issue details, update issues, add comments, and retrieve project information through natural language commands.
Updated a year ago (2025-06-27 00:12 UTC)
1
98
1
MIT
JIRA MCP Server
Project Management Developer Tools
rajsodhi-2
A
license
Not graded
quality
D
maintenance
Enables Claude AI to interact with JIRA for project management and issue tracking, supporting JQL queries, comprehensive issue details retrieval with subtasks and linked issues, and release planning analysis.
Updated 4 months ago (2026-04-15 23:31 UTC)
MIT
Atlassian Jira MCP Server
Project Management Developer Tools
aashari
A
license
Not graded
quality
D
maintenance
Connects AI assistants like Claude to Jira projects, enabling natural language queries and operations for issue management, project tracking, comments, and workflows through the Jira REST API.
Updated 6 months ago (2026-03-06 07:29 UTC)
14,799
72
ISC
Simple Jira MCP
Project Management Developer Tools App Automation
timohaa
A
license
Not graded
quality
A
maintenance
Provides Jira Cloud integration for AI agents, enabling them to search issues with JQL, retrieve detailed issue information, and create new tickets. It supports multiple Jira configurations and provides tools for managing attachments and comments through natural language.
Updated a month ago (2026-08-01 16:12 UTC)
MIT

View all related MCP servers

Related MCP Connectors

Atlassian Rovo MCP Server
Connect to Atlassian Jira, Confluence, and Compass to search, create, and manage your work.
Rootr
Connect your team's living knowledge base — docs, data, issues, CRM — to Claude and ChatGPT.
Fathom MCP Server
Connect Claude to Fathom meeting recordings, transcripts, and summaries

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rui-branco/jira-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server