测试开发效率神器:AI 驱动禅道MCP,AI 助手直接接入禅道——查 Bug、提 Bug、管项目,全部自然语言完成,告别频繁切换浏览器

fed-zentao-mcp 产品介绍与推广文档

让 AI 助手直接接入禅道——查 Bug、提 Bug、管项目，全部自然语言完成，告别频繁切换浏览器。

一、这是什么？

fed-zentao-mcp 是一个 MCP（Model Context Protocol）服务端，它充当 AI 编程助手（Claude、Codex、Cursor 等）与禅道项目管理系统的双向桥梁。

传统工作流

写代码 → 发现Bug → 切到浏览器 → 登录禅道 → 新建Bug → 截图/粘贴 → 切回IDE

有了 fed-zentao-mcp

写代码 → 对AI说"帮我提个Bug" → AI自动创建禅道Bug → 继续写代码

每次 Bug 操作从 30 秒缩短到 3 秒，一天省下几十次上下文切换。

二、功能全景

🔐 智能登录

自动适配禅道 API v1 / v2，失败自动降级重试，无需手动配置版本。凭证通过 macOS Keychain 安全存储，不落盘、不硬编码。

👤 我的工作台

一句话	效果
"我还有几个待处理的 Bug？"	返回指派给自己的未关闭 Bug 数量
"把我待处理的 Bug 列出来"	列出所有指派给自己的 Bug 详情，按时间倒序

📂 产品/项目浏览

一句话	效果
"有哪些产品？"	查看所有可见产品列表
"列一下项目"	查看所有项目，可按状态筛选
"看看产品集分布"	查看产品集层级结构，自动聚合各产品未解决 Bug 数
"XX 产品集还有多少 Bug？"	按产品集查看所有未关闭 Bug

🐛 Bug 全生命周期管理

一句话	效果
"查一下 Bug #1234"	获取 Bug 全部字段详情
"在 XX 项目提个 Bug，标题是xxx"	自动创建 Bug，填入产品、版本、严重程度、优先级
"把 Bug #1234 的严重程度改成 1"	更新 Bug 任意字段
"给 Bug #1234 加条评论：已复现"	添加评论，内容在禅道 Web 端可见

🔨 构建管理

一句话	效果
"XX 项目有哪些构建版本？"	列出项目的所有构建记录，含日期、构建人

📡 通用 API 通道

一句话	效果
任何未被封装的操作	通过通用 REST 工具直接调用禅道原始 API，零扩展成本

三、为什么需要它？

痛点一：频繁的上下文切换

开发/测试过程中，每一次 Bug 操作都是一次环境切换：

IDE → 浏览器 → 登录禅道 → 导航到对应页面 → 操作 → 返回 IDE
一次切换 20-30 秒，一天 30 次 = 10-15 分钟纯浪费
更严重的是：注意力被打断——回到 IDE 后需要重新进入心流状态

痛点二：信息孤岛

禅道里的 Bug 数据是"死"的——它不会主动出现在你的开发环境中：

你不知道今天有多少 Bug 指派给了你，除非主动去刷
你不知道哪些 Bug 跟当前代码模块相关
Code Review 时看不到 Bug 上下文

痛点三：重复劳动

很多 Bug 操作是机械的：

反复填产品、版本、严重程度
批量修改 Bug 状态
批量添加评论

这些完全可以用一句话让 AI 代劳。

四、适用场景

🧑‍💻 开发者

"开发中发现问题 → 对 AI 说：在 XX 产品提一个标题为 xxx 的 Bug，步骤是 xxx"
从切浏览器、手工填表单，变成一句话完成。

🧪 测试工程师

"把我指派的所有 Bug 列出来" → 逐条查看 → "给 Bug #1234 加评论：已复现，附日志"
巡检效率翻倍，Bug 回复实时化，不用在浏览器里逐个点开。

📋 Tech Lead / 项目经理

"XX 产品集还有多少个未解决的 Bug？" → "各产品的 Bug 分布是什么？"
实时数据，不用等日报、不用手动统计，随时掌握质量大盘。

🤖 CI/CD 自动化

测试流水线失败 → 自动在禅道创建 Bug，填入失败用例、日志链接
人工介入归零，缺陷从产生到入库零延迟。

五、技术亮点

双版本 API 全兼容

自动探测禅道 API v1 / v2，无需手动配置，兼容不同版本的禅道部署。

企业级安全设计

