Elevance MCP Atlassian - 독립 실행 패키지

AI 어시스턴트를 위한 Jira 및 Confluence 통합용 Model Context Protocol 서버입니다.

제공 기능

총 72개 도구:

• Jira 도구 48개 (검색, 생성, 업데이트, 상태 전환, 댓글 등)

• Confluence 도구 24개 (검색, 페이지, 댓글, 첨부 파일 등)

Related MCP server: Jira Cloud MCP Server

빠른 설정 (5분)

1. Personal Access Token(PAT) 생성

Jira 및 Confluence:

1. https://jira.elevancehealth.com에 로그인

2. 프로필 아이콘 → 프로필 클릭

3. "Personal Access Tokens"로 이동

4. "Create Token" 클릭

   • 이름: MCP Atlassian Integration

   • 만료: 1년

5. 토큰 복사 (한 번만 표시됩니다!)

2. 환경 구성

# Copy template
copy .env.template .env

# Edit .env and paste your PAT tokens
notepad .env

YOUR_JIRA_PAT_TOKEN_HERE 및 YOUR_CONFLUENCE_PAT_TOKEN_HERE를 실제 토큰으로 교체하세요.

3. 종속성 설치

# Option A: Using pip
pip install -r requirements.txt

# Option B: Install as package
pip install -e .

4. IDE 구성

Claude Desktop:

%APPDATA%\Claude\claude_desktop_config.json 편집:

{
  "mcpServers": {
    "elevance-atlassian": {
      "command": "python",
      "args": ["-m", "mcp_atlassian"],
      "cwd": "C:\\path\\to\\elevance-mcp-atlassian-standalone",
      "env": {
        "JIRA_URL": "https://jira.elevancehealth.com",
        "JIRA_PERSONAL_TOKEN": "YOUR_PAT_HERE",
        "CONFLUENCE_URL": "https://confluence.elevancehealth.com/",
        "CONFLUENCE_PERSONAL_TOKEN": "YOUR_PAT_HERE"
      }
    }
  }
}

Windsurf:

MCP 설정에 추가하거나 .env 파일 방식을 사용하세요(권장).

Cursor:

설정에서 MCP 구성에 추가하세요. 형식은 Claude Desktop과 동일합니다.

5. 연결 테스트

python validate_setup.py

모든 검사가 ✅로 표시되어야 합니다.

6. 사용 시작!

IDE를 다시 시작하고 AI 어시스턴트에게 다음과 같이 요청하세요:

• "내가 담당한 Jira 이슈 찾아줘"

• "Confluence에서 온보딩 문서 검색해줘"

• "XYZ 프로젝트에 버그 생성해줘"

• "PROJ-123 상태를 In Progress로 변경해줘"

• "현재 스프린트의 이슈 보여줘"

• "DEV 스페이스에서 페이지 내용 가져와줘"

사용 가능한 도구

Jira 도구 (48개)

검색 및 조회:

• jira_search - JQL로 이슈 검색

• jira_search_fields - 사용자 정의 필드 정의 조회

• jira_get_all_projects - 접근 가능한 프로젝트 목록

• jira_get_project_issues - 프로젝트의 모든 이슈 조회

이슈 관리:

• jira_get_issue - 이슈 상세 조회

• jira_create_issue - 새 이슈 생성

• jira_update_issue - 기존 이슈 업데이트

• jira_delete_issue - 이슈 삭제

• jira_batch_create_issues - 여러 이슈 일괄 생성

상태 및 워크플로:

• jira_transition_issue - 이슈 상태 변경

• jira_get_transitions - 사용 가능한 전환 조회

댓글:

• jira_add_comment - 이슈에 댓글 추가

• jira_edit_comment - 기존 댓글 수정

링크:

• jira_create_issue_link - 두 이슈 연결

• jira_remove_issue_link - 링크 제거

• jira_create_remote_issue_link - 웹 링크 생성

• jira_link_to_epic - 이슈를 에픽에 연결

• jira_get_link_types - 사용 가능한 링크 유형 조회

첨부 파일:

• jira_download_attachments - 이슈 첨부 파일 다운로드

• jira_get_issue_images - 이미지를 인라인 콘텐츠로 조회

감시자:

• jira_add_watcher - 이슈에 감시자 추가

• jira_remove_watcher - 감시자 제거

• jira_get_issue_watchers - 감시자 목록 조회

시간 추적:

• jira_add_worklog - 이슈에 작업 시간 기록

• jira_get_worklog - 작업 로그 항목 조회

애자일/스프린트:

• jira_get_agile_boards - 보드 목록 조회

• jira_get_board_issues - 보드의 이슈 조회

• jira_get_sprints_from_board - 스프린트 목록 조회

• jira_get_sprint_issues - 스프린트의 이슈 조회

• jira_create_sprint - 새 스프린트 생성

• jira_update_sprint - 스프린트 업데이트

• jira_add_issues_to_sprint - 스프린트에 이슈 추가

버전:

• jira_get_project_versions - 버전 목록 조회

• jira_create_version - 새 버전 생성

• jira_batch_create_versions - 여러 버전 일괄 생성

구성 요소:

• jira_get_project_components - 프로젝트 구성 요소 목록 조회

분석:

• jira_get_issue_dates - 날짜 정보 조회

• jira_get_issue_sla - SLA 지표 계산

• jira_batch_get_changelogs - 변경 이력 조회

개발 정보:

• jira_get_issue_development_info - PR, 커밋, 브랜치 조회

• jira_get_issues_development_info - 개발 정보 일괄 조회

고급:

• jira_get_user_profile - 사용자 정보 조회

• jira_get_field_options - 사용자 정의 필드 옵션 조회

• jira_get_issue_proforma_forms - ProForma 양식 조회

