- 1. 禅道介绍
- 1.1 关于禅道项目管理软件
- 1.2 如何获得支持
- 1.3 各版本功能差异
- 1.4 关注我们
- 2. 安装禅道
- 2.1. 环境搭建
- 2.1.1 搭建Ubuntu环境安装禅道
- 2.1.2 搭建Centos环境安装禅道
- 2.1.3 安装PHP的ioncube扩展
- 2.2. 安装禅道
- 2.2.1 选择适合您的安装方法
- 2.2.2 新版本禅道的安装升级
- 2.2.3 Windows一键安装包（新版）
- 2.2.4 Windows一键安装包（旧版）
- 2.2.5 linux用一键安装包(推荐)
- 2.2.6 使用源码包安装(各系统通用)
- 2.2.7 使用源码包安装(MAC系统)
- 2.2.8 基于禅道当前的一键安装包（Windows和Linux）如何源码安装旗舰版禅道
- 2.2.9 渠成命令行安装禅道
- 2.2.10 Docker和Kubernetes方式部署禅道
- 2.3 安装PHP的LDAP扩展
- 2.4 在线安装云禅道
- 2.5 安装 APCu扩展
- 2.6 安装DuckDB引擎
- 2.7. 信创支持
- 2.7.1 OceanBase数据库
- 2.8. 安装文档协同服务
- 2.8.1 安装Windows协同服务
- 2.8.2 安装Linux协同服务
- 2.1. 环境搭建
- 3. 升级禅道
- 3.1. 升级禅道新版本
- 3.1.1 选择和自己环境对应的升级方式
- 3.1.2 通过源代码方式升级(通用)
- 3.1.3 windows一键安装包的升级
- 3.1.4 linux一键安装包升级
- 3.1.5 docker安装禅道-升级禅道
- 3.1.6 旧版Docker镜像升级说明
- 3.1.7 通过Roadrunner管理定时任务
- 3.2 如何安装ioncube扩展
- 3.1. 升级禅道新版本
- 4. 维护配置
- 4.1. 维护禅道
- 4.1.1 初始化管理脚本
- 4.1.2 备份禅道
- 4.1.3 恢复删除的资源
- 4.1.4 如何更新燃尽图
- 4.1.5 一键安装包如何实现mysql异机连接
- 4.1.6 linux一键安装包配置https
- 4.1.7 禅道一键安装包迁移/更新禅道一键安装包
- 4.2. 配置禅道
- 4.2.1 设置是否允许匿名访问
- 4.2.2 如何配置email发信
- 4.2.3 如何成为超级管理员
- 4.2.4 配置禅道系统为静态访问
- 4.2.5 去掉禅道访问地址中的zentao
- 4.2.6 linux一键安装包去掉禅道访问地址中的zentao
- 4.2.7 集成禅道和svn
- 4.2.8 集成禅道和git
- 4.2.9 在第三方应用中集成禅道
- 4.2.10 第三方应用配置免密登录禅道
- 4.2.11 第三方应用集成禅道客户端进行消息通知
- 4.2.12 集成webhook
- 4.2.13 集成ZDOO
- 4.2.14 客户端集成
- 4.2.15 浏览器通知的设置
- 4.2.16 集成钉钉工作消息通知
- 4.2.17 集成企业微信应用消息通知
- 4.2.18 集成企业微信群机器人
- 4.2.19 集成飞书群机器人
- 4.2.20 集成飞书消息通知
- 4.2.21 解决一键安装包密码口令弱的问题
- 4.3. 性能优化
- 4.3.1 nginx反向代理禅道502或504bad gateway错误
- 4.3.2 linux系统中配置session使用redis
- 4.3.3 缓存功能
- 4.1. 维护禅道
- 5. 快速入门
- 5.1. 新版本快速入门
- 5.1.1 20版本禅道的新增功能
- 5.1.2 新版本禅道的最简使用
- 5.1.3 20版本禅道的界面变化
- 5.1. 新版本快速入门
- 6. 按照角色使用
- 6.1. 管理员
- 6.2. 项目集负责人
- 6.3. 产品经理
- 6.3.1 维护模块
- 6.3.2 产品多分支/平台管理
- 6.3.3 维护计划
- 6.3.4 维护需求
- 7.4.5 需求的状态和研发阶段
- 6.3.6 创建发布
- 6.3.7 跟踪进度
- 6.3.8 反馈管理（企业版）
- 6.4. 项目经理
- 6.5. 研发人员
- 6.5.1 参加产品计划会议，分解任务
- 6.5.2 领取任务，并每天更新任务
- 6.5.3 创建构建，提交测试
- 6.5.4 确认Bug，解决Bug
- 6.5.5 执行的综合、需求、Bug、任务看板
- 6.6. 测试人员
- 7. 功能介绍
- 7.1. 核心管理结构
- 7.1.1 项目集（Program）
- 7.1.2 项目（Project）
- 7.1.3 产品（Product）
- 7.1.4 执行（Execution）
- 7.1.5 管理模型
- 7.2. 地盘
- 7.3. 项目集
- 7.4. 产品
- 7.4.1 创建产品
- 7.4.2 维护模块
- 7.4.3 产品多分支/平台管理
- 7.4.4 维护计划
- 7.4.5 维护需求
- 7.4.6 需求的评审
- 7.4.7 需求的状态和研发阶段
- 7.4.8 创建发布
- 7.4.9 跟踪进度
- 7.4.10 业务需求&需求多层级
- 7.5. 项目
- 7.6. 执行
- 7.6.1 参加产品计划会议，分解任务
- 7.6.2 领取任务，并每天更新任务
- 7.6.3 创建构建，提交测试
- 7.6.4 确认Bug，解决Bug
- 7.6.5 执行的综合、需求、Bug、任务看板
- 7.7. 测试
- 7.8. 自动化测试
- 7.9 DevOps（解决方案）
- 7.10. 文档
- 7.11. AI
- 7.11.1 AI小程序简介
- 7.11.2 创建与设计AI小程序
- 7.11.3 发布与禁用小程序
- 7.11.4 调试AI小程序
- 7.11.5 前台小程序的应用
- 7.11.6 AI小程序的导入导出
- 7.11.7 管理AI小程序权限
- 7.12. BI
- 7.12.1 维度（企业版8.4+）
- 7.12.2 大屏（企业版8.4+）
- 7.12.3 透视表
- 7.12.4 透视表下钻
- 7.12.5. 大屏设计器
- 7.12.5.1 大屏设计器界面布局
- 7.12.5.2 大屏设计器引用图表
- 7.12.5.3 大屏设计器引用透视表
- 7.12.6 图表
- 7.12.7. 度量项
- 7.12.7.1 查看度量项
- 7.12.8 数据表（企业版8.4+）
- 7.13. 反馈
- 7.14. 看板
- 7.14.1 通用看板功能
- 7.15. 工作流
- 7.16. 学堂
- 7.17. 资产库（旗舰版）
- 7.17.1 资产库管理（旗舰版）
- 7.18. 组织
- 7.18.1 团队成员和工作信息
- 7.18.2 人力资源日历（需安装插件）
- 7.18.3 组织动态
- 7.18.4 公司信息
- 7.19. 办公
- 7.20. 后台设置
- 7.20.1 后台首页
- 7.20.2. 系统设置
- 7.20.3 功能开关
- 7.20.4. 人员管理
- 7.20.5. 模型配置
- 7.20.6. 功能配置
- 7.20.7 文档模板
- 7.20.8. 通知设置
- 7.20.9 插件管理
- 7.20.10 二次开发
- 7.20.11 Jira数据导入
- 7.20.12 Jira数据导入--数据迁移说明
- 7.20.13 Confluence数据导入
- 7.20.14. 权限维护和控制
- 7.20.14.1 项目集的权限维护和访问控制
- 7.20.14.2 产品的权限维护和访问控制
- 7.20.14.3 项目的权限维护和访问控制
- 7.20.14.4 执行的权限维护和访问控制
- 7.20.14.5 项目和执行的访问控制和数据关系
- 7.20.15. AI配置
- 7.20.16. DevOps设置
- 7.20.16.1. 资源
- 7.21. 客户端增强版会议SRS
- 7.21.1. 音视频会议配置
- 7.21.1.1 安装音视频服务端
- 7.21.1.2 安装SRS音视频服务端
- 7.21.1.3 开启和配置音视频功能
- 7.21.2. 发起会议
- 7.21.2.1 一对一会话中发起音视频会议
- 7.21.2.2 群组会话中发起音视频会议
- 7.21.2.3 独立发起音视频会议入口
- 7.21.3. 加入会议
- 7.21.3.1 分享音视频会议到会话
- 7.21.3.2 通过会议的ID加入会议
- 7.21.4. 预约会议
- 7.21.4.1 预约会议
- 7.21.5. 会议应用
- 7.21.5.1 音视频会议应用
- 7.21.1. 音视频会议配置
- 7.22. 客户端增强版会议Jitsi
- 7.1. 核心管理结构
- 8. AI插件
- 8.1 AI插件安装
- 8.2 ZAI服务安装
- 8.3 AI插件功能使用
- 8.4 ZAI服务控制面板使用
- 8.5 禅道MCP部署
- 9. 其他相关
- 9.1. 其他
- 9.1.1 禅道所使用到的第三方代码
- 9.1.2 禅道FAQ
- 9.1.3 如何帮助禅道项目
- 9.1.4 禅道商业服务
- 9.1.5 禅道项目的贡献者
- 9.1.6 历史修改记录
- 9.1.7 禅道对象名称的重名规则
- 9.1. 其他
- 10. IPD版本功能介绍
- 10.1. 禅道IPD版介绍
- 10.1.1 关于禅道IPD版
- 10.1.2 禅道IPD版的核心流程
- 10.2. IPD版的安装和升级
- 10.2.1 选择适合您的安装方法
- 10.2.2 选择适合您的升级方法
- 10.3. 需求与市场管理界面
- 10.4. IPD研发管理界面
- 10.1. 禅道IPD版介绍
禅道MCP部署 分享链接 /book/zentaopms/1790.html?releaseID=21
本篇目录
禅道MCP部署
前置条件
zai服务版本 >= beta1.13
zaiiniter工具版本 >=1.13
关于zaiiniter，是一个初始化zai服务的命令行工具，是一个无依赖的二进制程序。
为当前zai服务添加禅道MCP功能
确保zai服务正在运行。
下载 zaicompose包 链接 http://10.0.0.164:7788/zaicompose/zaicompose.zip ，解压使用zaiiniter命令来向ZAI服务添加禅道MCP Server。
linux:
// 进入zaiiniter所在目录 chmod +x ./zaiiniter ./zaiiniter zentaomcp
成功样例：
插件创建成功，pluginID: 20e45756-7ba6-48fd-a3a8-b2491391504e MCP应用创建成功，appID: jVzjhOgY1i 别名: zmcp 插件已成功挂载到MCP应用 禅道MCP服务地址http://localhost:5000/v1/mcp-server/zmcp
windows
// 进入zaiiniter所在目录 .\zaiiniter.exe zentaomcp
成功样例与linux相同。
图形化界面查看
如果配置成功，访问 zai服务地址 （zai控制台） 就会看到如下配置：
获取ZAI服务x-api-key（ZAI服务第三方应用key）
同样使用zaiiniter程序。
./zaiiniter x-api-key样例输出：
x-api-key: 44c2a681cf744c7487675172c2b6cf92此key请妥善保管。
关于zaiiniter，其Windows版接受的参数与linux版接受的参数以及功能相同，只是名称不同，以及在bash和powershell中命令执行的方式不同(
./zaiiniter与.\zaiiniter.exe)
在MCP Client中使用禅道MCP
Cherry Studio
版本要求
cherry stduio >= 1.39
配置步骤
关于URL和请求头
URL即为zai服务地址+/v1/mcp-server/zmcp。
请求头必填4个字段：
<x-api-key: 在上文通过 ./zaiiniter x-api-key 已获得。>
<x-env-url: 禅道的地址。>
x-env-code及x-env-key按如下方式向禅道管理员申请。
使用样例
上面获得了禅道中的项目集列表。
禅道MCP目前已暴露的功能
getUserInfo(id)
获取给定ID代表的用户详细信息
如何调用？
user: 获取id为1的用户的详细信息。AI: xxxxxx
getPrograms()
获取项目集列表
如何调用？
user: 获取项目集列表。AI: xxxxxx
getProgramInfo(id)
获取给定id代表的项目集详情
如何调用？
user: 获取id为1的项目集信息AI: xxxxxx
getProductInfo(id)
获取给定id代表的产品详情
getProductList(id)
获取产品列表
getProductPlansList(id)
获取给定id代表的产品的产品计划列表
getProductPlansInfo(id)
获取给定id代表的产品的产品计划详情
getReleaseList(id)
获取给定id代表的产品的发布列表
getProjectRelease(id)
获取给定id代表的项目的发布列表
getProductStoryList(id)
获取给定id代表的产品的需求列表
getExecutionStoryList(id)
获取给定id代表的执行的需求列表
getStoryInfo(id)
获取给定id代表的需求的详细信息
如何调用？
user: 获取id为1的需求的详细信息。AI: xxxxxx
getProjectList()
获取项目列表
getprojectInfo(id)
获取给定id代表的项目的详细信息
getProjectBuildList(id)
获取给定id代表的项目的版本列表
getExecutionBuildList(id)
获取给定id代表的执行的版本列表
getBuildInfo(id)
获取给定id代表的版本的详细信息
getProjectExecutionList(id)
获取指定id代表的项目的执行列表
getExecutionInfo(id)
获取指定id代表的执行的详细信息
getExecutionTaskList(id)
获取指定id代表的执行的任务列表
getTaskInfo(id)
获取指定id代表的任务的详细信息
getTaskLog(id)
获取指定id代表的任务的日志
getProductBugList(id)
获取指定id代表的产品的bug列表
getBugInfo(id)
获取给定id代表的BUG的详细信息
如何调用？
user: 获取id为1的需求的详细信息。AI: xxxxxx
getProductTestcaseList(id)
获取指定id代表的产品的测试用例列表
getTestcaseInfo(id)
获取给定id代表的测试用例的详细信息
getTestTaskList()
获取测试单列表
getProjectTestTaskList(id)
获取指定id代表的项目的测试单列表
getTesttaskInfo(id)
获取给定id代表的测试单的详细信息
getFeedbackInfo(id)
获取给定id代表的反馈详情
getFeedbackList()
获取反馈列表
getTicketList()
获取工单列表
getTicketInfo(id)
获取给定id代表的工单详情
名额有限
完善信息领取项目管理礼包
