LEI DEV

ZenTao MCP
Capability Library

基于禅道 RESTful API v2.0 的能力库设计清单 —— 涵盖全部 121 个接口,按模块整理,含请求参数字段。可直接用于 MCP Server 的 Tool / Resource 设计。

121
接口总数
20
业务模块
43 · 20
39 · 18
GET·POST·PUT·DELETE

Bug

核心 — Bug 全生命周期
POST 增/bugs创建Bug
请求参数▾ 展开
字段类型必填说明
productIDint必填所属产品
titlestring必填Bug标题
openedBuildarray必填影响版本,主干是trunk,其他版本使用版本ID
projectint选填所属项目
executionint选填所属执行
severityint选填严重程度,默认是3
priint选填优先级,默认是3
typestring选填Bug类型(codeerror 代码错误 \
stepsstring选填重现步骤
storyint选填相关需求
PUT 改/bugs/:bugID修改Bug
请求参数▾ 展开
字段类型必填说明
titlestring选填Bug标题
severityint选填严重程度,默认是3
priint选填优先级,默认是3
typestring选填Bug类型(codeerror 代码错误 \
openedBuildarray选填影响版本,主干是trunk,其他版本使用版本ID
stepsstring选填重现步骤
projectint选填所属项目
executionint选填所属执行
storyint选填相关需求
GET 读/products/:productID/bugs获取产品Bug列表
请求参数▾ 展开
字段类型必填说明
browseType选填unclosed 未关闭 \
orderBy选填title_asc 标题 \
GET 读/projects/:projectID/bugs获取项目Bug列表
请求参数▾ 展开
字段类型必填说明
browseType选填unresolved 未关闭)
orderBy选填title_asc 标题 \
GET 读/executions/:executionID/bugs获取执行Bug列表
请求参数▾ 展开
字段类型必填说明
browseType选填unresolved 未关闭)
orderBy选填title_asc 标题 \
GET 读/bugs/:bugID获取Bug详情
PUT 改/bugs/:bugID/resolve解决Bug
请求参数▾ 展开
字段类型必填说明
resolutionstring必填fixed 已解决 \
resolvedDatestring选填解决日期,默认今天
resolvedBuildstring选填解决版本, trunk为主干
assignedTostring选填指派给
commentstring选填备注
PUT 改/bugs/:bugID/close关闭Bug
请求参数▾ 展开
字段类型必填说明
commentstring选填备注
PUT 改/bugs/:bugID/activate激活Bug
请求参数▾ 展开
字段类型必填说明
openedBuildarray选填影响版本, trunk为主干
assignedTostring选填指派给
commentstring选填备注
DELETE 删/bugs/:bugID删除Bug

需求

