jira-integration

原文涵盖的主题

• Jira 集成技能
• 何时激活
• 前提条件
• 选项 A：MCP 服务器（推荐）
• 选项 B：直接 REST API
• MCP 工具参考
• 直接 REST API 参考
• 获取工单

直接从 AI 编码工作流中检索、分析和更新 Jira 工单。支持 基于 MCP（推荐）和 直接 REST API 两种方式。 获取 Jira 工单以理解需求 从工单中提取可测试的验收标准 向 Jira 问题添加进度评论 转换工单状态（待办 → 进行中 → 完成） 将合并请求或分支链接到 Jira 问题 通过 JQL 查询搜索问题 安装 mcp-atlassian MCP 服务器。这将向您的 AI 代理直接暴露 Jira 工具。 要求： Python 3.10+ uvx（来自 uv），通过您的包管理器或官方 uv 安装文档进行安装 添加到您的 MCP 配置（例如，/.claude.json → mcpServers）： 安全： 切勿在源代码中硬编码密钥。建议在系统环境（或密钥管理器）中设置 JIRAURL、JIRAEMAIL 和 JIRAAPITOKEN。仅对本地未提交的配置文件使用 MCP env 块。 获取 Jira API 令牌： 1. 访问 2. 点击 创建 API 令牌 3. 复制令牌 — 将其存储在您的环境中，切勿存储在源代码中 如果 MCP 不可用，可通过 curl 或辅助脚本直接使用 Jira REST API v3。 所需的环境变量： | 变量 | 描述 | |----------|-------------| | JIRAURL | 您的 Jira 实例 URL（例如，https://yourorg.atlassian.net） | | JIRAEMAIL | 您的 Atlassian 账户邮箱 | | JIRAAPITOKEN | 来自 id.atlassian.com 的 API 令牌 | 将这些存储在您的 shell 环境、密钥管理器或未跟踪的本地环境文件中。不要将其提交到仓库。 对于直接 curl 示例，请通过标准输入传递 Jira 用户配置，避免凭据出现在命令行参数中。 当配置了 mcp-atlassian MCP 服务器时，以下工具可用： | 工具 | 用途 | 示例 | |------|---------|---------| | jirasearch | JQL 查询 | project = PROJ AND status = "In Progress" | | jiragetissue | 按键获取完整问题详情 | PROJ-1234 | | jiracreateissue | 创建问题（任务、缺陷、故事、史诗） | 新建缺陷报告 | | jiraupdateissue | 更新字段（摘要、描述、经办人） | 更改经办人 | | jiratransitionissue | 更改状态 | 移至“评审中” | | jiraaddcomment | 添加评论 | 进度更新 | | jiragetsprintissues | 列出

这里只展示节选，请以完整原文和当前要求为准。