ZenTao MCP Server
The ZenTao MCP Server is a CLI tool that provides programmatic integration with ZenTao project management software to manage and query products and bugs.
List Products: Retrieve all products with details like ID, name, and bug counts, with pagination support using
zentao_products_list.List Bugs by Product: View bugs for a specific product by providing the product ID with
zentao_bugs_list.Get Bug Details: Fetch comprehensive details about a specific bug using its ID with
zentao_bug_get.List My Bugs: Access a personalized list of bugs assigned to or created by you with flexible filtering options including scope (assigned/opened/resolved/all), status (active/resolved/closed/all), product ID, account, pagination controls, and optional full details using
zentao_bugs_mine.Authentication: Configure credentials via CLI arguments, environment variables, or saved login for seamless access without re-authentication.
Bilingual Support: Handles queries in both English and Chinese for common bug-related operations.
JSON Output: Commands support full JSON output for programmatic use.
Self-Test: Verify configuration and connectivity with a diagnostic self-test command.
Local Development: Includes tools for testing and development workflows.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ZenTao MCP Servershow me bugs assigned to me"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
zentao-mcp
⚠️ 本项目不再维护。 推荐改用禅道官方维护的
zentao-cli和配套 Skillseasysoft/zentao-skills：基于 RESTful API v2、内置 MCP server、模块覆盖更全，且持续更新。已经在用本包的用户不受影响，可以继续装；新项目请优先选择上游：
npm i -g zentao-cli npx skills add easysoft/zentao-skills
在命令行里查 Bug、任务、需求、待办、产品、项目、测试和文档，让你的 AI 助手也能直接操作禅道。
零依赖、单文件，装完即用。
快速开始
npx skills add leeguooooo/zentao-mcp -y -g安装 CLI：
pnpm i -g @leeguoo/zentao-mcp没有 pnpm？也可以用 npm：
npm i -g @leeguoo/zentao-mcp不想装？直接跑：
npx -y @leeguoo/zentao-mcp --helpskills add 只负责安装 skill 文件；CLI 仍然建议全局安装后直接用 zentao 命令。
登录
只需登录一次，凭据会保存到本地配置文件：
zentao login \
--zentao-url=https://zentao.example.com/zentao \
--zentao-account=你的账号 \
--zentao-password=你的密码注意： URL 通常需要包含
/zentao路径。如果登录时看到 404，多半是少了这段。
验证登录状态：
zentao whoami配置文件位置：~/.config/zentao/config.toml
支持的能力
当前 CLI 已支持这些对象和动作：
认证与连通性：
login、whoami、self-testBug：列表、查询、创建、指派、评论、解决、关闭、激活、查我的 Bug
任务：列表、查询、创建、开始、完成、暂停、关闭
需求：列表、查询、创建
待办：列表、查询、创建、完成、关闭
产品 / 项目 / 项目集 / 执行：列表，项目构建查询
计划 / 发布：列表、详情
测试用例 / 测试单 / 测试套件：列表、详情
文档库 / 文档：列表、详情
用户 / 部门：列表
问题 / 风险：列表、详情
机器可读输出：全部命令支持
--json
日常使用
查看产品列表
zentao products list查看某个产品的 Bug
zentao bugs list --product 6查看 Bug 详情
zentao bug get --id 1329查看分配给我的 Bug
zentao bugs mine --status active带详情：
zentao bugs mine --status active --include-details需要原始 JSON？
任何命令后面加 --json：
zentao products list --json
zentao bugs list --product 6 --json
zentao bug get --id 1329 --json
zentao bugs mine --include-details --json自检
验证 API 连接是否正常：
zentao self-test命令总览
zentao login --zentao-url=... --zentao-account=... --zentao-password=...
zentao whoami
zentao self-test
zentao products list
zentao programs list
zentao projects list
zentao projects builds --id 22
zentao executions list
zentao bugs list --product 6
zentao bugs mine --status active --include-details
zentao bug get --id 1329
zentao bug create --product 6 --title "bug title"
zentao bug assign --id 1329 --assigned-to someone
zentao bug resolve --id 1329 --resolution fixed
zentao bug close --id 1329
zentao bug activate --id 1329
zentao bug comment --id 1329 --comment "comment"
zentao tasks list --execution 25
zentao task get --id 388
zentao task create --execution 25 --name "task name"
zentao task start --id 388
zentao task finish --id 388
zentao task pause --id 388
zentao task close --id 388
zentao stories list --product 3
zentao story get --id 1
zentao story create --product 3 --title "story title"
zentao todos list
zentao todos get --id 1
zentao todos create --name "todo name"
zentao todos finish --id 1
zentao todos close --id 1
zentao plans list --product 3
zentao plans get --id 1
zentao releases list --product 3
zentao releases get --id 1
zentao testcases list --product 3
zentao testcases get --id 1
zentao testtasks list
zentao testtasks get --id 1
zentao testsuites list --product 3
zentao testsuites get --id 1
zentao docs libs
zentao docs list --lib 50
zentao docs get --id 1
zentao users list
zentao departments list
zentao issues list
zentao issues get --id 1
zentao risks list
zentao risks get --id 1让 AI 帮你查禅道
只需对你的 AI 助手（Cursor / Claude Code / Windsurf 等）说：
帮我执行
npx skills add leeguooooo/zentao-mcp -y -g，然后帮我登录禅道
安装后你就可以直接说：
"帮我看下产品 6 有哪些未解决的 Bug"
"查一下 Bug #1329 的详情"
"我名下还有多少活跃 Bug？"
"帮我看执行 25 下有哪些任务"
"查一下产品 3 的需求 / 计划 / 发布"
"列出测试单、测试用例、测试套件"
"看一下项目问题和风险"
"打开文档库 50 里的文档列表"
当用户要求安装本仓库为 skill 时，请按顺序执行：
1. 安装 Skill
npx skills add leeguooooo/zentao-mcp -y -g2. 安装 CLI
pnpm i -g @leeguoo/zentao-mcp || npm i -g @leeguoo/zentao-mcp3. 验证安装
zentao --help4. 引导登录
提示用户提供禅道 URL、账号和密码，然后执行：
zentao login --zentao-url="<用户的禅道URL>" --zentao-account="<账号>" --zentao-password="<密码>"注意：URL 通常需要包含
/zentao，如https://zentao.example.com/zentao
5. 验证
zentao whoami
zentao self-test全部通过后告知用户安装完成。
常见问题
Q: 登录时报 404？
A: URL 需要包含 /zentao，比如 https://zentao.example.com/zentao，而不是 https://zentao.example.com/。
Q: 支持哪些禅道版本？ A: 支持禅道开源版和企业版的 REST API（v1）。
Q: 凭据安全吗？
A: 凭据以明文 TOML 存储在 ~/.config/zentao/config.toml，请确保文件权限安全。不要把配置文件提交到 Git。
链接
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/leeguooooo/zentao-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server