jira-mcp-integration

🚀 JIRA MCP 集成

一个用于将 JIRA 与克劳德集成的 模型上下文协议 服务器。此工具允许克劳德直接在您的对话中创建 JIRA 工单，极大地提升了工作流程的效率。

✨ 主要特性

创建工单

可创建新的 JIRA 工单。

参数： | 参数 | 详情 | |------|------| | summary | 工单的标题或摘要（必填） | | issue_type | 工单类型 (Bug, Task, 或 Story，默认为 Task) | | description | 工单的详细描述（可选） | | acceptance_criteria | 工单的验收标准（可选，存储在自定义字段 10429 中） | | story_points | 工单的故事点数（可选，斐波那契序列：1, 2, 3, 5, 8, 13 等） | | create_test_ticket | 覆盖默认设置以决定是否自动创建关联测试工单（可选，布尔值） | | parent_epic | 关联的父史诗故事的关键字（可选，例如 "PROJ-123"） |

当创建一个带有故事点数的故事类型工单时：

• 自动为故事添加 "QA-Testable" 标签。
• 如果启用了 AUTO_CREATE_TEST_TICKETS，自动创建一个关联的测试工单。
• 测试工单使用故事的标题作为其描述。
• 测试工单与故事之间建立 "Test Case Linking" 关联关系。

获取工单

可检索现有 JIRA 工单的详细信息。

参数：

• ticket_id：要读取的 JIRA 工单 ID（必填）

搜索工单

可通过问题类型搜索 JIRA 工单。

参数： | 参数 | 详情 | |------|------| | issue_type | 要搜索的问题类型 (Bug, Task, Story, 或 Test)（必填） | | max_results | 返回结果的最大数量（可选，默认为 10，最大值为 50） | | additional_criteria | 搜索中包含的额外 JQL 标准（可选） |

此工具允许您查找特定类型的所有工单（例如，所有 Bug 类型的工单）在您的 JIRA 项目中。您可以通过提供额外的 JQL 标准进一步细化搜索。

链接工单

可将两个 JIRA 工单关联在一起。

参数： | 参数 | 详情 | |------|------| | outward_issue | 外部问题的关键字（必填） | | inward_issue | 内部问题的关键字（必填） | | link_type | 要创建的链接类型（可选，默认为 "Test Case Linking"） |

💻 使用示例

基础用法

配置正确后，您可以直接要求克劳德创建 JIRA 工单：

请创建一个跟踪我们讨论过的数据库性能问题的 JIRA 工单。

高级用法

您还可以指定工单的验收标准：

为实现新用户身份验证功能创建一个 JIRA 工单，并包含以下验收标准：
- 用户可以使用电子邮件和密码登录
- 密码重置功能通过电子邮件正常工作
- 5 次失败尝试后账户被锁定
- 支持与 Google 和 Facebook 的 OAuth 集成

克劳德将使用创建工单工具在您的 JIRA 项目中生成一个包含所有指定详细信息的工单。

📦 安装指南

获取 JIRA API Token

1. 登录到您的 Atlassian 账户：https://id.atlassian.com/manage-profile/security
2. 进入 Security > API tokens
3. 点击 "Create API token"
4. 为令牌提供一个名称（例如，"Claude Integration"）
5. 点击 "Create"
6. 复制令牌（您将无法再次查看）

📚 详细文档

故障排除

遇到问题时：

1. 检查您的 JIRA 凭据是否正确。
2. 验证项目中 index.js 文件的路径在 claude_desktop_config.json 中是否正确。
3. 确保克劳德有权使用工具。
4. 检查克劳德控制台中的任何与 JIRA MCP 服务器相关的错误消息。