qa-touch-mcp

QA Touch 테스트 관리 API용 MCP(Model Context Protocol) 서버입니다. Claude와 같은 AI 어시스턴트가 QA Touch 도메인에서 프로젝트를 탐색하고, 테스트 이스를 관리하고, 테스트 실해을 진행하고, 결과를 기록하고, 결함을 등록할 수 있게 합니다.

요구사항

• Node.js 18+

• Professional 또는 Enterprise 요금제의 QA Touch 계정 (API는 해당 요금제에서만 사용 가능)

• API 토큰: QA Touch에서 프로필 → 프로필 편집 → API 키 생송으로 이동하세요.

Related MCP server: Testmo MCP Server

설정

서버는 전적으로 환경 변수를 통해 설정됩니다.

토큰은 QA Touch 도메인의 모든 데이터에 대한 접근 권한을 부여합니다. 버전 관리에 포함하지 마세요.

설치

Claude Code

claude mcp add qa-touch --env QATOUCH_DOMAIN=yourdomain --env QATOUCH_API_TOKEN=yourtoken -- npx qa-touch-mcp

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "qa-touch": {
      "command": "npx",
      "args": ["qa-touch-mcp"],
      "env": {
        "QATOUCH_DOMAIN": "yourdomain",
        "QATOUCH_API_TOKEN": "yourtoken"
      }
    }
  }
}

소스에서

npm install
npm run build
QATOUCH_DOMAIN=yourdomain QATOUCH_API_TOKEN=yourtoken node dist/index.js

도구 (32)

프로젝트 — list_projects, get_project, create_project

테스트 이스 및 모듈 — list_test_cases (승인 상태, 모듈, 모드 또는 요구사항으로 필터링), get_test_case, get_test_case_steps, list_modules, create_module, create_test_case (탐색형 / 텍스트 / BDD / 단계 템플릿), update_test_case, import_test_cases_csv

릴리스 및 계획 — list_releases, create_release, list_test_plans, list_workspaces

테스트 실해 및 결과 — list_test_runs, get_test_run, create_test_run (전체 이스 / 특징 이스 / 모듈별), clone_test_run, list_test_run_results (실행, 릴리스, 이력 또는 이스별), get_test_run_metadata, update_test_result, update_test_result_steps, bulk_update_test_results, update_test_results_mult, add_test_result (첨부 파일 포함)

결함 — list_defects, create_defect (첨부 파일 포함), get_defect_metadata

요구사항 — list_requirements, create_requirement_document, create_requirement

동작 참고

• 속도 제한: QA Touch는 분당 50건의 요청을 허용합니다. 서버는 클라인트 측에서 요청을 조절하고, 429 응답 시 Retry-After를 존중하여 한 번 재시도합니다.

• 페이지네이션: 목록 도구는 page 매개변수를 받습니다. QA Touch API는 1페에서 meta.current_page/last_page를 null로 반환합니다. 서버는 이를 정규화하고 has_next 플래그를 추가합니다.

• 첨부 파일: png, pdf, jpg, jpeg, gif, xls, xlsx, doc, docx, csv, log, zip, txt — 파일당 최대 2MB, 업로드 전에 검증됩니다.

• 일괄 처리 제한: 다중 케이스 상태 업데이트는 호출당 최대 20개 항목으로 제한됩니다. API가 URL에서 매개변수를 받고 너무 긴 URI를 거부하기 때문입니다.

개발

npm run build   # compile TypeScript
npm test        # run unit tests (vitest)

이 구현에 사용된 API 참조 노트: docs/qatouch-api-reference.md.