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 for products + bugs.
Installation
Global install (recommended):
If you don't have pnpm:
Or use without installing:
This installs the zentao command (and keeps zentao-mcp as a compatibility alias).
Configuration
Required Parameters
You can configure the CLI using CLI arguments or environment variables:
CLI arguments:
--zentao-url(e.g.https://zentao.example.com/zentao)--zentao-account--zentao-password
Environment variables:
ZENTAO_URLZENTAO_ACCOUNTZENTAO_PASSWORD
Tip: ZENTAO_URL should include the ZenTao base path (often /zentao).
Example:
https://zentao.example.com/zentao(common)
If you see 404 Not Found when logging in, your base path is likely missing /zentao.
Commands
List products:
Full JSON output:
List bugs for a product:
Full JSON output:
Get bug details:
Full JSON output:
List my bugs:
Full JSON output:
Self test:
Login
Save credentials locally (stored as plaintext TOML under your user config directory):
Config file:
~/.config/zentao/config.toml(or$XDG_CONFIG_HOME/zentao/config.toml)
Then commands can omit auth flags:
Troubleshooting login:
If
Token response parse failed: <html>...404 Not Found..., try:https://your-host/zentaoinstead ofhttps://your-host/
Release (maintainers)
GitHub Actions (recommended)
This repo supports npm Trusted Publisher (OIDC) via GitHub Actions.
Create a tag matching
package.jsonversion:
The workflow
.github/workflows/publish-npm.ymlwill run tests and publish to npm.
In npm Trusted Publisher settings, set the workflow filename to publish-npm.yml.
Local release (fallback)
Requires git, npm, and gh.
If you are using GitHub Actions publishing, prefer tagging + pushing, or run local release with:
Local Development
Security
Do not commit credentials. Prefer environment variables in local runs.
Skill
For OpenClaw (AgentSkills-compatible), see skills/zentao/SKILL.md.