凭证存储于 macOS Keychain，不落盘、不硬编码
支持环境变量注入，适配 CI/CD 场景
内置 TLS 不安全证书绕过开关，专治内网自签名证书

智能容错

401 过期自动重登录 + 重试，零人工干预
Session Cookie 全自动管理
大量数据自动翻页拉取，无惧上万条记录

评论 Bug 不走寻常路

禅道官方 API 的 PUT /bugs/:id 不会持久化可见评论。本工具模拟真实浏览器表单提交，确保每一条评论都能在禅道 Web 页面中正确显示，不掉评论。

极简架构

一个 server.mjs + 两个 npm 依赖
看懂就能改，出了问题能排查
不侵入禅道系统，不装插件，不改一行配置

六、成本与收益

投入

项目	说明
安装配置	5 分钟
学习成本	0——直接用自然语言对话
禅道改造	无——不装插件、不改配置、不开放额外端口
运维成本	接近于零

收益

维度	改善
Bug 操作效率	每次 30 秒 → 3 秒
浏览器切屏次数	减少 80% 以上
注意力保持	不再因频繁切换打断心流
团队 Bug 响应速度	从"有空再去看"到"实时可查"
新成员上手成本	5 分钟配置即用

七、与禅道 Web 页面对比

维度	fed-zentao-mcp	禅道 Web 页面
操作方式	自然语言一句话	手动导航 + 填表单
上下文切换	不需要离开 IDE	每次操作需切浏览器
批量操作	一句话批量处理	逐个操作
数据实时性	实时 API 查询	实时
功能覆盖	90% 高频操作	100% 全部功能
学习成本	无需学习	需要熟悉 UI 布局
部署复杂度	5 分钟	已部署

fed-zentao-mcp 不替代禅道 Web 页面，而是覆盖 90% 高频操作场景，让 AI 助手处理日常例行操作，复杂配置和报表还回到 Web 端。

八、竞品对比

特性	fed-zentao-mcp	其他 MCP 方案	禅道 API 手动封装
自然语言操作	✅ 原生支持	❌ 需要额外 Prompt 工程	❌
Bug CRUD 全功能	✅ 全部覆盖	部分	需自建
评论持久化	✅ 表单级提交	❌ API 级评论不可见	需搞定 CSRF
智能登录容错	✅ 自动检测版本 + 重试	❌	需自建逻辑
安全凭证管理	✅ Keychain / 环境变量	部分明文存储	❌ 自行管理
零禅道改造	✅ 不改一行	✅	✅
源码可控	✅ 全量交付	❌ 黑盒	✅

九、部门推广建议

宣讲要点

不增加负担，只减少负担——不用学新工具，不用改现有流程，5 分钟配置，用完即走
效率可量化——每次 Bug 操作从半分钟变 3 秒，一天省 10-15 分钟纯时间 + 无限注意力损耗
全员受益——开发、测试、管理都能用，不是某个角色的专属工具
零侵入——不改禅道、不装插件、不开放额外端口，安全团队零顾虑

推介理由（一句话版）

角色	一句话
开发者	"再也不用为了提个 Bug 切浏览器了"
测试	"一句话查 Bug、建 Bug、回评论，效率翻倍"
技术经理	"所有产品集的 Bug 大盘，一句话就能看"
部门负责人	"不花一分钱基础设施投入，让团队效率肉眼可见提升"

落地路径

第1周： ⚡ 自己在 5 分钟内配好，体验"一句话建 Bug"第2周： 👥 给团队 2-3 人演示，收集反馈第3周： 📢 做一次 10 分钟内部分享，发安装文档第4周： ✅ 全团队 rollout，纳入日常工具链

十、快速配置指南

前提

有禅道账号
安装了 Node.js（≥18）

安装（5 分钟）

# 1. 进入项目目录安装依赖cd fed-zentao-mcpnpm install# 2. 将禅道账号密码存入本地 Keychainsecurity add-generic-password -a codex -s fed-zentao-account -w '你的禅道账号' -Usecurity add-generic-password -a codex -s fed-zentao-password -w '你的禅道密码' -U# 3. 在 AI 编程工具中注册 MCP 服务# 以 Codex 为例，在 ~/.codex/config.toml 中添加：## [mcp_servers."fed-zentao-mcp"]# command = "/你的路径/fed-zentao-mcp/start.sh"# enabled = true# 4. 重启 → 开箱即用

验证是否生效

对 AI 说一句话：

"我还有几个待处理的禅道 Bug？"

如果能正常返回，就说明安装成功。