[Claude Code] jira / confluence Atlassian MCP 설정하기

MCP?

AI 모델이 외부 도구를 호출할 수 있게 해주는 표준 프로토콜이다.
Claude Code에 Atlassian MCP를 붙이면, 터미널에서 Jira·Confluence를 자연어로 조작할 수 있다.

---

1. 설정

사전 준비

• Atlassian Cloud 계정
• Claude Code

MCP 서버 등록

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

 

옵션 의미

 

--transport sse	SSE 방식 통신
--scope user	~/.claude/mcp.json에 글로벌 저장
atlassian	서버 이름

 

scope 사용 가능 옵션

user	내 로컬 머신 전체에서 사용 (기본값)	~/.claude/
local	현재 프로젝트 디렉토리에서만 사용	.claude/ (gitignore 대상)
project	프로젝트 팀원과 공유	.mcp.json (git 커밋 대상)

 

개인적으로 쓸 거라면 user, 팀 전체가 동일한 MCP 환경을 공유해야 한다면 project scope가 적합하다.

# 프로젝트 팀원과 공유하고 싶은 경우
cd /path/to/your/project
claude mcp add atlassian --transport sse "https://mcp.atlassian.com/v1/sse" --scope project

 

명령어 실행시 mcp.json 에는 자동으로 아래와 같이 들어간다:

{
  "mcpServers": {
    "atlassian": {
      "type": "sse",
      "url": "https://mcp.atlassian.com/v1/sse"
    }
  }
}

 

2. 등록 확인

claude mcp list

 

atlassian이 목록에 보이면 등록 완료다.

 

3. 인증

Claude Code 실행하면 브라우저가 열리면서 OAuth 인증을 탄다.
로그인하고 권한 허용하면 끝. API 토큰 발급 같은 건 필요 없다.

확인

Claude Code에서 /mcp 치면 연결 상태 확인 가능.

---

공식 vs 커뮤니티

@aashari/mcp-server-atlassian-jira 같은 커뮤니티 npm 패키지도 있다.

 

	공식 Rovo MCP	커뮤니티 npm
인증	OAuth 자동	API Token 수동 발급
범위	Jira + Confluence + Compass 통합	제품별 별도 설치
업데이트	서버사이드 자동	npm 수동
보안	세션 기반 토큰	평문 API Token 환경변수

 

-> 공식 쓰는 것을 권장한다.

---

사용 예시

"PROJ-123 티켓 내용 보여줘"
"이번 스프린트에서 나한테 할당된 이슈 찾아줘"
"PROJ-456 위키 문서 읽고 요구사항대로 구현해줘"

 

코드 작업하면서 티켓 확인하고, 끝나면 댓글 남기고, 문서 업데이트까지 터미널 하나에서 된다.

---

주의

• 베타 서비스
• Cloud 전용 (Server/Data Center 미지원)
• 본인 계정 권한 범위 내에서만 접근 가능
• 사이트 최초 연결 시 관리자 승인 필요할 수 있음