Jira MCP 配置指南

将 Jira 通过 Model Context Protocol（MCP）接入 Cursor IDE，实现在编辑器内直接查询和操作 Jira。

---

前置条件

• Atlassian Cloud 账号（具备 Jira 访问权限）
• 已安装 Cursor IDE
• 网络可访问公司 Jira 实例

---

第一步 — 获取 Atlassian API Token

1. 打开 https://id.atlassian.com/manage-profile/security/api-tokens
2. 点击 Create API token
3. 填写标签（如 cursor-mcp），复制生成的 token

---

第二步 — 安装 uvx

uvx 直接在宿主机运行 MCP 服务器，无需 Docker，不存在网络隔离问题。

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装完成后，将以下路径加入系统 PATH 环境变量：

C:\Users\<用户名>\.local\bin

或在当前 PowerShell 会话中临时生效：

$env:Path = "C:\Users\<用户名>\.local\bin;$env:Path"

---

第三步 — 配置 Cursor MCP

编辑 C:\Users\<用户名>\.cursor\mcp.json：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://你的实例.atlassian.net",
        "JIRA_USERNAME": "你的Atlassian邮箱",
        "JIRA_API_TOKEN": "<你的 API Token>",
        "READ_ONLY_MODE": "true"
      }
    }
  }
}

安全提示：mcp.json 中包含 API Token，请勿提交到版本控制系统。

---

第四步 — 重启 Cursor

保存 mcp.json 后，重启 Cursor 以加载新的 MCP 配置。

验证方式：打开 Cursor Settings → Tools and Integrations → MCP，确认 mcp-atlassian 状态为已连接。

---

使用示例

连接成功后，直接在 Cursor AI 对话框中用自然语言查询：

列出分配给我的所有 In Progress 工单

获取 UPWP-585 的详细信息

查询 Epic UPWP-402 下的所有 Story

搜索项目中分配给指定成员的所有 Backlog Bug

常用 JQL 参考

目标	JQL
我的进行中工单	assignee = currentUser() AND status = "In Progress"
项目所有 Bug	project = UPWP AND issuetype = Bug ORDER BY priority ASC
Epic 下的所有 Issue	project = UPWP AND "Epic Link" = UPWP-402
最近更新	project = UPWP ORDER BY updated DESC

---

可用工具

mcp-atlassian 提供以下 Jira 工具：

工具	说明
jira_search	使用 JQL 搜索工单
jira_get_issue	获取指定工单的完整详情
jira_create_issue	创建新工单（需 READ_ONLY_MODE=false）
jira_update_issue	更新工单内容（需 READ_ONLY_MODE=false）
jira_transition_issue	变更工单状态（需 READ_ONLY_MODE=false）
jira_add_comment	为工单添加评论（需 READ_ONLY_MODE=false）

默认保持 READ_ONLY_MODE=true，仅在需要写入操作时改为 false。

---

常见问题排查

现象	原因	解决方法
MCP server does not exist	服务器未加载	重启 Cursor
Failed to resolve host	网络 / DNS 问题	Windows 上 Docker 不支持 --network host，改用 uvx 方式
uvx: command not found	PATH 未更新	将 C:\Users\<用户名>\.local\bin 加入系统 PATH 后重启
401 Unauthorized	API Token 无效	在 https://id.atlassian.com/manage-profile/security/api-tokens 重新生成

---

参考链接

• mcp-atlassian GitHub
• mcp-atlassian 官方文档
• Atlassian API Token 管理
• JQL 语法参考