How do I use Zentao MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Zentao MCP Server show me tasks in execution 42" 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 Server

by dyno-nexsoft

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

Zentao MCP Server

GitHub Packages GitHub release License Node.js TypeScript MCP Tests

A Model Context Protocol (MCP) server for integrating AI assistants (Claude, Cursor, etc.) with the ZenTao project management API.
Fetch task details, bug reports, and attachments — all directly inside your AI chat.

✨ Features

Tool	Description
`zentao_get_details`	Fetch full details of a task or bug by ID
`zentao_get_comments`	Fetch only the history and comments timeline of a task or bug (with comment IDs)
`zentao_add_comment`	Add a comment/remark to a task or bug
`zentao_edit_comment`	Edit an existing comment by its action ID
`zentao_delete_comment`	Delete (soft-hide) a comment by its action ID
`zentao_update_task_status`	Update task status (start, finish, close, pause, cancel, restart) and add optional comments/hours
`zentao_update_bug_status`	Confirm a bug, or update its status (resolve, close, activate), with optional comments/resolutions
`zentao_create_task`	Create a new task under an execution
`zentao_edit_task`	Edit an existing task's fields
`zentao_get_assigned_to_me`	Get tasks and bugs currently assigned to you (configured via `ZENTAO_ACCOUNT`)
`zentao_get_my_tasks`	Get only the tasks currently assigned to you
`zentao_get_my_bugs`	Get only the bugs currently assigned to you
`zentao_create_bug`	Create a new bug under a product
`zentao_edit_bug`	Edit an existing bug's fields
`zentao_list_tasks`	List tasks in an execution (optionally filtered by keyword)
`zentao_list_bugs`	List bugs in a product (optionally filtered by keyword)
`zentao_list_products`	List the products (IDs are needed to create or list bugs)
`zentao_list_projects`	List the projects
`zentao_list_executions`	List the executions (IDs are needed to create or list tasks), optionally of one project
`zentao_list_users`	List the users to find the account to assign to, with an optional keyword
`zentao_delete_task`	Permanently delete a task
`zentao_delete_bug`	Permanently delete a bug
`zentao_record_effort`	Log hours spent and hours left on a task
`zentao_download_attachment`	Download an attachment by file ID and return the local path
`zentao_search`	Search tasks or bugs within an execution/product scope, filtering by keyword, status, priority, severity, assignee, and/or opened-date range

Under the hood:

🔐 Auto login & token refresh — no manual auth needed
📦 In-memory cache (2 min TTL) + in-flight request dedup — avoids redundant API calls
🔁 Classic JSON API fallback — seamlessly retries via the web API when the REST endpoint returns empty or errors
🖼️ Inline HTML images are automatically downloaded and served as local file:// links
📎 Attachments are downloaded and embedded as clickable local links
🛡️ Corrupt partial downloads are auto-cleaned on error
⚡ Non-blocking async image I/O — base64 encoding uses fs.promises + Promise.all

Related MCP server: Zentao Bug MCP

📦 Installation

Published on GitHub Packages — add this to ~/.npmrc first (needs a GitHub token with read:packages):

@dyno-nexsoft:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN

npx @dyno-nexsoft/zentao_mcp        # run directly
npm install -g @dyno-nexsoft/zentao_mcp   # or install globally

Or clone & build

git clone https://github.com/dyno-nexsoft/zentao_mcp.git
cd zentao_mcp
npm install
npm run build

⚙️ Configuration

Create a .env file in the project root (or pass via MCP client env block):

ZENTAO_BASE_URL=https://your-zentao-url.com/zentao/api.php/v1
ZENTAO_ACCOUNT=your_username
ZENTAO_PASSWORD=your_password

# Optional: bypass SSL certificate errors (self-signed/invalid cert).
# Set to 'true' only if your ZenTao server has a broken/untrusted certificate.
ZENTAO_ALLOW_INSECURE_SSL=false

🔌 MCP Client Integration

This server communicates via stdio transport — compatible with any MCP client.

Claude Desktop / Cursor / Windsurf

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "zentao": {
      "command": "npx",
      "args": ["-y", "@dyno-nexsoft/zentao_mcp"],
      "env": {
        "ZENTAO_BASE_URL": "https://your-zentao-url.com/zentao/api.php/v1",
        "ZENTAO_ACCOUNT": "your_username",
        "ZENTAO_PASSWORD": "your_password",
        "ZENTAO_ALLOW_INSECURE_SSL": "false"
      }
    }
  }
}

