• 时间:
  • 分类:

作者：延枚

云效 MCP Server 已正式发布。它是一个为研发全生命周期提供统一可编程能力的元控制平面，旨在打通工具间的壁垒，实现研发流程的高度自动化。

目前，MCP Server 已提供超过 150 个原子能力（API），全面覆盖云效的核心模块，包括：

  • 组织管理： 组织列表、部门信息、角色、成员信息等
  • 代码管理： 代码仓库、分支、合并请求、文件树操作等
  • 项目管理： 项目、工作项、字段配置、评论、工时管理等
  • 流水线管理： 流水线、资源、标签、部署等
  • 制品仓库管理： 制品仓库、制品列表等
  • 应用交付： 部署单、应用、应用标签、变量组等
  • 测试管理： 测试用例、用例目录、测试计划、测试结果等

通过将云效 MCP Server 与自定义脚本，或与通义灵码、Cursor、iFlow-Cli 等本地/云端大模型工具结合，研发团队可以赋予程序直接“操作云效”的能力，从而高效完成各类重复性工作。

例如，在项目协作场景中，你可以实现：

  • 智能查询： 快速获取指定项目、迭代或成员名下的需求列表。
  • 自动编排： 将复杂需求自动拆解为子任务，并生成验收标准。
  • 批量处理： 一次性更新多个工作项的状态、负责人或标签。
  • 数据同步： 读取 Excel 或其他系统的数据，批量在云效中创建工作项。

为了帮助大家快速上手，我们推出了 【玩转云效 MCP】 系列专题文章。

本篇作为系列的第一篇，将聚焦于项目管理与协作场景，提供一系列“即刻可用”的 Prompt 示例与实战演练，手把手教你如何利用 MCP 实现项目管理的自动化。

前期环境准备

  1. 在本地准备好你的 AI 工具：
  1. 按照云效 MCP Server 的说明完成配置（包含 Token、组织信息等）。

配置完成后，你的 AI 工具就可以通过 MCP 协议直接调用云效的项目 / 工作项等接口。

检查 MCP Server 配置是否生效

完成配置后，可以先用两条最简单的 Prompt 做“自检”。本文中演示示例的 AI 工具为 Qoder。

1. 查看当前组织信息

查看云效当前的组织信息

预期：AI 会调用 YUNXIAO/GET_CURRENT_ORGANIZATION_INFO，并返回：

  • 组织 ID（lastOrganization）
  • 用户 ID
  • 用户名

这些信息后续会被用来继续检索项目、工作项等。

2. 查看当前用户信息

查看云效当前的用户信息

预期：AI 会调用 YUNXIAO/GET_CURRENT_USER，并返回用户名、邮箱、组织 ID 等相关信息。

只要上述两个调用能正常返回结果，基本可以认为 MCP Server 配置是正确的。

实用场景 1：检索+统计/批量处理

云效 MCP 提供了非常丰富的检索能力：

  • 项目级： 按项目名称、状态、创建时间等检索项目
  • 工作项级： 按标题、描述、状态、优先级、负责人、标签等检索工作项

你可以先让 AI 告诉你“有哪些可用条件”，再组合场景：

云效中检索项目都有哪些条件可使用？
云效中对于检索工作项都提供了哪些条件？

image

拿到条件后，就可以开始“场景编排”了。

1. 按创建人检索工作项

查看 云效正式自动化 组织中 bowentestmcp 项目 我自己创建的工作项

image

AI 一般会自动完成：

  1. 查询你所属组织列表
  2. 切换到“云效正式自动化”组织
  3. 查询该组织下名为 bowentestmcp 的项目
  4. 在该项目下检索“我创建的工作项”

2. 基于结果做统计 / 批量修改

拿到工作项列表后，可以继续下发指令：

把这两个工作项的状态改为已完成

AI 会：

  1. 查询该项目的工作流信息，确认“已完成”状态的 ID（比如：100014）
  2. 使用 YUNXIAO/UPDATE_WORK_ITEM 批量更新状态
  3. 再次检索校验修改是否成功

image

3. 更多检索 + 批量处理示例 Prompt

以下 Prompt 都是可以直接用的“套路”：

  • 按标签批量打标
某某项目下近一周我创建的需求，请统一加上「一期」标签
  • 按迭代统计
统计一下某某项目下，迭代名为「xx」的需求数以及完成情况分析
  • 按状态批量流转
请帮我找出 bowentestmcp 项目中所有状态为「已完成」的需求，然后统一将它们的状态改为「已关闭」
  • 按标题关键词 + 批量调优先级
查询 xx 项目中所有标题包含「登录」或「注册」的需求，将它们的优先级统一调整为「高」
  • 按创建人 + 批量改负责人
