Atlassian集成服务

"DCTC-123 이슈 내용 요약해줘"
"버그 이슈 하나 만들어줘: 로그인 실패 시 에러 메시지가 안 보임"
"Confluence에서 API 설계 문서 찾아줘"

# uv 설치 확인
uvx --version

# 미설치 시
brew install uv
# 또는
pip install uv

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@example.com",
        "JIRA_API_TOKEN": "YOUR_API_TOKEN",
        "CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

# 1. 패키지 실행 확인
uvx mcp-atlassian --help

# 2. API 인증 테스트
curl -s -o /dev/null -w "%{http_code}" \
  -u "your-email@example.com:YOUR_API_TOKEN" \
  "https://your-domain.atlassian.net/rest/api/2/myself"
# → 200이면 성공

# 3. Claude Code 재시작 후 MCP 서버 로드 확인
claude mcp list

# Jira 이슈 검색
"DCTC 프로젝트에서 최근 이슈 5개 보여줘"

# Confluence 페이지 검색
"DCT 스페이스에서 최근 문서 검색해줘"

# 이슈 조회
"DCTC-123 이슈 상세 내용 보여줘"
"DCTC-123의 현재 상태와 담당자 알려줘"

# 이슈 검색 (JQL)
"이번 스프린트에서 나에게 할당된 이슈 목록 보여줘"
"최근 일주일 내 생성된 버그 이슈 검색해줘"
"상태가 In Progress인 DCTC 프로젝트 이슈 찾아줘"

# 이슈 생성
"DCTC 프로젝트에 버그 이슈 생성해줘. 제목: 로그인 페이지 500 에러, 우선순위: High"
"Task 이슈 만들어줘 - API 엔드포인트 리팩토링"

# 이슈 수정 & 상태 변경
"DCTC-123 이슈 우선순위를 Critical로 변경해줘"
"DCTC-123을 In Progress로 변경해줘"
"DCTC-789 이슈 Done으로 완료 처리해줘"

# 댓글 추가
"DCTC-123에 댓글 달아줘: API 연동 테스트 완료, PR #45에서 확인 가능"

# 페이지 검색
"Confluence에서 'API 설계' 관련 문서 찾아줘"
"DCT 스페이스에서 온보딩 가이드 검색해줘"

# 페이지 조회
"페이지 ID 2472149700 내용 보여줘"

# 페이지 생성
"DCT 스페이스에 '2024 Q1 회고' 페이지 만들어줘"

# 페이지 수정
"해당 페이지에 '주의사항' 섹션 추가해줘"

# 개발 중 이슈 컨텍스트 로딩
"DCTC-200 이슈 내용 보고, 관련 코드 수정 사항 파악해줘"

# 이슈 기반 커밋 메시지 생성
"DCTC-200 이슈 제목을 기반으로 커밋 메시지 작성해줘"

# 작업 완료 후 자동화
"DCTC-200을 Done으로 바꾸고, '구현 완료 - PR #67' 댓글 달아줘"

# Confluence 문서 기반 코드 생성
"Confluence에서 DB 스키마 문서 찾아서 Prisma 모델 코드 생성해줘"

## Jira / Confluence 컨텍스트

- **Atlassian 도메인**: your-domain.atlassian.net
- **Jira 프로젝트 키**: PROJ
- **Jira 보드 ID**: 123
- **Confluence 스페이스 키**: TEAM
- **Confluence 홈페이지 ID**: 1234567890
- Jira 이슈 검색/생성 시 프로젝트 키 `PROJ`를 기본으로 사용
- Confluence 페이지 생성 시 스페이스 `TEAM`을 기본으로 사용
- 검색 결과 제한: 10건

"PROJ 프로젝트에서 이번 스프린트 이슈 찾아줘"

"이번 스프린트 이슈 보여줘"  ← 프로젝트 키 자동 적용

# uvx 확인
uvx --version

# 패키지 직접 실행 테스트
uvx mcp-atlassian --help

# uv 캐시 정리 후 재시도
uv cache clean

# 인증 테스트
curl -s -o /dev/null -w "%{http_code}" \
  -u "email:token" \
  "https://your-domain.atlassian.net/rest/api/2/myself"

# 401이면:
# - API 토큰 만료 여부 확인 (id.atlassian.com에서 재발급)
# - 이메일 주소 정확한지 확인
# - settings.json의 env 값에 따옴표/공백 오류 없는지 확인

# Claude Code 재시작 필요
# Ctrl+C → claude 재실행

# MCP 서버 목록 확인
claude mcp list