Atlassian MCP 서버 완벽 가이드: Jira·Confluence를 Claude에 연결 (2026)

사내 Jira 티켓을 매일 50개씩 확인하고 Confluence 문서를 찾아 헤매는 일이 일상이라면, 이제 Claude에게 자연어로 시킬 차례다. Atlassian이 2026년 정식 공개한 Atlassian MCP 서버(Rovo MCP)는 Jira·Confluence Cloud를 Claude Desktop·Claude Code와 직접 연결하는 공식 채널이다. 실제로 사내 Atlassian Cloud 환경에서 셋업해본 결과, OAuth 흐름과 권한 스코프만 잡으면 10분 내로 동작한다.

📌 핵심 3줄 요약

• Atlassian 공식 Remote MCP 엔드포인트는 https://mcp.atlassian.com/v1/sse이며 OAuth 2.0으로 인증한다.
• Claude Desktop은 claude_desktop_config.json, Claude Code는 claude mcp add 한 줄로 등록할 수 있다.
• 한국 기업 환경에서는 SSO·프록시·데이터 거주성 이슈가 가장 흔한 막힘 지점이다.

1. Atlassian MCP 서버란 무엇인가

MCP(Model Context Protocol)는 Anthropic이 2024년 11월 공개한 표준으로, LLM이 외부 도구와 상호작용하는 방식을 통일한 규격이다. Atlassian Rovo MCP 서버는 그 표준을 따르는 공식 구현체로, Jira Cloud의 이슈 CRUD, JQL 검색, Confluence 페이지 조회·생성·검색을 도구(tool)로 노출한다.

기존에는 커뮤니티가 만든 비공식 래퍼나 자체 API 키 기반 스크립트를 써야 했다. 공식 서버가 나오면서 OAuth 토큰 회전, 사이트 ID 자동 탐지, 권한 스코프 분리 같은 엔터프라이즈 요구사항이 한 번에 해결된다. Atlassian Cloud(Free·Standard·Premium·Enterprise) 사용자라면 추가 비용 없이 활용 가능하다.

2. 설치 전 준비물 체크리스트

• Atlassian Cloud 계정: Jira Cloud 또는 Confluence Cloud 워크스페이스 (Data Center·Server 버전은 미지원).
• 워크스페이스 내 Browse Projects·Create Issues 권한. 관리자 권한이 아니어도 본인 권한 내에서만 동작.
• Node.js 18 이상 (Claude Desktop은 별도 런타임 불필요, Claude Code는 npx 호출용).
• Claude Desktop 0.10 이상 또는 Claude Code 최신 빌드. MCP 지원은 두 클라이언트 모두 GA 상태.
• 회사망에서 mcp.atlassian.com·auth.atlassian.com 도메인 아웃바운드 HTTPS 허용.

3. Claude Desktop 설정 (claude_desktop_config.json)

Claude Desktop은 Remote MCP를 직접 지원한다. 설정 파일 위치는 macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json이다.

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

파일을 저장하고 Claude Desktop을 재시작하면 첫 호출 시 브라우저가 열리면서 OAuth 인증 동의 화면이 뜬다. 접근할 사이트(your-org.atlassian.net)와 스코프(read·write·search)를 선택하면 토큰이 OS 키체인에 저장된다.

4. Claude Code 설정 (claude mcp add)

Claude Code는 CLI 한 줄로 끝난다. 터미널에서 다음을 실행한다.

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

등록 후 claude mcp list로 상태를 확인하고, 첫 사용 시 OAuth 디바이스 코드가 표시된다. 브라우저에서 코드를 입력하면 인증이 완료된다. 수동으로 JSON을 편집하려면 ~/.claude/mcp.json에 같은 구조를 추가해도 된다.

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

5. OAuth 인증과 사이트·스코프 확인

인증이 끝나면 Claude는 토큰에 묶인 모든 Atlassian 사이트에 접근할 수 있다. 다중 워크스페이스를 쓰는 조직이라면 첫 질의에서 사이트 ID를 명시하는 편이 안전하다.

스코프	권한 범위	권장 시나리오
read:jira-work	이슈 조회·JQL 검색	읽기 전용 대시보드
write:jira-work	이슈 생성·상태 변경	자동 티켓 등록
read:confluence-content.all	페이지·블로그 조회	사내 위키 검색
write:confluence-content	페이지 생성·수정	회의록 자동 작성

사이트 ID는 https://your-org.atlassian.net/_edge/tenant_info에서 cloudId 필드로 확인할 수 있다. 운영 정책상 최소 권한 원칙을 적용해 읽기 전용으로 먼저 검증한 뒤 쓰기 스코프를 열어두는 편이 안전하다.

6. 실전 사용 시나리오 5가지

