TestRail MCP 서버

대장간 배지

표준화된 프로토콜을 통해 TestRail의 핵심 엔터티와 상호 작용할 수 있는 TestRail용 MCP(모델 컨텍스트 프로토콜) 서버입니다.

특징

TestRail API를 통한 인증
TestRail 엔터티에 대한 액세스:
- 프로젝트
- 사례
- 실행
- 결과
- 데이터 세트
모델 컨텍스트 프로토콜에 대한 전체 지원
모든 MCP 클라이언트(Claude Desktop, Cursor, Windsurf 등)와 호환됩니다.

Related MCP server: JMeter MCP Server

Octomind MCP와 함께 실제 모습을 확인해 보세요.

비디오 제목

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 testrail-mcp를 자동으로 설치하려면:

지엑스피1

수동 설치

이 저장소를 복제하세요:
git clone https://github.com/yourusername/testrail-mcp.git cd testrail-mcp
가상 환경을 만들고 활성화하세요.
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
종속성 설치:
pip install -e .

구성

TestRail MCP 서버는 TestRail 인스턴스 인증을 위해 특정 환경 변수를 필요로 합니다. 이러한 변수는 서버를 실행하기 전에 설정해야 합니다.

프로젝트의 루트 디렉토리에 .env 파일을 만듭니다.
TESTRAIL_URL=https://your-instance.testrail.io TESTRAIL_USERNAME=your-email@example.com TESTRAIL_API_KEY=your-api-key
중요 참고 사항:
- TESTRAIL_URL TestRail 인스턴스의 전체 URL이어야 합니다(예: https://example.testrail.io ).
- TESTRAIL_USERNAME 은 로그인에 사용되는 TestRail 이메일 주소입니다.
- TESTRAIL_API_KEY 는 TestRail API 키입니다(비밀번호가 아님).
  - API 키를 생성하려면 TestRail에 로그인하고 "내 설정" > "API 키"로 이동하여 새 키를 생성하세요.
구성이 올바르게 로드되었는지 확인하세요.
uvx testrail-mcp --config
여기에는 URL, 사용자 이름, 검증을 위한 API 키의 처음 몇 글자를 포함한 TestRail 구성 정보가 표시됩니다.

Claude Desktop이나 Cursor와 같은 클라이언트와 함께 이 서버를 사용하는 경우, 서버를 실행하는 프로세스에서 환경 변수에 접근할 수 있는지 확인하세요. 이러한 변수를 시스템 환경에 설정하거나 .env 파일에서 로드해야 할 수도 있습니다.

용법

서버 실행

설치된 스크립트를 사용하여 서버를 직접 실행할 수 있습니다.

uvx testrail-mcp

이렇게 하면 MCP 서버가 stdio 모드로 시작되며, stdio 통신을 지원하는 MCP 클라이언트와 함께 사용할 수 있습니다.

MCP 클라이언트와 함께 사용

클로드 데스크탑

Claude Desktop에서 다음 구성으로 새 서버를 추가합니다.

{ "mcpServers": { "testrail": { "command": "uvx", "args": [ "testrail-mcp" ], "env": { "TESTRAIL_URL": "https://your-instance.testrail.io", "TESTRAIL_USERNAME": "your-email@example.com", "TESTRAIL_API_KEY": "your-api-key" } } } }

커서

커서에서 다음 구성으로 새 사용자 지정 도구를 추가합니다.

{ "name": "TestRail MCP", "command": "uvx", "args": [ "testrail-mcp" ], "env": { "TESTRAIL_URL": "https://your-instance.testrail.io", "TESTRAIL_USERNAME": "your-email@example.com", "TESTRAIL_API_KEY": "your-api-key" } }

윈드서핑

Windsurf에서 다음 구성으로 새 도구를 추가합니다.

{ "name": "TestRail MCP", "command": "uvx", "args": [ "testrail-mcp" ], "env": { "TESTRAIL_URL": "https://your-instance.testrail.io", "TESTRAIL_USERNAME": "your-email@example.com", "TESTRAIL_API_KEY": "your-api-key" } }

MCP Inspector로 테스트

테스트 및 디버깅을 위해 MCP Inspector를 사용할 수 있습니다.

npx @modelcontextprotocol/inspector \ -e TESTRAIL_URL=<your-url> \ -e TESTRAIL_USERNAME=<your-username> \ -e TESTRAIL_API_KEY=<your-api-key> \ uvx testrail-mcp

이렇게 하면 사용 가능한 모든 도구와 리소스를 탐색하고 테스트할 수 있는 웹 인터페이스가 열립니다.