Zentao

You can connect an AI-powered MCP client to Zentao to query, create, update, and close bugs, stories, and test cases directly from natural language. This MCP server exposes Zentao data and actions through a streamlined interface so you manage work items efficiently across your projects.

How to use

Interact with the Zentao MCP server using an MCP client to query lists, view details, and perform actions across bugs, stories, and test cases. You can create, update, close, reopen, and confirm items, and you can also fetch products, projects, and execution iterations. Use natural language prompts to perform these operations and the MCP client will translate them into Zentao actions.

Examples of common flows you can perform include: retrieving bug lists with status filters, viewing specific bug details, creating new bugs tied to a product, marking bugs as resolved, rebooting bugs, listing stories, creating new stories, and managing test cases by creating, updating, or deleting them. You can also list products and projects or fetch execution lists to gain context for your work.

How to install

{
  "mcpServers": {
    "zentao": {
      "type": "stdio",
      "command": "zentao-mcp",
      "args": [],
      "env": {
        "ZENTAO_URL": "https://your-zentao-server.com",
        "ZENTAO_ACCOUNT": "your_username",
        "ZENTAO_PASSWORD": "your_password",
        "ZENTAO_SKIP_SSL": "true"
      }
    }
  }
}

Prerequisites: you need Node.js and npm or you can install the MCP binary globally. The following steps show common ways to set up the Zentao MCP server so your MCP client can start talking to Zentao.

Configuration and security

Environment variables control connectivity and authentication. Always protect credentials and restrict access to the MCP endpoint. Do not commit sensitive configuration to public repositories.

Environment variables to configure include: ZENTAO_URL for the Zentao server URL, ZENTAO_ACCOUNT for the login username, ZENTAO_PASSWORD for the password, and ZENTAO_SKIP_SSL to bypass SSL verification if you’re using a self-signed certificate.

If you use a local build, you can run the server from source after installing dependencies and building the project, then reference the local path in your MCP config.

Examples and tips

To start with the npx approach, configure your MCP client with a server that uses: command: npx, args: ["-y", "@tytt/zentao-mcp"], and set the ZENTAO_ environment variables accordingly.

If you prefer a global install, run: npm install -g @tytt/zentao-mcp, then reference the installed binary in your MCP config with the appropriate environment variables.

Troubleshooting

If you cannot reach Zentao, verify the URL is correct and that your account credentials have access. Ensure SSL settings match your Zentao server’s certificate configuration. Check that the MCP client has permission to perform the requested operations in Zentao.

Available tools

zentao_get_bugs

Get a list of bugs with optional status filtering

zentao_get_active_bugs

Get a list of unresolved bugs

zentao_get_assigned_bugs

Get bugs assigned to a specific user

zentao_get_bug

Get details for a specific bug by ID

zentao_create_bug

Create a new bug with required fields

zentao_resolve_bug

Mark a bug as resolved

zentao_close_bug

Close a bug

zentao_activate_bug

Reactivate a closed or inactive bug

zentao_confirm_bug

Confirm a bug after verification

zentao_get_stories

Get a list of requirements/stories with optional status filtering

zentao_get_active_stories

Get active/in-progress stories

zentao_get_story

Get details for a specific story by ID

zentao_create_story

Create a new story

zentao_close_story

Close a story

zentao_activate_story

Activate a story

zentao_get_testcases

Get a list of test cases

zentao_get_testcase

Get details for a specific test case by ID

zentao_create_testcase

Create a new test case

zentao_update_testcase

Update an existing test case

zentao_delete_testcase

Delete a test case

zentao_get_products

Get a list of Zentao products

zentao_get_projects

Get a list of Zentao projects

zentao_get_executions

Get a list of execution/iteration lists