核心 — 需求 stories
POST 增/stories创建需求
请求参数▾ 展开
字段类型必填说明
productIDint必填产品ID
titlestring必填
priint选填优先级,默认是3
moduleint选填所属模块
parentint选填父需求
estimatefloat选填预计工时
specstring选填需求描述
categoryint选填类别(feature 功能 \
sourcestring选填来源(customer 客户 \
verifystring选填验收标准
assignedTostring选填指派给
reviewerarray选填评审人,如果设置必须评审,必须填写
projectint选填所属项目
executionint选填所属执行
PUT 改/stories/:storyID修改需求
请求参数▾ 展开
字段类型必填说明
titlestring必填
priint选填优先级,默认是3
moduleint选填所属模块
parentint选填父需求
estimatefloat选填预计工时
categoryint选填类别(feature 功能 \
sourcestring选填来源(customer 客户 \
assignedTostring选填指派给
PUT 改/stories/:storyID/change变更需求
请求参数▾ 展开
字段类型必填说明
titlestring选填需求名称
reviewerarray必填评审人员
specstring选填需求描述
verifystring选填验收标准
GET 读/products/:productID/stories获取产品需求列表
请求参数▾ 展开
字段类型必填说明
browseType选填assignedtome 指派给我 \
orderBy选填title_asc 标题 \
GET 读/projects/:projectID/stories获取项目需求列表
GET 读/executions/:executionID/stories获取执行需求列表
GET 读/stories/:storyID获取需求详情
PUT 改/stories/:storyID/close关闭需求
请求参数▾ 展开
字段类型必填说明
closedReasonstring必填关闭原因(done 已完成 \
commentstring选填备注
PUT 改/stories/:storyID/activate激活需求
请求参数▾ 展开
字段类型必填说明
assignedTostring选填指派给
commentstring选填备注
DELETE 删/stories/:storyID删除需求

任务

核心 — 任务
POST 增/tasks创建任务
请求参数▾ 展开
字段类型必填说明
namestring必填任务名称
executionIDint必填所属执行
typestring选填任务类型
assignedTostring选填指派给
estStarteddate选填预计开始
deadlinedate选填截止日期
priint选填优先级
estimatenumber选填预计工时
moduleint选填所属模块
storyint选填相关需求
descstring选填任务描述
PUT 改/tasks/:taskID修改任务
请求参数▾ 展开
字段类型必填说明
namestring选填任务名称
typestring选填任务类型
assignedTostring选填指派给
estStarteddate选填预计开始
deadlinedate选填截止日期
priint选填优先级
estimatenumber选填预计工时
moduleint选填所属模块
storyint选填相关需求
descstring选填任务描述
GET 读/executions/:executionID/tasks获取执行任务列表
请求参数▾ 展开
字段类型必填说明
status选填unclosed 未关闭 \
orderBy选填name_asc 名称 \
GET 读/tasks/:taskID获取任务详情
PUT 改/tasks/:taskID/start启动任务
请求参数▾ 展开
字段类型必填说明
assignedTostring选填任务名称
realStartedstring必填实际开始
consumednumber选填总计消耗
leftnumber选填预计剩余
commentstring选填备注
PUT 改/tasks/:taskID/finish完成任务
请求参数▾ 展开
字段类型必填说明
currentConsumednumber必填本次消耗
assignedTostring选填任务名称
consumednumber选填总计消耗
realStarteddate必填实际开始
finishedDatedate必填实际完成
commentstring选填备注
PUT 改/tasks/:taskID/close关闭任务
请求参数▾ 展开
字段类型必填说明
commentstring选填备注
PUT 改/tasks/:taskID/activate激活任务
请求参数▾ 展开
字段类型必填说明
leftnumber选填预计剩余
assignedTostring选填指派给
commentstring选填备注
DELETE 删/tasks/:taskID删除任务

测试用例

核心 — 测试用例
POST 增/testcases创建测试用例
请求参数▾ 展开
字段类型必填说明
productIDint必填所属产品
titlestring必填用例标题
moduleint选填所属模块
storyint选填相关需求
priint选填优先级
typestring选填用例类型(unit 单元测试 \
preconditionstring选填前置条件
stepsarray选填用例步骤
expectsarray选填用例步骤期望
stepTypearray选填用例步骤类型(step 步骤 \
projectint选填所属项目
executionint选填所属执行
PUT 改/testcases/:testcasID修改测试用例
请求参数▾ 展开
字段类型必填说明
titlestring必填用例标题
moduleint选填所属模块
storyint选填相关需求
priint选填优先级
typestring选填用例类型(unit 单元测试 \
preconditionstring选填前置条件
stepsarray选填用例步骤
expectsarray选填用例步骤期望
stepTypearray选填用例步骤类型(step 步骤 \
GET 读/products/:productID/testcases获取产品测试用例列表
请求参数▾ 展开
字段类型必填说明
browseType选填wait 未关闭 \
orderBy选填title_asc 标题 \
GET 读/projects/:projectID/testcases获取项目测试用例列表
请求参数▾ 展开
字段类型必填说明
browseType选填wait 未关闭 \
orderBy选填title_asc 标题 \
GET 读/executions/:executionID/testcases获取执行测试用例列表
请求参数▾ 展开
字段类型必填说明
browseType选填wait 未关闭 \
orderBy选填title_asc 标题 \
GET 读/testcases/:caseID获取测试用例详情
DELETE 删/testcases/:testcasID删除测试用例

执行

迭代/执行
POST 增/executions创建执行
请求参数▾ 展开
字段类型必填说明
projectint必填所属项目
namestring必填迭代名称
lifetimestring选填执行类型(short 短期 \
begindate必填开始日期
enddate必填结束日期
daysint选填可用工作日
productsarray选填关联产品
plansarray选填关联计划,必须是产品+planID的二维数组
POstring选填产品负责人
QDstring选填测试负责人
PMstring选填执行负责人
RDstring选填发布负责人
aclstring选填访问控制(open 公开 \
PUT 改/executions/:executionID修改执行
请求参数▾ 展开
字段类型必填说明
projectint选填所属项目
namestring必填迭代名称
lifetimestring选填执行类型(short 短期 \
begindate必填开始日期
enddate必填结束日期
daysint选填可用工作日
productsarray选填关联产品
plansarray选填关联计划,必须是产品+planID的二维数组
POstring选填产品负责人
QDstring选填测试负责人
PMstring选填执行负责人
RDstring选填发布负责人
aclstring选填访问控制(open 公开 \
GET 读/executions获取执行列表
请求参数▾ 展开
字段类型必填说明
status选填undone 未完成 \
orderBy选填nameCol_asc 名称 \
GET 读/projects/:projectID/executions获取项目的执行列表
请求参数▾ 展开
字段类型必填说明
status选填undone 未完成 \
orderBy选填nameCol_asc 名称 \
GET 读/executions/:executionID获取执行详情
DELETE 删/executions/:executionID删除执行

产品

产品
POST 增/products创建产品
请求参数▾ 展开
字段类型必填说明
namestring必填产品名称
programint选填所属项目集
lineint选填所属产品线
typestring选填类型(normal 正常 \
POstring选填产品负责人
reviewerarray选填评审人
descarray选填产品描述
QDstring选填测试负责人
RDstring选填发布负责人
aclstring选填访问控制(open 公开 \
PUT 改/products/:productID修改产品
请求参数▾ 展开
字段类型必填说明
namestring必填产品名称
programint选填所属项目集
lineint选填所属产品线
typestring选填类型(normal 正常 \
POstring选填产品负责人
reviewerarray选填评审人
descarray选填产品描述
QDstring选填测试负责人
RDstring选填发布负责人
aclstring选填访问控制(open 公开 \
GET 读/products获取产品列表
请求参数▾ 展开
字段类型必填说明
browseType选填noclosed 未关闭 \
orderBy选填title_asc 名称 \
GET 读/programs/:programID/products获取项目集的产品列表
GET 读/products/:productID获取产品详情
DELETE 删/products/:productID删除产品

工单

工单
POST 增/tickets创建工单
请求参数▾ 展开
字段类型必填说明
productint必填所属产品
moduleint选填所属模块
titlestring必填标题
typestring选填类型(code 程序报错 \
descstring选填描述
assignedTostring选填指派给
deadlinedate选填截止日期
openedBuildarray选填影响版本
PUT 改/tickets/:ticketID修改工单
请求参数▾ 展开
字段类型必填说明
productint选填所属产品
moduleint选填所属模块
titlestring选填标题
typestring选填类型(code 程序报错 \
descstring选填描述
assignedTostring选填指派给
deadlinedate选填截止日期
openedBuildarray选填影响版本
GET 读/products/:productID/tickets获取产品工单列表
请求参数▾ 展开
字段类型必填说明
browseType选填unclosed 未关闭 \
orderBy选填title_asc 标题 \
GET 读/tickets/:ticketID获取工单详情
PUT 改/tickets/:ticketID/close关闭工单
请求参数▾ 展开
字段类型必填说明
closedReasonstring必填关闭原因(commented 已处理 \
commentstring必填备注
PUT 改/tickets/:ticketID/activate激活工单
请求参数▾ 展开
字段类型必填说明
assignedTostring选填指派给
commentstring选填备注
DELETE 删/tickets/:ticketID删除工单
请求参数▾ 展开
字段类型必填说明
accountstring必填用户名
passwordstring必填密码

业务需求

业务需求 epics
POST 增/epics创建业务需求
请求参数▾ 展开
字段类型必填说明
productIDint必填产品ID
titlestring必填
priint选填优先级,默认是3
moduleint选填所属模块
parentint选填父业务需求
estimatefloat选填预计工时
specstring选填业务需求描述
categoryint选填类别(feature 功能 \
sourcestring选填来源(customer 客户 \
verifystring选填验收标准
assignedTostring选填指派给
reviewerarray选填评审人,如果设置必须评审,必须填写
PUT 改/epics/:epicID修改业务需求
请求参数▾ 展开
字段类型必填说明
titlestring必填需求名称
priint选填优先级,默认是3
moduleint选填所属模块
parentint选填父业务需求
estimatefloat选填预计工时
categoryint选填类别(feature 功能 \
sourcestring选填来源(customer 客户 \
assignedTostring选填指派给
PUT 改/epics/:epicID/change变更业务需求
请求参数▾ 展开
字段类型必填说明
titlestring选填需求名称
reviewerarray必填评审人员
specstring选填需求描述
verifystring选填验收标准
GET 读/products/:productID/epics获取产品业务需求列表
请求参数▾ 展开
字段类型必填说明
browseType选填assignedtome 指派给我 \
orderBy选填title_asc 标题 \
GET 读/epics/:storyID获取业务需求详情
PUT 改/epics/:epicID/close关闭业务需求
请求参数▾ 展开
字段类型必填说明
closedReasonstring必填关闭原因(done 已完成 \
commentstring选填备注
PUT 改/epics/:epicID/activate激活业务需求
请求参数▾ 展开
字段类型必填说明
assignedTostring选填指派给
commentstring选填备注
DELETE 删/epics/:epicID删除业务需求

用户需求

用户需求
POST 增/requirements创建用户需求
请求参数▾ 展开
字段类型必填说明
productIDint必填产品ID
titlestring必填
priint选填优先级,默认是3
moduleint选填所属模块
parentint选填父用户需求
estimatefloat选填预计工时
specstring选填用户需求描述
categoryint选填类别(feature 功能 \
sourcestring选填来源(customer 客户 \
verifystring选填验收标准
assignedTostring选填指派给
reviewerarray选填评审人,如果设置必须评审,必须填写
PUT 改/requirements/:requirementID修改用户需求
请求参数▾ 展开
字段类型必填说明
titlestring必填
priint选填优先级,默认是3
moduleint选填所属模块
parentint选填父用户需求
estimatefloat选填预计工时
categoryint选填类别(feature 功能 \
sourcestring选填来源(customer 客户 \
assignedTostring选填指派给
PUT 改/requirements/:requirementID/change变更用户需求
请求参数▾ 展开
字段类型必填说明
titlestring选填需求名称
specstring选填需求描述
verifystring选填验收标准
GET 读/products/:productID/requirements获取产品用户需求列表
请求参数▾ 展开
字段类型必填说明
browseType选填assignedtome 指派给我 \
orderBy选填title_asc 标题 \
GET 读/requirements/:storyID获取用户需求详情
PUT 改/requirements/:requirementID/close关闭用户需求
请求参数▾ 展开
字段类型必填说明
closedReasonstring必填关闭原因(done 已完成 \
commentstring选填备注
PUT 改/requirements/:requirementID/activate激活用户需求
请求参数▾ 展开
字段类型必填说明
assignedTostring选填指派给
commentstring选填备注
DELETE 删/requirements/:requirementID删除用户需求

测试单

测试单
POST 增/testtasks创建测试单
请求参数▾ 展开
字段类型必填说明
productIDint必填所属产品ID
namestring必填测试单名称
buildint必填提测构建/版本
executionint选填所属执行
typearray选填类型(integrate 集成测试 \
ownerstring选填负责人
statusstring选填状态(wait 未开始 \
begindate必填开始日期
enddate必填结束日期
descstring选填描述
PUT 改/testtasks/:testtaskID修改测试单
请求参数▾ 展开
字段类型必填说明
namestring必填测试单名称
buildint必填提测构建/版本
executionint选填所属执行
typearray选填类型(integrate 集成测试 \
ownerstring选填负责人
statusstring选填状态(wait 未开始 \
begindate必填开始日期
enddate必填结束日期
descstring选填描述
GET 读/products/:productID/testtasks获取产品测试单列表
GET 读/projects/:projectID/testtasks获取项目测试单列表
GET 读/executions/:executionID/testtasks获取执行测试单列表
DELETE 删/testtasks/:testtaskID删除测试单

项目

项目
POST 增/projects创建项目
请求参数▾ 展开
字段类型必填说明
namestring必填项目名称
modelstring必填项目管理方式(scrum 敏捷 \
begindate必填开始日期
enddate必填结束日期
productsarray选填关联产品
parentint选填所属项目集
workflowGroupint必填项目流程,付费版功能,开源版可以不填
PMstring选填项目负责人
PUT 改/projects/:projectID修改项目
请求参数▾ 展开
字段类型必填说明
namestring必填项目名称
modelstring必填项目管理方式(scrum 敏捷 \
begindate必填开始日期
enddate必填结束日期
productsarray选填关联产品
parentint选填所属项目集
workflowGroupint必填项目流程,付费版功能,开源版可以不填
PMstring选填项目负责人
GET 读/projects获取项目列表
请求参数▾ 展开
字段类型必填说明
browseType选填undone 未完成 \
orderBy选填name_asc 名称 \
GET 读/programs/:programID/projects获取项目集的项目列表
请求参数▾ 展开
字段类型必填说明
browseType选填undone 未完成 \
orderBy选填name_asc 名称 \
DELETE 删/projects/:projectID删除项目

项目集

项目集
POST 增/programs创建项目集
请求参数▾ 展开
字段类型必填说明
namestring必填项目集名称
begindate必填计划开始日期
enddate必填计划完成日期
PMstring选填计划完成日期
descstring选填项目集描述
PUT 改/programs/:programID修改项目集
请求参数▾ 展开
字段类型必填说明
namestring必填项目集名称
begindate必填计划开始日期
enddate必填计划完成日期
PMstring选填计划完成日期
descstring选填项目集描述
GET 读/programs获取项目集列表
请求参数▾ 展开
字段类型必填说明
status选填unclosed 未关闭 \
orderBy选填name_asc 名称 \
GET 读/programs/:programID获取项目集详情
DELETE 删/programs/:programID删除项目集

产品计划

产品计划
POST 增/productplans创建产品计划
请求参数▾ 展开
字段类型必填说明
productIDint必填产品ID
titlestring必填计划名称
parentint选填父计划ID
begindate选填开始日期
enddate选填结束日期
branchIDint选填分支ID
descstring选填计划描述
PUT 改/productplans/:productplanID修改产品计划
请求参数▾ 展开
字段类型必填说明
titlestring必填计划名称
parentint选填父计划
begindate选填开始日期
enddate选填结束日期
branchIDint选填分支ID
descstring选填计划描述
GET 读/products/:productID/productplans获取产品计划列表
请求参数▾ 展开
字段类型必填说明
browseType选填undone 未完成 \
orderBy选填title_asc 名称 \
GET 读/productplans/:planID获取产品计划详情
DELETE 删/productplans/:productplanID删除产品计划

发布

发布
POST 增/releases创建发布
请求参数▾ 展开
字段类型必填说明
productIDint必填所属产品
systemint必填所属应用
namestring必填应用版本号
buildarray必填包含构建
statusstring选填状态(wait 未开始 \
datedate必填计划发布日期
descstring选填描述
PUT 改/releases/:releasID修改发布
请求参数▾ 展开
字段类型必填说明
systemint必填所属应用
namestring必填应用版本号
buildarray必填包含构建
statusstring选填状态(wait 未开始 \
datedate必填计划发布日期
descstring选填描述
GET 读/products/:productID/releases获取产品发布列表
DELETE 删/releases/:releasID删除发布

版本 / 构建

版本/构建
POST 增/builds创建版本/构建
请求参数▾ 展开
字段类型必填说明
executionIDint必填所属执行/迭代
productint必填所属产品
namestring必填构建名称
systemint必填所属应用
builderstring必填构建者
datedate必填打包日期
scmPathstring选填源代码地址
filePathstring选填下载地址
descstring选填描述
PUT 改/builds/:buildID修改版本
请求参数▾ 展开
字段类型必填说明
executionint必填所属执行/迭代
productint必填所属产品
namestring必填构建名称
systemint必填所属应用
builderstring必填构建者
datedate必填打包日期
scmPathstring选填源代码地址
filePathstring选填下载地址
descstring选填描述
GET 读/projects/:projectID/builds获取项目版本列表
GET 读/executions/:executionID/builds获取执行版本列表
DELETE 删/builds/:buildID删除版本

反馈

反馈
POST 增/feedbacks创建反馈
请求参数▾ 展开
字段类型必填说明
productint必填所属产品
titlestring必填标题
moduleint选填所属模块
typestring选填类型(story 需求 \
descstring选填描述
feedbackBystring选填反馈者
sourcestring选填来源
PUT 改/feedbacks/:feedbackID修改反馈
请求参数▾ 展开
字段类型必填说明
productint必填所属产品
moduleint选填所属模块
titlestring必填标题
typestring选填类型(story 需求 \
descstring选填描述
feedbackBystring选填反馈者
sourcestring选填来源
GET 读/products/:productID/feedbacks获取产品反馈列表
请求参数▾ 展开
字段类型必填说明
browseType选填wait 待处理 \
orderBy选填title_asc 标题 \
GET 读/feedbacks/:feedbackID获取反馈详情
PUT 改/feedbacks/:feedbackID/close关闭反馈
请求参数▾ 展开
字段类型必填说明
closedReasonstring必填关闭原因(commented 已处理 \
commentstring选填备注
PUT 改/feedbacks/:feedbackID/activate激活反馈
请求参数▾ 展开
字段类型必填说明
assignedTostring选填指派给
commentstring选填备注
DELETE 删/feedbacks/:feedbackID删除反馈

应用

应用
POST 增/systems创建应用
请求参数▾ 展开
字段类型必填说明
productIDint必填所属产品
integratedint必填是否集成应用(0 否\
childrenarray必填集成应用需要包含其他应用,非集成应用传空数组[]
namestring必填应用名称
descstring选填描述
PUT 改/systems/:systemID修改应用
请求参数▾ 展开
字段类型必填说明
namestring必填应用名称
childrenarray必填集成应用需要包含其他应用,非集成应用传空数组[]
descstring选填描述
GET 读/products/:productID/systems获取产品应用列表

附件

附件(v22+)
POST 增/files上传附件,使用表单方式提交
请求参数▾ 展开
字段类型必填说明
filefile必填文件地址,比如 --form 'file=@"D:\test.txt"'
objectTypestring必填关联对象类型(bug 缺陷 \
objectIDint必填关联对象ID
PUT 改/files/:fileID编辑附件,修改附件的名称
请求参数▾ 展开
字段类型必填说明
fileNamestring必填附件名称
DELETE 删/files/:fileID删除附件

Token

认证
POST 增/users/login获取Token
请求参数▾ 展开
字段类型必填说明
accountstring必填用户名
passwordstring必填密码

用户

用户
POST 增/users创建用户
请求参数▾ 展开
字段类型必填说明
accountstring必填登录名
realnamestring必填姓名
passwordstring必填密码
PUT 改/users/:userID修改用户信息
请求参数▾ 展开
字段类型必填说明
realnamestring选填真实姓名
deptint选填部门
joindate选填入职日期
grouparray选填权限分组
emailstring选填邮箱
visionsarray选填界面类型(研发综合界面 rnd \
mobilestring选填手机
weixinstring选填微信
passwordstring选填密码
GET 读/users获取用户列表
请求参数▾ 展开
字段类型必填说明
browseType选填内部用户 outside
orderBy选填realname_asc 姓名 \
GET 读/users/:userID获取用户详情
DELETE 删/users/:userID删除用户