zentao

禅道 (Zentao) MCP Server，通过 mcp__zentao__* 系列工具供 Agent 操作禅道数据，覆盖需求/Bug/任务/用例/项目/产品/执行/版本/反馈/工单/用户等全部 CRUD。

认证

• 优先使用环境变量 ZENTAO_TOKEN（API Token）
• 无 Token 时用 ZENTAO_ACCOUNT + ZENTAO_PASSWORD 自动登录
• 需设置 ZENTAO_BASE_URL（禅道根地址，如 http://172.20.20.211:8099）

工具清单

| 模块 | 工具名 | 功能 | |------|--------|------| | 用户 | zentao_get_my_profile | 获取当前用户信息 | | | zentao_get_user | 获取用户详情 | | | zentao_list_users | 获取用户列表 | | | zentao_create_user | 创建用户 | | | zentao_update_user | 修改用户 | | | zentao_delete_user | 删除用户 | | 项目集 | zentao_list_programs | 获取项目集列表 | | | zentao_get_program | 获取项目集详情 | | | zentao_create_program | 创建项目集 | | | zentao_update_program | 修改项目集 | | | zentao_delete_program | 删除项目集 | | 产品 | zentao_list_products | 获取产品列表 | | | zentao_get_product | 获取产品详情 | | | zentao_create_product | 创建产品 | | | zentao_update_product | 修改产品 | | | zentao_delete_product | 删除产品 | | 产品计划 | zentao_list_plans | 获取计划列表 | | | zentao_get_plan | 获取计划详情 | | | zentao_create_plan | 创建计划 | | | zentao_update_plan | 修改计划 | | | zentao_delete_plan | 删除计划 | | | zentao_link_plan_stories | 计划关联需求 | | | zentao_unlink_plan_stories | 计划取消关联需求 | | | zentao_link_plan_bugs | 计划关联 Bug | | | zentao_unlink_plan_bugs | 计划取消关联 Bug | | 发布 | zentao_list_project_releases | 获取项目发布列表 | | | zentao_list_product_releases | 获取产品发布列表 | | 需求 | zentao_get_story | 获取需求详情 | | | zentao_list_stories | 列出需求 | | | zentao_create_story | 创建需求 | | | zentao_update_story | 修改需求 | | | zentao_delete_story | 删除需求 | | | zentao_change_story | 变更需求 | | 项目 | zentao_list_projects | 获取项目列表 | | | zentao_get_project | 获取项目详情 | | | zentao_create_project | 创建项目 | | | zentao_update_project | 修改项目 | | | zentao_delete_project | 删除项目 | | 执行/迭代 | zentao_list_executions | 获取执行列表 | | | zentao_get_execution | 获取执行详情 | | | zentao_create_execution | 创建执行/迭代 | | | zentao_update_execution | 修改执行 | | | zentao_delete_execution | 删除执行 | | 版本 | zentao_list_project_builds | 获取项目版本列表 | | | zentao_list_execution_builds | 获取执行版本列表 | | | zentao_get_build | 获取版本详情 | | | zentao_create_build | 创建版本 | | | zentao_update_build | 修改版本 | | | zentao_delete_build | 删除版本 | | Bug | zentao_get_bug | 获取 Bug 详情 | | | zentao_list_bugs | 列出 Bug | | | zentao_create_bug | 创建 Bug | | | zentao_update_bug | 修改 Bug | | | zentao_delete_bug | 删除 Bug | | 任务 | zentao_get_task | 获取任务详情 | | | zentao_list_tasks | 列出任务 | | 用例 | zentao_list_testcases | 获取用例列表 | | | zentao_get_testcase | 获取用例详情 | | | zentao_create_testcase | 创建用例 | | | zentao_update_testcase | 修改用例 | | | zentao_delete_testcase | 删除用例 | | 测试单 | zentao_list_testtasks | 获取测试单列表 | | | zentao_list_project_testtasks | 获取项目测试单 | | | zentao_get_testtask | 获取测试单详情 | | 反馈 | zentao_list_feedbacks | 获取反馈列表 | | | zentao_get_feedback | 获取反馈详情 | | | zentao_create_feedback | 创建反馈 | | | zentao_update_feedback | 修改反馈 | | | zentao_delete_feedback | 删除反馈 | | | zentao_assign_feedback | 指派反馈 | | | zentao_close_feedback | 关闭反馈 | | 工单 | zentao_list_tickets | 获取工单列表 | | | zentao_get_ticket | 获取工单详情 | | | zentao_create_ticket | 创建工单 | | | zentao_update_ticket | 修改工单 | | | zentao_delete_ticket | 删除工单 |

行为特性

• 自动重登录：Token 过期（401）时自动用账号密码重新登录并重试，对调用方透明。
• 错误返回：失败时以 isError: true 返回，文本包含具体原因。
• 禅道版本：仅支持 v18+ REST API。