AI 지원 테스트: Atlassian 도구와 MCP를 활용한 구현 생존 가이드
카테고리
프로그래밍/소프트웨어 개발
서브카테고리
DevOps
대상자
소프트웨어 개발자, QA 엔지니어, DevOps 엔지니어
- 난이도: 중간 (Docker와 Atlassian API 경험 필요)
- 주요 기술 스택: Docker, Amazon Q CLI, Atlassian Jira, Confluence
핵심 요약
- MCP (Model Context Protocol)는 Atlassian 도구와 직접 통합하여 테스트 자동화를 가능하게 함
JIRA_URL
,JIRA_PAT
등.env
파일을 통해 인증 정보 설정- SSL_VERIFY=true 설정으로 보안 강화 (기업 환경에서 필수)
- Docker 이미지 기반 구축:
mcp-atlassian-with-zscaler
커스텀 이미지 생성 docker build -t mcp-atlassian-with-zscaler .
명령어 사용- Amazon Q CLI 활용:
q chat
명령어로 MCP 서버 연결 및 테스트 생성 What tests should I do for
와 같은 쿼리로 테스트 생성 가능
섹션별 세부 요약
1. MCP 구현의 핵심 이점
- 직접 통합: 복사-붙여넣기 없이 Atlassian 도구와 연결
- 맥락 인식: 프로젝트별 구조 이해 (예:
Jira
티켓,Confluence
스펙 분석) - 패턴 학습: 팀의 테스트 프레임워크에 맞춤화
2. 인프라 설정 및 구성
- Docker 설치:
https://docs.docker.com/get-docker
에서 설치 - Docker Desktop 또는 Engine 모두 지원
- SSL 인증서 처리:
.crt
,.pem
,.cer
파일을CERT_PATH
에 등록- 경고:
SSL_VERIFY=false
는 보안 취약, 실무에서는 절대 사용 금지
3. 환경 변수 설정
.env-example
파일 복사 후 다음과 같이 구성:
```bash
JIRA_URL=https://yourcompany.atlassian.net
JIRA_PAT=your-personal-access-token
CONFLUENCE_URL=https://yourcompany.atlassian.net
CONFLUENCE_PAT=your-confluence-token
SSL_VERIFY=true
CERT_PATH=/path/to/certs
```
- 필수:
SSL_VERIFY=true
로 설정하고, 경로는 실제 인증서 위치와 일치
4. Docker 이미지 빌드 및 실행
- 커스텀 이미지 생성:
```bash
docker build -t mcp-atlassian-with-zscaler .
```
- Zscaler 등 기업 인증서 사용 시 프로젝트 루트에 인증서 파일 배치
- MCP 서버 실행:
```bash
q chat
```
- 자동으로
.amazonq/mcp.json
파일에서 설정 읽음 - 결과 예시:
```bash
✓ mcp_atlassian loaded in 2.40 s
✓ 2 of 2 mcp servers initialized.
```
5. 실무 활용 예시
- Jira 티켓 기반 테스트 생성:
```bash
What tests should I do for PROJ-12345?
```
- Confluence 스펙 분석:
```bash
In the spec CONF-789, section 1.8.5, what edge cases should I consider?
```
- 요구사항 격차 분석:
```bash
For ticket XYZ-123 and the spec CONF-789, are there any missing requirements?
```
결론
- MCP 구현 시 주요 팁:
- SSL_VERIFY=true로 설정하고, 기업 인증서를 반드시 등록
.env
파일의 URL은 기초 URL만 입력 (예:https://yourcompany.atlassian.net
)- Amazon Q CLI의
q chat --resume
명령어로 이전 대화 기록 활용 가능 - Docker 이미지 빌드 실패 시: 인증서 누락 또는 네트워크 문제 확인 후 재시도