본문 바로가기
카테고리 없음

AI [MCP : Jira MCP 사용 가이드]

세모난 야구공 2025. 12. 13. 14:08

TL;DR

Jira MCP 사용 가이드 (Claude Code 기준)

1. 들어가며

최근 LLM을 개발 업무에 적극적으로 활용하는 흐름 속에서,

외부 시스템의 데이터를 안전하게 연결하는 방식이 중요해지고 있습니다.

Atlassian은 Jira와 Confluence 데이터를 LLM과 연결하기 위해

Model Context Protocol(MCP) 기반의 공식 Remote MCP Server를 제공합니다.

이 글에서는 Claude Code 환경에서 Jira MCP를 설치하고,

실제로 사용할 수 있는 기능과 사용 방법, 그리고 실무에서 주의해야 할 점을 정리합니다.

2. MCP와 Jira MCP 개요

2.1 MCP란 무엇인가

MCP(Model Context Protocol)는

외부 시스템의 데이터를 LLM이 이해할 수 있는 표준 인터페이스로 제공하기 위한 프로토콜입니다.

이를 통해 LLM은:

  • 별도의 API 구현 없이
  • 안전한 인증 절차를 거쳐
  • 외부 시스템의 컨텍스트를 활용할 수 있습니다.

2.2 Atlassian Jira MCP의 특징

Atlassian Jira MCP는 다음 특징을 가집니다.

  • Atlassian 공식 Remote MCP Server 제공
  • Server-Sent Events(SSE) 기반 통신
  • OAuth 인증 방식 사용
  • Jira / Confluence 데이터 조회 및 요약 지원
  • 로컬 MCP 서버 구성 불필요

즉, 가장 안정적이고 유지보수 부담이 적은 방식입니다.

3. 사전 준비 사항

3.1 필수 조건

  • Jira Cloud 계정
  • Jira 프로젝트 접근 권한
  • Claude Code 설치 환경
  • 브라우저 OAuth 인증 가능 환경

별도의 API 토큰 생성은 필요하지 않습니다.

3.2 권한 관련 주의사항

최소 권한 원칙을 권장합니다.

  • 기본적으로 이슈 조회 권한만 있어도 충분합니다.
  • 관리자 권한 계정으로 연결하는 것은 지양해야 합니다.

4. Claude Code에 Jira MCP 설치

4.1 Claude Code 설치 확인

먼저 Claude Code가 정상 설치되어 있는지 확인합니다.

claude version

MCP 기능이 포함된 최신 버전을 사용하는 것이 좋습니다.

4.2 Jira MCP 서버 등록

다음 명령어로 Atlassian 공식 Remote MCP Server를 등록합니다.

claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sse

각 요소의 의미는 다음과 같습니다.

  • mcp add : MCP 서버 등록
  • -transport sse : SSE 기반 통신 사용
  • atlassian : MCP 서버 별칭
  • URL : Atlassian 공식 MCP 엔드포인트

4.3 OAuth 인증

명령어 실행 후 /mcp 로 접근하여 atlassian을 들어갈 경우 브라우저가 열리며 Atlassian OAuth 인증이 진행됩니다.

  • Atlassian 계정 로그인
  • Jira 접근 권한 승인
  • 인증 완료 시 Claude Code에 자동 저장

4.4 연결 확인

다음 명령어로 MCP 등록 여부를 확인합니다.

claude mcp list

정상적으로 등록되었다면 다음과 같이 표시됩니다.

atlassian (sse) https://mcp.atlassian.com/v1/sse

5. 보안 및 운영 관점 주의사항

5.1 권한 관리

  • 관리자 계정 사용 금지
  • 서비스 계정 또는 개인 계정 사용
  • 프로젝트 접근 범위 제한

5.2 변경 작업 주의

  • 이슈 상태 변경은 테스트 프로젝트에서 먼저 검증
  • 운영 환경에서는 사람이 최종 확인하는 프로세스 필요

LLM은 보조 도구이지, 최종 결정자가 아닙니다.

6. 확장 활용 아이디어

  • 매일 스탠드업 리포트 자동 생성
  • Sprint 종료 시 릴리즈 노트 자동 요약
  • PR 생성 시 관련 Jira 이슈 요약

CI/CD 파이프라인과 연계하면 반복 업무를 줄일 수 있습니다.

7. 마치며

Jira MCP는 LLM을 단순한 대화 도구가 아닌 업무 컨텍스트를 이해하는 실질적인 보조 도구로 확장시켜 줍니다.

Claude Code + Atlassian 공식 MCP 조합은 설정이 단순하면서도 안정성이 높아 실무 적용에 적합합니다.

다만, 조회와 요약 중심으로 시작하고, 변경 작업은 신중하게 도입하는 접근이 필요합니다.

참고 자료

티스토리툴바