用途:在 AI 编码工作流中直接检索、分析、更新 Jira 工单,适用于获取工单理解需求、提取可测试验收标准、添加进度评论、流转状态(To Do → In Progress → Done)、关联合并请求或分支、按 JQL 搜索问题。
主要能力:配置 mcp-atlassian MCP 服务器后可使用 jira_search、jira_get_issue、jira_create_issue、jira_update_issue、jira_transition_issue、jira_add_comment、jira_get_sprint_issues、jira_create_issue_link、jira_get_issue_development_info 等工具;也可用 Jira REST API v3 通过 curl 直接获取工单、评论、添加评论、流转状态和 JQL 搜索。分析工单时可提取功能需求、验收标准、可测试行为、用户角色、数据需求、集成点,并识别单元/集成/E2E/API 测试类型及边界与错误场景。
使用方式:MCP 方式需 Python 3.10+ 与 uvx,在 MCP 配置中加入 jira 服务,命令为 uvx,参数为 mcp-atlassian==0.21.0,并设置 JIRA_URL、JIRA_EMAIL、JIRA_API_TOKEN。REST 方式需在环境变量中设置上述三项,使用 curl 调用 /rest/api/3/issue、/comment、/transitions、/search 等端点。流转前应先调用 jira_get_transitions 获取当前工作流的转换 ID。
限制与安全:切勿硬编码密钥,应使用环境变量或密钥管理器,并将 .env 加入 .gitignore;令牌泄露需立即轮换,使用最小权限令牌。常见错误包括 401(令牌无效或过期)、403(权限不足)、404(工单键或 URL 错误)、uvx ENOENT(PATH 问题)和连接超时(网络/VPN)。验收标准模糊时应先澄清再编码。具体收费、价格与平台支持范围暂未提供。