인증이 끝났다면 Claude 채팅창에 자연어로 바로 시킬 수 있다. 실제 업무에서 자주 쓰는 패턴은 다음과 같다.

1. 이슈 상태 조회 — "JIRA-1234 이슈 지금 상태랑 담당자 알려줘"
2. 스프린트 요약 — "현재 진행 중인 스프린트에서 In Progress 상태인 내 이슈 전부 한 줄로 요약해줘"
3. JQL 자연어 검색 — "최근 7일간 priority가 High이고 미해결인 버그 이슈 10개 보여줘"
4. Confluence 검색 — "배포 절차 관련된 Confluence 페이지 찾아서 핵심만 정리해줘"
5. 이슈 자동 생성 — "방금 회의록 내용으로 PROJ 프로젝트에 Task 이슈 3개 만들어줘. 담당자는 모두 나로"

5번 시나리오처럼 쓰기 동작은 Claude가 실행 직전 사용자 승인을 요구한다. 잘못된 자동화로 티켓이 폭증하는 사고를 막는 안전장치다.

7. 한국 기업 환경 트러블슈팅

실제로 SI·핀테크 환경에서 막히는 지점은 정해져 있다.

• SSO·SAML 강제 조직: Atlassian Access·Guard로 IdP(Okta·Azure AD) SSO를 강제한 경우, 처음 OAuth 흐름에서 IdP 로그인 페이지로 리다이렉트된다. 사내망 PC가 IdP에 접근 가능한지 먼저 확인.
• 회사 프록시·방화벽: mcp.atlassian.com이 SSE(Server-Sent Events) 장기 연결을 요구한다. 일부 SWG·DLP 솔루션이 60초 idle로 끊는다면 예외 정책 등록이 필요.
• 데이터 거주성: Atlassian Cloud의 데이터 거주성이 EU·US로 묶여 있어도 MCP 서버 자체는 같은 리전을 경유한다. 한국 데이터 거주성 옵션은 2026년 6월 현재 미지원이라 보안팀 사전 협의가 필요.
• 403 Forbidden: 이슈는 보이는데 생성이 안 되면 스코프가 read만 부여된 경우다. 토큰을 폐기하고 write 스코프 재동의 필요.
• 다중 사이트 혼선: 한 계정이 여러 cloudId에 묶여 있으면 Claude가 엉뚱한 사이트를 호출한다. 프롬프트에 사이트 도메인을 명시하거나 mcp.json에 --site 파라미터를 추가.

⚠️ 단점과 주의할 점

• Cloud 전용 — Atlassian Data Center·Server 사용 조직은 자체 MCP 래퍼를 구축해야 한다.
• 토큰이 OS 키체인에 평문 저장 가까운 형태로 보관되므로 공용 PC에는 비추천.
• Rovo MCP의 도구 응답은 토큰 비용에 그대로 잡힌다. 대용량 페이지 조회는 비용이 빠르게 누적.

FAQ

Q. Atlassian MCP 서버는 무료인가?
Atlassian Cloud 라이선스에 포함되어 별도 과금은 없다. Claude 사용 토큰만 별도 비용.

Q. API 토큰 방식 대신 OAuth만 지원하나?
공식 Remote MCP는 OAuth 2.0만 지원한다. API 토큰을 쓰려면 비공식 커뮤니티 MCP를 사용.

Q. Confluence 페이지를 LLM이 검색할 수 있나?
가능하다. CQL 기반 검색과 페이지 본문 조회가 도구로 제공된다.

Q. Claude 외 다른 LLM에도 붙일 수 있나?
MCP 표준을 지원하는 클라이언트라면 모두 가능. Cursor·Windsurf·Continue도 동일 URL로 동작.

Q. 회사 보안팀이 막는다면?
OAuth 스코프 단위로 권한이 분리되고 감사 로그가 Atlassian Admin에 남는다는 점을 어필하면 대부분 통과한다.

🚀 지금 바로 할 일

1. Atlassian Cloud 계정과 워크스페이스 권한을 점검한 뒤 Claude Desktop 또는 Claude Code를 최신 버전으로 업데이트.
2. 위 JSON 설정을 붙여넣거나 claude mcp add로 서버를 등록하고 OAuth 동의를 완료.
3. 읽기 전용 스코프로 JQL 자연어 질의를 먼저 검증한 뒤 쓰기 작업을 단계적으로 허용.

💬 의견

사내에서 Jira·Confluence를 Claude와 어떻게 활용하고 있는지 댓글로 공유 부탁드립니다.

참고 자료

• Atlassian Remote MCP Server 공식 발표
• Atlassian Rovo MCP 공식 문서
• Model Context Protocol 스펙
• Claude Code MCP 공식 가이드
• Atlassian OAuth 2.0 3LO 개발자 문서