找出我创建的所有待处理状态的任务，把它们全部指派给张三（工号：xxx）

实用场景 2：拆分需求

大模型 + MCP 非常适合做“把一个大需求拆成很多小需求并直接录入云效”这类工作。

1. 按功能点拆分父需求

示例：已有父需求 QAAB-3，描述里包含一段“功能列表”：

  • 支持加法运算
  • 支持减法运算
  • 支持乘法运算
  • 支持除法运算

你只需要一句：

QAAB-3 这个工作项，请按照里面的功能点描述建立相应的子需求

AI 会：

  1. 查询 QAAB-3 的详细描述
  2. 自动解析描述中的有序列表（1/2/3/4）
  3. 通过 YUNXIAO/CREATE_WORK_ITEM 依次创建 4 个子需求
  4. 每个子需求继承父需求的类型、负责人等

最终在云效需求列表页就能看到新创建的需求：

image

2. 更多拆分需求的示例 Prompt

  • 按实现层拆分
找到「实现用户登录功能」这个需求，将它拆分成：前端 UI、后端接口、数据库设计三个子任务
  • 按列表自动拆分
查看 QAAB-8 的需求描述，自动识别其中的功能点列表（如 1. 2. 3.），为每个功能点创建一个独立的子需求
  • 按开发阶段拆分
将「实现用户注册机制」这个需求拆分为：
- 需求分析
- 技术方案设计
- 前端开发
- 后端开发
- 联调测试
- 上线部署每个阶段创建一个子任务
  • 按 INVEST 原则拆分大需求
QAAB-5 这个需求过大，请按照 INVEST 原则将它拆分成：
- 独立的（Independent）
- 可协商的（Negotiable）
- 有价值的（Valuable）
- 可估算的（Estimable）
- 小的（Small）
- 可测试的（Testable）
多个小需求

实用场景 3：优化需求内容

很多需求最初往往只是“半句话”，比如：

支持乘法运算：实现计算器的乘法运算功能，输入两个数，输出两数之积。

image

这类需求很难直接用于评审 / 开发 / 测试。借助 MCP，你可以让 AI：

  • 补全为用户故事形式
  • 写出业务流程与影响分析
  • 给出可测试的验收条件
  • 关键是：写回云效原工作项中

1. 完整优化一个需求示例（QAAB-5）

QAAB-5 这个需求，请进行业务分析优化：
要求：
1. 改为用户故事的结构
2. 分析业务流程和影响
3. 提供验收条件

image

image

AI 典型的处理步骤：

  1. 读取 QAAB-5 的原始描述（“实现计算器的乘法运算功能...”）

  2. 生成：

    • 用户故事（作为谁 / 我希望 / 以便）
    • 业务流程（打开计算器 → 输入数字 → 选择乘号 → 输入第二个数 → 点击等号 → 展示结果）
    • 业务影响（对前端 / 后端 / 错误处理 / 测试等的影响）
    • 验收条件（覆盖正数、负数、小数、0、边界值、非法输入、性能等场景）
  3. 使用 YUNXIAO/UPDATE_WORK_ITEM 将上述内容整体写回 QAAB-5 的描述字段

优化完成后，在云效中查看 QAAB-5，就会看到一个完整、可评审、可测试的需求说明。

2. 更多需求优化的示例 Prompt

  • 改写为用户故事格式
查看「实现用户登录功能」这个需求，将它改写为用户故事格式：
- 作为【谁】
- 我希望【做什么】
- 以便【达成什么价值】
并直接更新回工作项
  • 批量用户故事化技术需求
找出所有技术描述类的需求（标题以「实现」开头），将它们统一改写为用户故事格式，突出用户角色和业务价值
  • 补充验收条件
QAAB-8 缺少验收标准，请根据需求描述补充至少 5 条可量化的验收条件，
包括：
- 功能性验收
- 性能要求
- 边界条件
- 异常处理
并更新回原需求
  • 补充测试场景
查看「支持乘法运算」需求，补充完整的测试场景：
- 正常场景（正数、负数、小数）
- 边界场景（0、极大值、极小值）
- 异常场景（非法输入、溢出）
更新回原需求的验收条件部分
  • 批量为无验收条件的需求补充标准
找出所有没有验收条件的需求（描述中不包含「验收」关键词），
为每个需求根据其标题和描述自动生成 3-5 条验收标准，并写回工作项

实用场景 4：批量导入需求

当你已经有一份 Excel / CSV 需求列表时，可以直接让 AI + MCP 帮你“批量录入到云效”。

1. 从 Excel 表格导入示例

假设有一个 Excel：

image

只需要一句 Prompt：

请将「需求列表.xlsx」中的内容录入到云效 bowentestmcp 这个项目中