• jira_get_proforma_form_details - 양식 상세 조회

• jira_update_proforma_form_answers - 양식 답변 업데이트

서비스 데스크 (Server/DC 전용):

• jira_get_service_desk_for_project - 서비스 데스크 조회

• jira_get_service_desk_queues - 큐 목록 조회

• jira_get_queue_issues - 큐의 이슈 조회

Confluence 도구 (24개)

검색:

• confluence_search - CQL로 콘텐츠 검색

• confluence_search_user - 사용자 검색

페이지:

• confluence_get_page - 페이지 콘텐츠 조회

• confluence_create_page - 새 페이지 생성

• confluence_update_page - 페이지 업데이트

• confluence_delete_page - 페이지 삭제

• confluence_move_page - 페이지 이동

• confluence_get_page_children - 하위 페이지 조회

• confluence_get_page_history - 페이지 버전 조회

• confluence_get_page_diff - 버전 비교

댓글:

• confluence_add_comment - 댓글 추가

• confluence_reply_to_comment - 댓글에 답글

• confluence_get_comments - 페이지 댓글 조회

첨부 파일:

• confluence_get_attachments - 첨부 파일 목록 조회

• confluence_upload_attachment - 파일 업로드

• confluence_upload_attachments - 여러 파일 업로드

• confluence_download_attachment - 파일 다운로드

• confluence_download_content_attachments - 모든 첨부 파일 다운로드

• confluence_delete_attachment - 첨부 파일 삭제

이미지:

• confluence_get_page_images - 이미지를 인라인 콘텐츠로 조회

레이블:

• confluence_get_labels - 콘텐츠 레이블 조회

• confluence_add_label - 레이블 추가

분석:

• confluence_get_page_views - 조회 통계 조회

문제 해결

"Module not found" 오류

pip install -e .

"Authentication failed" 오류

• PAT 토큰이 유효하고 만료되지 않았는지 확인

• 토큰이 취소되지 않았는지 확인

• 올바른 URL(https://jira.elevancehealth.com)인지 확인

• 토큰 재생성 시도

SSL 인증서 오류

.env 파일에 추가:

JIRA_SSL_VERIFY=false
CONFLUENCE_SSL_VERIFY=false

연결 테스트 실패

# Test if Python can import the module
python -c "import mcp_atlassian; print('OK')"

# Check MCP version
python -m mcp_atlassian --version

검증 실행 시 "No such file or directory" 오류

올바른 디렉터리에 있는지 확인하세요:

cd C:\path\to\elevance-mcp-atlassian-standalone
python validate_setup.py

IDE에 도구가 표시되지 않음

1. IDE 구성 경로가 올바른지 확인

2. IDE를 완전히 다시 시작

3. IDE 로그에서 MCP 연결 오류 확인

4. .env 또는 IDE 구성에서 TOOLSETS=all 확인

보안 모범 사례

• ✅ .env 파일을 비공개로 유지

• ✅ PAT 토큰을 다른 사람과 공유하지 않음

• ✅ 토큰을 6~12개월마다 교체

• ✅ .env를 버전 관리에 커밋하지 않음

• ✅ 추적을 위해 강력한 토큰 이름 사용

• ✅ 더 이상 필요하지 않으면 토큰 취소

고급 구성

특정 프로젝트로 필터링

.env에서:

JIRA_PROJECTS_FILTER=PROJ1,PROJ2,PROJ3
CONFLUENCE_SPACES_FILTER=SPACE1,SPACE2,SPACE3

상세 로깅 활성화

.env에서:

MCP_VERBOSE=true
MCP_VERY_VERBOSE=true  # Debug level

읽기 전용 모드 (테스트)

.env에서:

READ_ONLY_MODE=true

이 모드는 모든 쓰기 작업(생성, 업데이트, 삭제)을 방지합니다.

사용자 정의 도구 세트

.env에서:

# Only core tools
TOOLSETS=default

# Specific toolsets
TOOLSETS=default,jira_agile,jira_analytics

# Specific tools only
ENABLED_TOOLS=jira_search,jira_get_issue,confluence_search

시스템 요구 사항

• Python: 3.10 이상

• 운영 체제: Windows, macOS 또는 Linux

• 네트워크: jira.elevancehealth.com에 접근 가능

• IDE: MCP를 지원하는 Claude Desktop, Cursor 또는 Windsurf

패키지 구성 요소

elevance-mcp-atlassian-standalone/
├── src/mcp_atlassian/       # Complete MCP implementation
│   ├── jira/                # 48 Jira tools
│   ├── confluence/          # 24 Confluence tools
│   ├── models/              # Data models
│   ├── servers/             # MCP server logic
│   └── utils/               # Utilities
├── .env.template            # Configuration template
├── requirements.txt         # Python dependencies
├── pyproject.toml          # Package metadata
├── validate_setup.py       # Setup validation script
├── README.md               # This file
├── SETUP-GUIDE.md          # Detailed setup instructions
└── LICENSE                 # MIT License

지원

문제나 질문이 있으면 연락하세요:

• 개발자: Mohamed Wasim

• 이메일: Mohamed.Wasim@carelon.com

다음 단계

1. ✅ 위 단계를 사용하여 설정 완료

2. ✅ 검증 실행: python validate_setup.py

3. ✅ IDE 구성

4. ✅ IDE 다시 시작

5. ✅ Jira/Confluence와 함께 AI 어시스턴트 사용 시작

추가 자료

• SETUP-GUIDE.md - 스크린샷 설명이 포함된 상세 단계별 가이드

• 원본 문서 - https://mcp-atlassian.soomiles.com

라이선스

MIT 라이선스 - Elevance Health/Carelon 내부용

버전: 1.0
최종 업데이트: 2026년 3월
유지 관리: Carelon Global Solutions