---

name: jira-automation description: "通过 Rube MCP (Composio) 自动化 Jira 任务：问题、项目、冲刺、看板、评论、用户。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 自动化 Jira

通过 Composio 的 Jira 工具包经由 Rube MCP 自动化 Jira 操作。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 jira 建立活跃的 Jira 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 响应正常以验证 Rube MCP 可用
2. 使用工具包 jira 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，按照返回的认证链接完成 Jira OAuth
4. 确认连接状态显示 ACTIVE 后再运行任何工作流

核心工作流

1. 搜索和过滤问题

使用场景：用户想要使用 JQL 查找问题或浏览项目问题

工具序列：

1. JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST - 使用 JQL 查询搜索 [必需]
2. JIRA_GET_ISSUE - 获取特定问题的完整详情 [可选]

关键参数：

• jql：JQL 查询字符串（如 project = PROJ AND status = "In Progress"）
• maxResults：每页最大结果数（默认 50，最大 100）
• startAt：分页偏移量
• fields：要返回的字段名称数组
• issueIdOrKey：问题键如 'PROJ-123'（用于 GET_ISSUE）

注意事项：

• JQL 字段名称区分大小写，必须匹配 Jira 配置
• 自定义字段使用 ID 如 customfield_10001，而非显示名称
• 结果是分页的；检查 total vs startAt + maxResults 以继续

2. 创建和编辑问题

使用场景：用户想要创建新问题或更新现有问题

工具序列：

1. JIRA_GET_ALL_PROJECTS - 列出项目以找到项目键 [前置]
2. JIRA_GET_FIELDS - 获取可用字段及其 ID [前置]
3. JIRA_CREATE_ISSUE - 创建新问题 [必需]
4. JIRA_EDIT_ISSUE - 更新现有问题的字段 [可选]
5. JIRA_ASSIGN_ISSUE - 将问题分配给用户 [可选]

关键参数：

• project：项目键（如 'PROJ'）
• issuetype：问题类型名称（如 'Bug'、'Story'、'Task'）
• summary：问题标题
• description：问题描述（Atlassian 文档格式或纯文本）
• issueIdOrKey：编辑时的问题键

注意事项：

• 问题类型和必填字段因项目而异；使用 GET_FIELDS 检查
• 自定义字段需要精确的字段 ID，而非显示名称
• 描述可能需要 Atlassian 文档格式 (ADF) 以支持富文本

3. 管理冲刺和看板

使用场景：用户想要使用敏捷看板、冲刺和待办事项

工具序列：

1. JIRA_LIST_BOARDS - 列出所有看板 [前置]
2. JIRA_LIST_SPRINTS - 列出看板的冲刺 [必需]
3. JIRA_MOVE_ISSUE_TO_SPRINT - 将问题移到冲刺 [可选]
4. JIRA_CREATE_SPRINT - 创建新冲刺 [可选]

关键参数：

• boardId：来自 LIST_BOARDS 的看板 ID
• sprintId：移动操作的冲刺 ID
• name：创建时的冲刺名称
• startDate/endDate：ISO 格式的冲刺日期

注意事项：

• 看板和冲刺特定于 Jira Software（非 Jira Core）
• 每个看板同一时间只能有一个活跃冲刺

4. 管理评论

使用场景：用户想要在问题上添加或查看评论

工具序列：

1. JIRA_LIST_ISSUE_COMMENTS - 列出现有评论 [可选]
2. JIRA_ADD_COMMENT - 向问题添加评论 [必需]

关键参数：

• issueIdOrKey：问题键如 'PROJ-123'
• body：评论正文（支持 ADF 富文本格式）

注意事项：

• 评论支持 ADF（Atlassian 文档格式）进行格式化
• 提及使用账户 ID，而非用户名

5. 管理项目和用户

使用场景：用户想要列出项目、查找用户或管理项目角色

工具序列：

1. JIRA_GET_ALL_PROJECTS - 列出所有项目 [可选]
2. JIRA_GET_PROJECT - 获取项目详情 [可选]
3. JIRA_FIND_USERS / JIRA_GET_ALL_USERS - 搜索用户 [可选]
4. JIRA_GET_PROJECT_ROLES - 列出项目角色 [可选]
5. JIRA_ADD_USERS_TO_PROJECT_ROLE - 将用户添加到角色 [可选]

关键参数：

• projectIdOrKey：项目键
• query：FIND_USERS 的搜索文本
• roleId：角色操作的角色 ID

注意事项：

• 用户操作使用账户 ID（非邮箱或显示名称）
• 项目角色与全局权限不同

常见模式

JQL 语法

常用运算符：

• project = "PROJ" - 按项目过滤
• status = "In Progress" - 按状态过滤
• assignee = currentUser() - 当前用户的问题
• created >= -7d - 最近 7 天创建的
• labels = "bug" - 按标签过滤
• priority = High - 按优先级过滤
• ORDER BY created DESC - 按创建时间降序排列

问题类型层级

Epic（史诗）
├── Story（用户故事）
├── Task（任务）
│   └── Sub-task（子任务）
└── Bug（缺陷）
    └── Sub-task（子任务）

工作流状态

To Do → In Progress → In Review → Done
（待办）  （进行中）    （审查中）  （完成）