image

AI 的典型处理流程：

  1. 解析 Excel 结构（首行是表头：标题 / 内容 / 优先级）

  2. 将每一行映射为：

    • subject → 标题
    • description → 内容
    • priority → 优先级（高 / 中 / 低）
  3. 调用 YUNXIAO/CREATE_WORK_ITEM 创建 4 条新需求

回到云效 bowentestmcp 项目的需求列表页，就能看到刚刚导入的 4 条需求。

image

2. 更多批量导入的示例 Prompt

  • 从“产品需求.xlsx”导入
从「产品需求.xlsx」导入需求，全部创建为「产品类需求」类型，指派人统一设置为我本人
  • 指定字段映射导入
导入「backlog.xlsx」到 bowentestmcp 项目：
- 第 1 列（需求名称） → 标题
- 第 2 列（详细说明） → 描述
- 第 3 列（重要程度） → 优先级（高/中/低）
- 第 4 列（负责人姓名） → 指派人
- 第 5 列（所属模块） → 标签
  • 带层级关系导入
导入「需求层级.xlsx」，根据「父需求ID」列建立父子关系：
- 第一级：Epic / 主题需求
- 第二级：Feature / 功能需求
- 第三级：Story / 用户故事
自动建立层级关联
  • 自动识别表头并导入
分析「需求文档.xlsx」的表头结构，自动识别对应的字段映射关系，将数据导入 bowentestmcp 项目
  • 导入前先做数据校验
导入「需求池.csv」前先验证：
- 必填字段不能为空（标题、描述）
- 优先级只能是「高/中/低」
- 负责人必须是项目成员
- 标题长度不超过 50 字
验证通过后再批量创建

更多项目管理场景示例

在前面几个场景基础上，还可以进一步组合出更复杂的“项目级”能力。

1. 项目健康度检查

分析 bowentestmcp 项目健康状况：
- 统计各状态需求分布
- 检查逾期未完成的需求
- 识别长期无人认领的需求
- 分析需求平均完成周期
- 检测可能的瓶颈（某状态停留过久）
生成健康度报告

AI 可以基于 SEARCH_WORKITEMS 等接口，做出一份结构化的项目健康度分析报告。

2. 迭代规划

为即将开始的 Sprint 5 规划任务：
1. 从需求池中筛选高优先级需求
2. 智能推荐适合本迭代的需求组合
3. 自动分配给合适的成员
4. 创建迭代并关联需求

3. 迭代回顾

为刚结束的 Sprint 3 生成回顾报告：
- 完成需求数 vs 计划需求数
- 各成员完成情况统计
- 延期需求分析
- 紧急插入需求统计
- 提取改进建议

4. 工作负载分析

分析 bowentestmcp 项目团队成员工作负载：
- 统计每人当前进行中的任务数
- 计算每人的工作时长总和
- 识别负载过重或过轻的成员
- 建议任务重新分配方案

5. 需求质量评估

批量检查 xx 项目中所有「待开发」状态的需求质量：
- 描述完整性（是否包含背景、目标、验收标准）
- 验收条件清晰度（是否可测试）
- 依赖关系完整性
- 工作量评估准确性
不合格的标记为「待补充」并通知负责人

6. Bug 关联需求分析

分析 xx 项目中 Bug 与需求的关联：
- 统计每个需求关联的 Bug 数量
- 识别高缺陷率的需求
- 分析 Bug 产生的阶段（开发/测试/生产）
- 提供质量改进建议

小结

通过本文的实战演练，我们看到：当云效 MCP Server 与自动化脚本或智能体结合，它不再仅仅是一组 API，而是一种全新的研发协作范式。它将“会用云效”的人，从大量机械操作中解放出来。总结来说，MCP 为项目管理者带来了三大核心价值的转变：

  • 执行指令化： 将原本需要数十分钟的手动点击，压缩为几行指令或一句自然语言描述。
  • 经验模板化： 将个人的最佳实践与团队规范，沉淀为可复用、可共享的自动化模板。
  • 精力聚焦化： 将管理者从繁琐的工具操作中解放，回归到思考产品、业务和团队等更高价值的工作上。

云效 MCP Server 就像一套高效的“项目协作外骨骼”——它增强你的能力，放大你的效能，让你跑得更快、更远。而这，仅仅是开始。项目管理是 MCP 能力版图的第一块拼图。

在下一篇文章中，我们将深入 【代码管理】 场景，探索如何通过 MCP 实现分支自动创建、权限精细化管理、代码合规性检查等高阶玩法。

敬请期待！也欢迎你在评论区分享使用心得，或告诉我们你最希望 MCP 在哪个领域帮你实现自动化。

标签: none

添加新评论