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`	Update bug status (resolve, close, activate) and add 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_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: JIRA MCP Server

📦 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

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

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
Testiny Test ManagementOAuth
io.testiny
An MCP server that provides access to Testiny projects, test cases and test runs
Testing & QA Tools Project Management
2
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,011

Related MCP Servers

zentao-mcp-server
Project Management Developer Tools Testing & QA Tools
aipper
A
license
A
quality
B
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 a month ago (2026-07-31 11:23 UTC)
11
66 npm
1
MIT
JIRA MCP Server
Project Management Developer Tools
SuppleAardvark
A
license
A
quality
D
maintenance
An MCP server that provides tools to interact with JIRA for sprint management, issue tracking, and attachment handling.
Updated 8 months ago (2026-01-24 03:13 UTC)
23
25 npm
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 6 days ago (2026-09-07 17:26 UTC)
7
21 npm
5
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 a month ago (2026-08-12 11:57 UTC)
48
11 npm
MIT

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

JIRA MCP Server

Zentao Bug MCP

mcp-zentao