ZenTao MCP

ZenTao 개발 협업을 위한 MCP 서비스로, 디렉터 관점의 요구사항 분해, 실행 계획 및 작업량 할당 제안과 개발자 관점의 작업 및 Bug 워크플로우를 다룹니다.

현재 상태

현재 Phase 1 개발 단계로, 연결 진단 및 읽기 전용 조회 도구를 제공합니다:

• diagnose_connection

• list_projects

• list_executions

• list_products

• list_stories

• list_tasks

• list_execution_tasks

• list_my_tasks

• list_user_tasks

• list_bugs

• list_my_bugs

• list_user_bugs

• list_users

• get_task

• get_story

• get_bug

list_stories 및 list_bugs는 ZenTao 제품 ID를 제공해야 하며, 각각 제품 아래의 요구사항과 Bug에 접근합니다. Agent는 먼저 list_users를 호출한 후, 반환된 account를 사용하여 list_user_tasks 또는 list_user_bugs를 호출할 수 있으므로 사용자가 사용자 이름을 수동으로 입력할 필요가 없습니다.

쓰기 도구는 현재 기본적으로 계획만 생성하고 요청을 실행하지 않습니다. 명시적으로 confirm: true를 전달해야만 쓰기 요청이 전송됩니다:

• create_task

• assign_task

• start_task

• finish_task

• complete_task("1554를 완료로 표시"와 같은 자연어 지시에 적합)

• resolve_bug

테스트 및 일반 호출에서는 confirm: true를 사용해서는 안 됩니다.

Related MCP server: zentao-mcp-server

로컬 실행

Copy-Item .env.example .env
npm install
npm run check
npm test
npm run build
npm start

기본적으로 사용자 디렉터리의 ZenTao 연결 설정을 사용합니다: ~/.zentao-mcp/config.json(Windows의 경우 %USERPROFILE%\\.zentao-mcp\\config.json). 예시:

{
  "baseUrl": "https://your-zentao.example.com",
  "apiPath": "/zentao/api.php/v1",
  "token": "your-token",
  "timeoutMs": 10000
}

환경 변수 ZENTAO_CONFIG_FILE로 설정 파일 경로를 지정할 수 있으며, ZENTAO_* 변수는 고급 덮어쓰기/보완 방식으로만 사용됩니다. 실제 자격 증명을 저장소에 작성하지 마십시오.