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
在命令行里查 Bug、看产品,让你的 AI 助手也能直接操作禅道。
零依赖、单文件,装完即用。
快速开始
pnpm i -g @leeguoo/zentao-mcp没有 pnpm?也可以用 npm:
npm i -g @leeguoo/zentao-mcp不想装?直接跑:
npx -y @leeguoo/zentao-mcp --help登录
只需登录一次,凭据会保存到本地配置文件:
zentao login \
--zentao-url=https://zentao.example.com/zentao \
--zentao-account=你的账号 \
--zentao-password=你的密码注意: URL 通常需要包含
/zentao路径。如果登录时看到 404,多半是少了这段。
验证登录状态:
zentao whoami配置文件位置:~/.config/zentao/config.toml
日常使用
查看产品列表
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让 AI 帮你查禅道
只需对你的 AI 助手(Cursor / Claude Code / Windsurf 等)说:
帮我安装这个 skill:https://github.com/leeguooooo/zentao-mcp
AI 会自动读取本页面并完成安装。安装后你就可以直接说:
"帮我看下产品 6 有哪些未解决的 Bug"
"查一下 Bug #1329 的详情"
"我名下还有多少活跃 Bug?"
当用户要求安装本仓库为 skill 时,请按顺序执行:
1. 安装 CLI
pnpm i -g @leeguoo/zentao-mcp || npm i -g @leeguoo/zentao-mcp2. 验证安装
zentao --help3. 下载 SKILL.md
从 GitHub 获取 SKILL.md 原始内容并保存到本地 skill 目录:
# Cursor 用户
mkdir -p ~/.cursor/skills/zentao
curl -fsSL https://raw.githubusercontent.com/leeguooooo/zentao-mcp/refs/heads/main/skills/zentao/SKILL.md -o ~/.cursor/skills/zentao/SKILL.md
# Claude Code 用户(~/.codex/skills/)
mkdir -p ~/.codex/skills/zentao
curl -fsSL https://raw.githubusercontent.com/leeguooooo/zentao-mcp/refs/heads/main/skills/zentao/SKILL.md -o ~/.codex/skills/zentao/SKILL.md根据用户使用的工具选择对应路径。如果无法判断,优先用 ~/.cursor/skills/zentao/SKILL.md。
4. 引导登录
提示用户提供禅道 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。
链接
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