zentao-mcp

MCP server for ZenTao RESTful APIs (products + bugs).

Quick Start

Cursor IDE

1. Open Cursor Settings (⌘, on Mac or Ctrl+, on Windows/Linux)

2. Navigate to Features → Model Context Protocol

3. Click Edit Config to open ~/.cursor/mcp.json (or create it)

4. Add the following configuration:

5. Restart Cursor IDE

Other MCP Clients (Claude Desktop, etc.)

For clients using TOML configuration (e.g., Claude Desktop), add to your MCP config file:

Config file locations:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.toml (Mac) or %APPDATA%\Claude\claude_desktop_config.toml (Windows)

• Cursor: ~/.cursor/mcp.json (JSON format)

Configuration

Required Parameters

You can configure the server using CLI arguments or environment variables:

CLI Arguments:

• --zentao-url (e.g. https://zentao.example.com/zentao)

• --zentao-account

• --zentao-password

Environment Variables:

• ZENTAO_URL (e.g. https://zentao.example.com/zentao)

• ZENTAO_ACCOUNT

• ZENTAO_PASSWORD

Using Environment Variables in Cursor

If you prefer to use environment variables instead of CLI args, you can configure them in Cursor:

Tip: ZENTAO_URL should include the ZenTao base path (often /zentao).

Tools

The MCP server provides four tools that can be triggered by natural language in Cursor:

• zentao_products_list - List all products

• zentao_bugs_list - List bugs for a specific product

• zentao_bug_get - Get bug details by ID

• zentao_bugs_mine - List my bugs by assignment or creator (status filter supported)

Usage Examples

After configuring the MCP server in Cursor, you can use natural language to interact with ZenTao:

English:

• "Show me all products"

• "List bugs for product 1"

• "Show bug 123"

• "Show me bugs"

• "Show my bugs"

• "List bugs assigned to me"

• "View bugs in product 2"

Chinese (中文):

• "看bug" / "查看bug" / "显示bug"

• "产品1的bug列表"

• "查看bug 123"

• "显示所有产品"

• "查看产品2的问题"

• "我的bug"

• "分配给我的bug"

The AI will automatically:

1. Use zentao_products_list to get product IDs when needed

2. Use zentao_bugs_list when you ask to see bugs

3. Use zentao_bug_get when you ask for bug details

4. Use zentao_bugs_mine when you ask for your own bugs

Tool Parameters

zentao_products_list:

zentao_bugs_list:

zentao_bug_get:

zentao_bugs_mine:

Local Development

Security

Do not commit credentials. Prefer environment variables in local runs.