🧑‍💻 Development

npm run build      # Compile TypeScript
npm run dev        # Watch mode
npm test           # Unit tests (Jest)
npm run test:api   # Live API integration test

Project structure

src/
├── index.ts                  # MCP server entry point
├── zentaoClient.ts           # Axios client: auth, cache, dedup, fallback, stream helpers
├── tools.ts                  # Thin orchestrator + backward-compat exports
├── utils/
│   ├── fileUtils.ts          # toFileUrl · getMimeType · formatSize
│   ├── markdownUtils.ts      # htmlToMarkdown · parseFiles · formatUser
│   └── mcpResponse.ts        # mcpText · buildMcpResponse (async)
├── formatters/
│   ├── imageLocalizer.ts     # Inline <img> → local file:// link (deduped, concurrent)
│   ├── attachmentRenderer.ts # Attachments → Markdown ## Files section
│   ├── actionFormatter.ts    # renderHistoryAndComments
│   ├── taskFormatter.ts      # taskToMarkdown (includes comments)
│   ├── bugFormatter.ts       # bugToMarkdown (includes comments)
│   └── myWorkFormatter.ts    # myWorkToMarkdown · myTasksToMarkdown · myBugsToMarkdown
└── tools/
    ├── detailTool.ts         # zentao_get_details
    ├── commentTool.ts        # zentao_get_comments · zentao_add_comment · zentao_edit_comment · zentao_delete_comment
    ├── statusTool.ts         # zentao_update_task_status · zentao_update_bug_status
    ├── taskTool.ts           # zentao_create_task · zentao_edit_task
    └── myWorkTool.ts         # zentao_get_assigned_to_me · zentao_get_my_tasks · zentao_get_my_bugs

Running tests

npm test           # Unit tests — 19 tests across ZentaoClient
npm run test:api   # Live API integration test (requires .env)

📄 License

This server cannot be deployed

Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

JFrog Remote MCP Server
io.github.jfrog
MCP Server for JFrog, providing tools for development and artifact management.
Developer Tools CI/CD & DevOps Cloud Platforms
215
cloudtime API
io.github.julysoft
MCP server providing attendance data queries via the CloudTime API.
Workplace & Productivity
2
Azure DevOps (ADO)OAuth
io.github.PremierInc
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
CI/CD & DevOps Version Control Project Management
22,061
mcp-serverOAuth
com.niftypm
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Project Management Communication File Systems
2

Related MCP Servers

zentao-mcp-server
Project Management Developer Tools Testing & QA Tools
aipper
A
license
A
quality
D
maintenance
A Model Context Protocol (MCP) server that integrates with Zentao's RESTful API to manage bugs, including listing, resolving, closing, and commenting, with support for product and project set contexts.
Updated 3 months ago (2026-07-31 11:23 UTC)
11
15 npm
1
MIT
Zentao Bug MCP
Project Management Testing & QA Tools
ceeyang
A
license
A
quality
B
maintenance
MCP server for Zentao that reads bugs, extracts reproduction steps, and allows AI to update bug status after fixing.
Updated 2 months ago (2026-09-07 17:26 UTC)
7
17 npm
6
MIT
mcp-zentao
Project Management Testing & QA Tools
luffy-mcw
A
license
D
quality
C
maintenance
An MCP server that enables reading and managing Zentao tasks, bugs, requirements, test cases, and test suites via the ZenTao 11.3 Legacy Session API. It integrates with MCP clients like Codex, Claude Desktop, and Cursor.
Updated 2 months ago (2026-08-12 11:57 UTC)
48
5 npm
MIT
zentao-mcp
Project Management Testing & QA Tools Developer Tools
wohaixiao-qds
F
license
A
quality
C
maintenance
Exposes Zentao REST API as MCP tools for listing/searching bugs, reading details with screenshots, and resolving bugs after explicit confirmation. Includes a setup wizard to configure Codex, Claude, Cursor and other clients.
Updated 2 months ago (2026-08-17 07:13 UTC)
5
-

Zentao MCP Server

✨ Features

📦 Installation

Or clone & build

⚙️ Configuration

🔌 MCP Client Integration

Claude Desktop / Cursor / Windsurf

🧑‍💻 Development

Project structure

Running tests

📄 License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

zentao-mcp-server

Zentao Bug MCP

mcp-zentao

zentao-mcp