TestRail MCP 서버

이 모델 컨텍스트 프로토콜(MCP) 서버는 Claude AI 및 Cursor와 같은 MCP 지원 클라이언트에서 TestRail과 직접 상호 작용할 수 있는 도구를 제공합니다. AI와의 대화를 벗어나지 않고도 테스트 케이스, 프로젝트, 스위트, 실행 등을 관리할 수 있습니다.

사용 가능한 도구

TestRail MCP 서버는 다음과 같은 도구를 제공합니다:

Related MCP server: TestRail MCP Server

사용법

아래와 같이 설정하여 이 MCP 서버를 연결할 수 있습니다. 이 방법은 npx를 사용하여 최신 버전의 패키지를 자동으로 다운로드하고 실행하므로 로컬 설치가 필요하지 않습니다.

// Example configuration using npx
{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["@bun913/mcp-testrail@latest"],
      "env": {
        "TESTRAIL_URL": "https://your-instance.testrail.io", // Replace with your TestRail URL
        "TESTRAIL_USERNAME": "your-email@example.com", // Replace with your TestRail username
        "TESTRAIL_API_KEY": "YOUR_API_KEY" // Replace with your TestRail API key
      }
    }
  }
}

문제 해결

• spawn node ENOENT 오류: Node.js가 올바르게 설치되어 있고 PATH에 있는지 확인하십시오.

• 인증 문제: TestRail API 자격 증명을 확인하십시오.

• 대화가 너무 긴 경우: 테스트 케이스 및 섹션에 limit 및 offset 매개변수를 사용하여 결과를 페이지화하십시오.

• 테스트 케이스 생성/업데이트 시 HTTP 400 오류: TestRail 프로젝트마다 템플릿, 사용자 정의 필드, 필수 필드가 다릅니다. 이 MCP 서버는 매개변수를 TestRail API로 직접 전달하며, 검증하거나 변환하지 않습니다. 400 오류가 발생하면 CLAUDE.md 또는 AGENTS.md에 프로젝트 규칙을 정의하여 LLM이 올바른 매개변수를 보내도록 하십시오. 예시:

  # TestRail Rules for This Project
  - Project ID: 1
  - Always use template 2 (Separated Steps) when creating test cases
    - Use `customStepsSeparated` (array of step objects)
    - Do NOT send `customSteps` or `customExpected` with template 2
  - Required custom fields: custom_automation_type (default: 0)
  - Call `getCaseFields` at the start of a session to check available fields

기여

기여를 환영합니다! 자유롭게 Pull Request를 제출해 주십시오.

감사의 말

• TestRail API

• Model Context Protocol SDK