ZenTao MCP Server - Model Context Protocol Integration for ZenTao Project Management
Overview
ZenTao MCP Server is a comprehensive Model Context Protocol (MCP) server that provides seamless integration between AI assistants and the ZenTao project management system. Built with Go, this server exposes 518 tools, 46 resources, and 2 prompts covering all major ZenTao modules including products, projects, user stories, tasks, bugs, test cases, releases, builds, and more.
What is ZenTao?
ZenTao is an open-source project management and bug tracking system designed for agile development teams. It supports Scrum, Kanban, and waterfall methodologies, providing comprehensive features for product management, project planning, requirement tracking, bug management, and test case management.
What is MCP?
The Model Context Protocol (MCP) is an open protocol that enables AI assistants to securely access external data sources and tools. MCP servers act as bridges between AI applications and various services, allowing LLMs to interact with APIs, databases, and other systems in a standardized way.
Key Features
- 🚀 518 MCP Tools - Complete CRUD operations for all ZenTao entities (products, projects, stories, tasks, bugs, users, AI features, and more)
- 📦 46 MCP Resources - URI-based data access with RESTful resource patterns
- 🔧 100 Resource Templates - Dynamic resource access with parameterized URIs
- 💡 2 MCP Prompts - Guided workflows for common operations (product creation, story creation)
- 🔐 Authentication Support - App-based and session-based authentication methods
- 📊 Full API Coverage - Supports all ZenTao modules including:
- Product Management
- Project Management & Executions
- User Stories & Requirements
- Task Management
- Bug Tracking (Enhanced with batch operations)
- Test Case Management (Enhanced with scenes, import/export)
- Test Task Management (Enhanced with execution, results)
- Case Library Management
- Test Report Generation
- Test Suite Management
- Build & Release Management
- Kanban Boards
- AI Integration (ZAI)
- Node Management (Zanode)
- Documentation Management
- Datatable and Report Management
- Company, Department, Group and User Administration
- AI App Management
- Business Intelligence (BI)
- And much more
- 📝 Comprehensive Logging - Detailed logging for debugging and monitoring
- ⚡ High Performance - Built with Go for optimal performance and low resource usage
Table of Contents
- Installation
- Quick Start
- Configuration
- Tools Reference
- Resources Reference
- Prompts
- Usage Examples
- API Documentation
- Contributing
- License
- Contact
Installation
Prerequisites
- Go 1.23 or higher
- Access to a ZenTao instance (version 21.7.7 or compatible)
- ZenTao API credentials (app code/key or session credentials)
Build from Source
# Clone the repository
git clone https://github.com/bivex/ZenTaoMcp.git
cd ZenTaoMcp
# Build the server
cd src
go mod download
go build -o mcp-server
# Run the server
./mcp-server
Quick Start
-
Set Environment Variables:
export ZENTAO_BASE_URL="https://your-zentao-instance.com" export ZENTAO_AUTH_METHOD="app" export ZENTAO_APP_CODE="your-app-code" export ZENTAO_APP_KEY="your-app-key" -
Start the MCP Server:
./mcp-server -
Connect from Your MCP Client: The server communicates via stdio using the MCP protocol. Configure your MCP client to use this server.
Configuration
Environment Variables
| Variable | Description | Default | Required |
|---|---|---|---|
ZENTAO_BASE_URL | ZenTao API base URL | http://localhost:8080 | No |
ZENTAO_AUTH_METHOD | Authentication method: app or session | app | No |
ZENTAO_APP_CODE | App code for app-based authentication | - | Yes (if using app auth) |
ZENTAO_APP_KEY | App key for app-based authentication | - | Yes (if using app auth) |
ZENTAO_LOG_LEVEL | Log level (debug, info, warn, error) | info | No |
ZENTAO_LOG_JSON | Enable JSON logging format | false | No |
Authentication Methods
App-Based Authentication (Recommended)
export ZENTAO_AUTH_METHOD="app"
export ZENTAO_APP_CODE="your-app-code"
export ZENTAO_APP_KEY="your-app-key"
Session-Based Authentication
export ZENTAO_AUTH_METHOD="session"
# Then use zentao_login_session tool with account/password
Tools (400 Total)
The server provides comprehensive tools for managing all aspects of ZenTao. Here's a categorized overview:
Authentication (2 tools)
zentao_login_app- Login with app credentialszentao_login_session- Login with session credentials
Products (8 tools)
create_product- Create a new productedit_product- Edit an existing productview_product- View product detailsdelete_product- Delete a productbrowse_products- Browse products with filtersget_product_index- Get product index/dashboardget_product_projects- Get projects for a productget_product_stories- Get stories for a product
Projects (15+ tools)
create_project- Create a new projectedit_project- Edit an existing projectview_project- View project detailsget_project_index- Get project indexbrowse_projects- Browse projects with filtersget_project_kanban- Get project kanban boardget_project_team- Get project team membersmanage_project_members- Manage project membersget_project_executions- Get project executionsget_project_stories- Get project storiesget_project_bugs- Get project bugsget_project_testcases- Get project test casesget_project_builds- Get project buildsget_project_releases- Get project releasesupdate_execution- Update execution details
Stories (20+ tools)
create_story- Create a new user storyedit_story- Edit an existing storyview_story- View story detailsdelete_story- Delete a storybrowse_stories- Browse stories with filtersreview_story- Review a storyclose_story- Close a storyassign_story- Assign story to userlink_story- Link related stories- And more...
Tasks (15+ tools)
create_task- Create a new taskedit_task- Edit an existing taskview_task- View task detailsstart_task- Start a taskfinish_task- Finish a taskclose_task- Close a taskassign_task- Assign task to user- And more...
Bugs (35+ tools)
create_bug- Create a new bugupdate_bug- Update an existing bugbrowse_bugs- Browse bugs with filtering and paginationget_bug- Get bug detailsassign_bug- Assign bug to userconfirm_bug- Confirm a bugresolve_bug- Resolve a bugactivate_bug- Activate a closed bugclose_bug- Close a bugdelete_bug- Delete a bugexport_bugs- Export bugs to filereport_bugs- Generate bug reportlink_bugs- Link related bugsconfirm_bug_story_change- Confirm story change for a bug- Batch operations:
batch_create_bugs,batch_edit_bugs,batch_change_bug_branch,batch_change_bug_module,batch_change_bug_plan,batch_assign_bugs,batch_confirm_bugs,batch_resolve_bugs,batch_close_bugs,batch_activate_bugs - And more...
Test Cases (30+ tools)
create_testcase- Create a new test caseupdate_testcase- Update an existing test casebrowse_testcases- Browse test cases with filteringview_testcase- View test case detailsdelete_testcase- Delete a test casereview_testcase- Review a test casecreate_bug_from_testcase- Create a bug from a test caselink_testcases- Link related test caseslink_bugs_to_testcase- Link bugs to a test case- Batch operations:
batch_create_testcases,batch_edit_testcases,batch_delete_testcases,batch_review_testcases,batch_change_testcase_branch,batch_change_testcase_module,batch_change_testcase_type - Import/Export:
export_testcases,export_testcase_template,import_testcases,import_testcases_from_lib,import_testcase_to_lib - Scene management:
browse_testcase_scenes,create_testcase_scene,edit_testcase_scene,delete_testcase_scene - Analysis:
group_testcases,get_zero_testcases - And more...
Test Tasks (20+ tools)
create_testtask- Create a new test taskget_testtasks- Get list of test tasksbrowse_testtasks- Browse test tasks with filteringget_testtask- Get test task detailsedit_testtask- Edit an existing test taskstart_testtask- Start a test taskclose_testtask- Close a test taskblock_testtask- Block a test taskactivate_testtask- Activate a blocked test taskdelete_testtask- Delete a test taskget_testtask_cases- Get test cases for a test taskget_testtask_unit_cases- Get unit test cases for a test tasklink_case_to_testtask- Link test case to test taskunlink_case_from_testtask- Unlink test case from test taskbatch_unlink_cases_from_testtask- Unlink multiple test casesrun_testcase- Run a test case in test taskbatch_run_testcases- Run multiple test casesget_testtask_results- Get test results for a test taskassign_testcase- Assign test case to userbatch_assign_testcases- Assign multiple test casesreport_testtask- Generate test task reportgroup_testtask_cases- Group test cases in test taskbrowse_testtask_units- Browse unit test tasksimport_unit_test_result- Import unit test resultget_project_testtasks- Get test tasks for a project
Plans (10+ tools)
create_plan- Create a new planedit_plan- Edit an existing planview_plan- View plan detailsdelete_plan- Delete a plan- And more...
Builds (15+ tools)
create_build- Create a new buildedit_build- Edit an existing buildview_build- View build detailsdelete_build- Delete a buildget_product_builds- Get builds for a productget_project_builds- Get builds for a projectget_execution_builds- Get builds for an executionlink_story_to_build- Link story to buildlink_bug_to_build- Link bug to build- And more...
Releases (2 tools)
get_project_releases- Get releases for a projectget_product_releases- Get releases for a product
Users (5+ tools)
create_user- Create a new useredit_user- Edit an existing userget_user- Get user detailsdelete_user- Delete a userbrowse_users- Browse users with filters
Feedback (5+ tools)
create_feedback- Create a new feedbackedit_feedback- Edit an existing feedbackview_feedback- View feedback detailsdelete_feedback- Delete a feedbackassign_feedback- Assign feedback to user
Tickets (5+ tools)
create_ticket- Create a new ticketedit_ticket- Edit an existing ticketview_ticket- View ticket detailsdelete_ticket- Delete a ticketbrowse_tickets- Browse tickets with filters
Programs (15+ tools)
create_program- Create a new programedit_program- Edit an existing programview_program- View program detailsclose_program- Close a programstart_program- Start a programget_program_products- Get products in a programget_program_projects- Get projects in a programget_program_stakeholders- Get program stakeholders- And more...
My Module (15+ tools)
get_my_dashboard- Get user dashboardget_my_profile- Get user profileedit_my_profile- Edit user profilechange_my_password- Change user passwordget_my_todos- Get user todosget_my_stories- Get user storiesget_my_tasks- Get user tasksget_my_bugs- Get user bugsget_my_projects- Get user projectsget_my_executions- Get user executionsget_my_team- Get user teamget_my_dynamic- Get user activity feed- And more...
Todos (20+ tools)
create_todo- Create a new todoedit_todo- Edit an existing todostart_todo- Start a todofinish_todo- Finish a todoclose_todo- Close a todoassign_todo- Assign todo to userbatch_create_todos- Create multiple todosbatch_edit_todos- Edit multiple todosbatch_finish_todos- Finish multiple todos- And more...
Personnel (5 tools)
get_accessible_personnel- Get accessible personnelget_personnel_invest- Get personnel investmentget_personnel_whitelist- Get personnel whitelistadd_personnel_whitelist- Add to whitelistunbind_personnel_whitelist- Remove from whitelist
Stakeholders (12 tools)
browse_stakeholders- Browse stakeholderscreate_stakeholder- Create a new stakeholderbatch_create_stakeholders- Create multiple stakeholdersedit_stakeholder- Edit an existing stakeholderdelete_stakeholder- Delete a stakeholderview_stakeholder- View stakeholder detailscommunicate_stakeholder- Communicate with stakeholderexpect_stakeholder- Set stakeholder expectations- And more...
Branches (8 tools)
manage_branches- Manage product branchescreate_branch- Create a new branchedit_branch- Edit an existing branchclose_branch- Close a branchactivate_branch- Activate a branchsort_branches- Sort branchesget_branches- Get branches listmerge_branch- Merge branches
Designs (15+ tools)
browse_designs- Browse design documentscreate_design- Create a new designbatch_create_designs- Create multiple designsview_design- View design detailsedit_design- Edit an existing designdelete_design- Delete a designassign_design- Assign design to userlink_commit_to_design- Link commit to design- And more...
Project Builds (12 tools)
browse_project_builds- Browse project buildscreate_project_build- Create a new project buildedit_project_build- Edit an existing buildview_project_build- View build detailsdelete_project_build- Delete a buildlink_story_to_project_build- Link story to buildlink_bug_to_project_build- Link bug to build- And more...
Executions (20+ tools)
browse_execution- Browse executionsget_execution_tasks- Get execution tasksget_execution_stories- Get execution storiesget_execution_bugs- Get execution bugsget_execution_builds- Get execution buildsget_execution_burn_chart- Get burn chartget_execution_cfd- Get cumulative flow diagramget_execution_kanban- Get kanban boardget_execution_team- Get execution teammanage_execution_members- Manage team memberslink_story_to_execution- Link story to execution- And more...
Kanban (30+ tools)
- Space management:
create_space,edit_space,delete_space - Board management:
create_kanban,edit_kanban,view_kanban - Region management:
create_region,edit_region,delete_region - Lane management:
create_lane,sort_lane,delete_lane - Column management:
create_column,split_column,archive_column - Card management:
create_card,edit_card,move_card,finish_card - Import/Export:
import_card,import_plan,import_release,import_build,import_execution - And more...
Epics (20+ tools)
create_epic- Create a new epicedit_epic- Edit an existing epicview_epic- View epic detailsdelete_epic- Delete an epiclink_story_to_epic- Link story to epiclink_requirement_to_epic- Link requirement to epicbatch_operations- Batch epic operations- And more...
Requirements (20+ tools)
create_requirement- Create a new requirementedit_requirement- Edit an existing requirementview_requirement- View requirement detailsdelete_requirement- Delete a requirementlink_story_to_requirement- Link story to requirementlink_requirement- Link related requirementsbatch_operations- Batch requirement operations- And more...
Spaces (3 tools)
browse_spaces- Browse spacescreate_application_space- Create application spaceget_store_app_info- Get store app information
Transfer (6 tools)
export_data- Export data from a moduleexport_template- Export import templateimport_data- Import data to a moduleget_import_table_body- Get import preview tableget_import_options- Get import field optionsvalidate_import_data- Validate import data
ZAI - ZenTao AI (6 tools)
get_zai_settings- Get ZAI module settingsupdate_zai_settings- Update ZAI settingsget_zai_token- Get AI authentication tokenget_vectorization_status- Get vectorization statusenable_vectorization- Enable vectorizationsync_vectorization- Sync vectorization data
AI - Artificial Intelligence (23 tools)
- Mini Programs:
get_mini_programs,publish_mini_program,unpublish_mini_program,import_mini_program - Prompts:
get_prompts,create_prompt,edit_prompt,delete_prompt,execute_prompt,publish_prompt - Prompt Configuration:
assign_prompt_role,select_prompt_data_source,set_prompt_purpose,set_prompt_target_form,finalize_prompt - Prompt Execution:
reset_prompt_execution,audit_prompt,get_testing_location - Role Templates:
get_role_templates - And more...
Tree (13 tools)
- Browse:
tree_browse,tree_browse_task - Edit & Fix:
tree_edit,tree_fix - Management:
tree_update_order,tree_manage_child,tree_delete,tree_view_history - Menus:
tree_ajax_get_option_menu,tree_ajax_get_drop_menu - Modules:
tree_ajax_get_modules,tree_ajax_get_son_modules - Create:
tree_ajax_create_module
Zanode - Node Management (27 tools)
- Node Management:
browse_zanodes,create_zanode,edit_zanode,view_zanode,get_zanodes - Lifecycle:
start_zanode,close_zanode,suspend_zanode,reboot_zanode,resume_zanode,destroy_zanode - VNC:
get_zanode_vnc- Get VNC access - Images:
create_zanode_image,get_zanode_images,get_zanode_image,update_zanode_image - Snapshots:
create_zanode_snapshot,edit_zanode_snapshot,delete_zanode_snapshot,browse_zanode_snapshots,restore_zanode_snapshot - Tasks & Services:
get_zanode_task_status,get_zanode_service_status,install_zanode_service - ZTF Scripts:
get_zanode_ztf_script,run_zanode_ztf_script - Instructions:
get_zanode_instructions
Case Library (15 tools)
get_caselib_index- Get case library indexcreate_caselib- Create a new case libraryedit_caselib- Edit an existing case librarydelete_caselib- Delete a case librarybrowse_caselib- Browse case library with filteringview_caselib- View case library detailscreate_caselib_case- Create a new test case in case librarybatch_create_caselib_cases- Create multiple test casesedit_caselib_case- Edit a test case in case librarybatch_edit_caselib_cases- Edit multiple test casesview_caselib_case- View test case detailsexport_caselib_template- Export import templateimport_caselib_cases- Import test cases to case libraryshow_caselib_import- Show import previewexport_caselib_cases- Export test cases from case library
QA (1 tool)
get_qa_index- Get QA module index
Test Report (5 tools)
browse_testreports- Browse test reports with filteringcreate_testreport- Create a new test reportedit_testreport- Edit an existing test reportview_testreport- View test report detailsdelete_testreport- Delete a test report
Test Suite (9 tools)
get_testsuite_index- Get test suite indexbrowse_testsuites- Browse test suites with filteringcreate_testsuite- Create a new test suiteview_testsuite- View test suite detailsedit_testsuite- Edit an existing test suitedelete_testsuite- Delete a test suitelink_case_to_testsuite- Link test case to test suiteunlink_case_from_testsuite- Unlink test case from test suitebatch_unlink_cases_from_testsuite- Unlink multiple test cases
Zanode - Node Management (27 tools)
- Node Management:
browse_zanodes,create_zanode,edit_zanode,view_zanode,get_zanodes - Lifecycle:
start_zanode,close_zanode,suspend_zanode,reboot_zanode,resume_zanode,destroy_zanode - VNC:
get_zanode_vnc- Get VNC access - Images:
create_zanode_image,get_zanode_images,get_zanode_image,update_zanode_image - Snapshots:
create_zanode_snapshot,edit_zanode_snapshot,delete_zanode_snapshot,browse_zanode_snapshots,restore_zanode_snapshot - Tasks & Services:
get_zanode_task_status,get_zanode_service_status,install_zanode_service - ZTF Scripts:
get_zanode_ztf_script,run_zanode_ztf_script - Instructions:
get_zanode_instructions
Case Library (15 tools)
get_caselib_index- Get case library indexcreate_caselib- Create a new case libraryedit_caselib- Edit an existing case librarydelete_caselib- Delete a case librarybrowse_caselib- Browse case library with filteringview_caselib- View case library detailscreate_caselib_case- Create a new test case in case librarybatch_create_caselib_cases- Create multiple test casesedit_caselib_case- Edit a test case in case librarybatch_edit_caselib_cases- Edit multiple test casesview_caselib_case- View test case details in case libraryexport_caselib_template- Export import templateimport_caselib_cases- Import test cases to case libraryshow_caselib_import- Show import previewexport_caselib_cases- Export test cases from case library
QA (1 tool)
get_qa_index- Get QA module index
Test Report (5 tools)
browse_testreports- Browse test reports with filteringcreate_testreport- Create a new test reportedit_testreport- Edit an existing test reportview_testreport- View test report detailsdelete_testreport- Delete a test report
Test Suite (9 tools)
get_testsuite_index- Get test suite indexbrowse_testsuites- Browse test suites with filteringcreate_testsuite- Create a new test suiteview_testsuite- View test suite detailsedit_testsuite- Edit an existing test suitedelete_testsuite- Delete a test suitelink_case_to_testsuite- Link test case to test suiteunlink_case_from_testsuite- Unlink test case from test suitebatch_unlink_cases_from_testsuite- Unlink multiple test cases
Resources (46 Total + 100 Templates)
Resources provide URI-based access to ZenTao data. All resources follow the pattern zentao://{entity}/{id} or zentao://{entity}/{id}/{subentity}.
Products
zentao://products- List of all productszentao://products/{id}- Individual product detailszentao://products/{id}/projects- Product projectszentao://products/{id}/stories- Product storieszentao://products/{id}/plans- Product planszentao://products/{id}/releases- Product releases
Projects
zentao://projects- List of all projectszentao://projects/{id}- Individual project detailszentao://projects/{id}/executions- Project executionszentao://projects/{id}/stories- Project storieszentao://projects/{id}/bugs- Project bugszentao://projects/{id}/builds- Project buildszentao://projects/{id}/releases- Project releaseszentao://projects/{id}/team- Project team
Programs
zentao://programs- List of all programszentao://programs/{id}- Individual program detailszentao://programs/{id}/products- Program productszentao://programs/{id}/projects- Program projectszentao://programs/{id}/stakeholders- Program stakeholders
Stories
zentao://stories/{id}- Individual story detailszentao://stories/{id}/tasks- Story taskszentao://stories/{id}/bugs- Story bugs
Tasks
zentao://tasks/{id}- Individual task details
Bugs
zentao://bugs/{id}- Individual bug details
Users
zentao://users- List of all userszentao://users/{id}- Individual user details
Test Tasks
zentao://testtasks- List of test taskszentao://testtasks/{id}- Individual test task details
Builds
zentao://builds/{id}- Individual build detailszentao://products/{id}/builds- Product buildszentao://projects/{id}/builds- Project buildszentao://executions/{id}/builds- Execution builds
Plans
zentao://plans/{id}- Individual plan details
Releases
zentao://projects/{id}/releases- Project releaseszentao://products/{id}/releases- Product releases
API Libraries
zentao://api-libs- List of API librarieszentao://api-libs/{libId}/releases- Library releaseszentao://api-libs/{libId}/structs- Library structureszentao://api-libs/{libId}/apis- Library APIszentao://api-libs/{libId}/apis/{apiId}- Individual API details
Entries
zentao://entries- List of entrieszentao://entries/{id}- Individual entry detailszentao://entries/{id}/log- Entry log
My Module
zentao://my/dashboard- User dashboardzentao://my/profile- User profilezentao://my/calendar- User calendarzentao://my/work/{mode}- User work itemszentao://my/todos- User todoszentao://my/stories- User storieszentao://my/tasks- User taskszentao://my/bugs- User bugszentao://my/projects- User projectszentao://my/executions- User executionszentao://my/team- User teamzentao://my/dynamic- User activity feed
Todos
zentao://todos- List of todoszentao://todos/{id}- Individual todo detailszentao://todos/{id}/detail- Todo detailed viewzentao://todos/status/{status}- Todos by statuszentao://todos/type/{type}- Todos by type
Personnel
zentao://personnel/accessible- Accessible personnelzentao://personnel/invest/{programID}- Personnel investmentzentao://personnel/whitelist/{objectID}/{module}/{objectType}- Personnel whitelist
Stakeholders
zentao://stakeholders- List of stakeholderszentao://stakeholders/{projectID}- Project stakeholderszentao://stakeholders/{stakeholderID}- Individual stakeholder details
Executions
zentao://executions- List of executionszentao://executions/{id}- Individual execution detailszentao://executions/{id}/tasks- Execution taskszentao://executions/{id}/stories- Execution storieszentao://executions/{id}/bugs- Execution bugszentao://executions/{id}/team- Execution teamzentao://executions/{id}/burn- Burn chartzentao://executions/{id}/cfd- Cumulative flow diagramzentao://executions/{id}/kanban- Kanban board
Kanban
zentao://kanban/spaces- List of kanban spaceszentao://kanban/spaces/{spaceID}- Space detailszentao://kanban/{kanbanID}- Kanban board detailszentao://kanban/{kanbanID}/regions/{regionID}- Region detailszentao://kanban/{kanbanID}/regions/{regionID}/lanes/{laneID}- Lane detailszentao://kanban/{kanbanID}/regions/{regionID}/lanes/{laneID}/columns/{columnID}- Column detailszentao://kanban/cards/{cardID}- Card detailszentao://kanban/{kanbanID}/regions/{regionID}/archived-cards- Archived cardszentao://kanban/{kanbanID}/regions/{regionID}/archived-columns- Archived columns
Epics
zentao://epics/{id}- Individual epic detailszentao://epics/{id}/stories- Epic storieszentao://epics/{id}/requirements- Epic requirementszentao://products/{id}/epics- Product epicszentao://projects/{id}/epics- Project epicszentao://executions/{id}/epics- Execution epics
Requirements
zentao://requirements/{id}- Individual requirement detailszentao://requirements/{id}/stories- Requirement storieszentao://requirements/{id}/linked-requirements- Linked requirementszentao://products/{id}/requirements- Product requirementszentao://projects/{id}/requirements- Project requirementszentao://executions/{id}/requirements- Execution requirements
Spaces
zentao://spaces- List of spaceszentao://spaces/{id}- Individual space detailszentao://spaces/{id}/applications/{appID}- Space application details
Transfer
zentao://transfer/modules- Supported transfer moduleszentao://transfer/{module}/export-template- Export template for modulezentao://transfer/{module}/import-status- Import status for modulezentao://transfer/exports- Export historyzentao://transfer/imports- Import history
ZAI
zentao://zai/settings- ZAI module settingszentao://zai/token- AI authentication tokenzentao://zai/vectorization/status- Vectorization status
AI
zentao://ai/admin- AI module admin overviewzentao://ai/mini-programs- List of mini programszentao://ai/prompts- List of promptszentao://ai/role-templates- Role templateszentao://ai/prompts/{id}- Individual prompt detailszentao://ai/mini-programs/{appID}- Mini program detailszentao://ai/prompts/published- Published promptszentao://ai/prompts/testing- Testing promptszentao://ai/mini-programs/published- Published mini programs
Zanode
zentao://zanode/instructions- Node management instructionszentao://zanode/nodes- List of all nodeszentao://zanode/nodes/{id}- Individual node detailszentao://zanode/nodes/{id}/vnc- Node VNC accesszentao://zanode/nodes/{id}/snapshots- Node snapshotszentao://zanode/nodes/{id}/tasks- Node taskszentao://zanode/hosts/{hostID}/nodes- Host nodes listzentao://zanode/hosts/{hostID}/images- Host images listzentao://zanode/hosts/{hostID}/services- Host service statuszentao://zanode/images/{imageID}- Image details
Case Library
zentao://caselibs- List of all case librarieszentao://caselibs/{libID}- Individual case library detailszentao://caselibs/{libID}/cases- Test cases in a case libraryzentao://caselibs/{libID}/cases/{caseID}- Individual test case in case library
QA
zentao://qa- QA module index
Test Report
zentao://testreports/{reportID}- Individual test report detailszentao://{objectType}/{objectID}/testreports- Test reports for a project, execution, or product
Test Suite
zentao://testsuites/{suiteID}- Individual test suite detailszentao://products/{productID}/testsuites- Test suites for a product
Prompts (2 Total)
MCP Prompts provide guided workflows for common operations:
-
create_product- Guided workflow for creating a new product- Required arguments:
name,code - Optional arguments:
program,line,PO,QD,RD,type,desc,acl
- Required arguments:
-
create_story- Guided workflow for creating a new user story- Required arguments:
title,product - Optional arguments:
module,plan,source,pri,estimate,spec,verify
- Required arguments:
Usage Examples
Using Tools
Create a new product:
{
"name": "create_product",
"arguments": {
"name": "My Product",
"code": "MP001"
}
}
Create a user story:
{
"name": "create_story",
"arguments": {
"title": "User login functionality",
"product": 1,
"pri": 1,
"spec": "Users should be able to login with email and password"
}
}
Using Resources
Access product details:
zentao://products/123
Access user's todos:
zentao://my/todos
Get project kanban board:
zentao://projects/456/kanban
Using Prompts
Get guided workflow for creating a product:
prompt://create_product?name=MyProduct&code=MP001
API Documentation
Complete ZenTao REST API documentation is available in the api_doc.txt file, which includes:
- 199+ API endpoints
- Request/response schemas
- Required vs optional parameters
- Example requests
- Coverage for all major modules:
- Products, Projects, Stories, Tasks, Bugs, Users
- Test Cases, Test Tasks, Test Reports, Test Suites
- Plans, Builds, Releases
- Kanban, Epics, Requirements
- Documentation Management
- Datatable and Reports
- Company, Department, Group and User Administration
- AI App and Mini Programs
- Business Intelligence (BI)
- And much more
Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE.md file for details.
Commercial licensing available upon request.
Contact
- Author: Bivex
- Email: support@b-b.top
- Website: https://contact.b-b.top
- GitHub: https://github.com/bivex
Keywords: ZenTao, MCP, Model Context Protocol, Project Management, Bug Tracking, Agile, Scrum, Kanban, Go, REST API, AI Integration, LLM, Claude, GPT, ZenTao API, Project Management System, Agile Development, Software Development, DevOps, CI/CD, Test Management, Requirement Management, Documentation Management, Business Intelligence, BI, Parquet, DuckDB, Administration, User Management, Department Management, Group Management, AI Apps, Mini Programs, Datatable, Reports