Atlassian MCP Server

공식

Atlassian 제품의 AI 에이전트를 Jira, Confluence, Opsgenie 및 기타 Atlassian 제품에 연결하기 위한 공식 Atlassian MCP 서버입니다.

GitHub

이 MCP 사용해 보기스폰서

Atlassian MCP(으)로 무엇을 할 수 있나요?

Atlassian 제품 전반 검색 — 자연어 질의로 Jira 이슈, Confluence 페이지 또는 Bitbucket 콘텐츠를 찾도록 어시스턴트에게 요청하세요.
작업 항목 생성 및 업데이트 — AI가 지시에 따라 Jira 스토리를 만들거나, 이슈를 업데이트하거나, Confluence 페이지를 생성하게 하세요.
대량 이슈 생성 — 회의 노트나 사양을 한 번의 요청으로 여러 Jira 티켓으로 전환하세요.
Confluence 콘텐츠 요약 — Confluence를 열지 않고도 Q2 계획 문서와 같은 페이지의 간결한 요약을 얻으세요.
Compass 구성 요소 조회 — "api-gateway 서비스에 의존하는 것은 무엇인가요?"와 같은 서비스 종속성에 대해 질문하세요.
관련 콘텐츠 연결 — 세 개의 이슈를 릴리스 계획에 연결하는 등 Jira 티켓을 Confluence 페이지에 연결하세요.

문서

Atlassian

Atlassian Rovo MCP Server

Atlassian 공식 Model Context Protocol(MCP) 서버: AI 도구에 Jira, Confluence, Jira Service Management, Bitbucket, Compass에 대한 안전한 실시간 액세스를 제공하는 클라우드 호스팅 브리지입니다.

시작하기 · 지원 도구 · 보안 및 관리 · 커뮤니티

공식 Atlassian Rovo MCP Server는 Atlassian Cloud 사이트와 호환되는 외부 도구 간의 클라우드 기반 브리지입니다. 구성이 완료되면 해당 도구가 Jira, Confluence, Jira Service Management, Bitbucket, Compass 데이터와 실시간으로 상호 작용할 수 있습니다. 인증은 OAuth 2.1 또는 API 토큰을 사용하므로 모든 작업이 사용자의 기존 액세스 제어를 준수합니다.

Atlassian Rovo MCP Server를 사용하면 다음을 수행할 수 있습니다.

도구를 전환하지 않고 Jira, Confluence, Jira Service Management, Bitbucket 콘텐츠를 요약하고 검색할 수 있습니다.
자연어 명령을 기반으로 이슈 또는 페이지를 생성하고 업데이트할 수 있습니다.
회의 노트나 사양에서 티켓을 생성하는 등 반복 작업을 자동화할 수 있습니다.

IDE나 AI 도구에서 작업하면서 컨텍스트를 계속 전환하지 않고 Atlassian 데이터를 사용하려는 개발자, 콘텐츠 제작자, 프로젝트 팀을 위해 설계되었습니다.

원클릭 설정

아래에서 AI 클라이언트를 선택하여 공식 Atlassian Rovo MCP Server를 설치하세요. 각 버튼은 클라이언트의 기본 설치 링크를 사용하므로 JSON 구성을 수동으로 편집할 필요가 없습니다.

Cursor에 추가
_{코드베이스에서 이슈를 참조하고 작업 시간을 기록하세요.}

VS Code에 추가
_{GitHub Copilot으로 Jira 이슈를 검색하고 생성하세요.}

ChatGPT에 추가
_{ChatGPT에서 바로 검색, 요약, 생성하세요.}

Claude에 추가
_{Jira와 Confluence를 Claude 워크플로에 통합하세요.}

지원 클라이언트

Atlassian Rovo MCP Server는 점점 늘어나는 MCP 호환 클라이언트 목록과 함께 작동합니다:

클라이언트	설정 참조
OpenAI ChatGPT	커넥터 / MCP 가이드
Claude (Claude.ai, Desktop, Code)	Claude MCP 문서
Cursor	Cursor 마켓플레이스의 Atlassian
Visual Studio Code (GitHub Copilot)	VS Code MCP 문서
GitHub Copilot CLI	Copilot CLI 정보
Google Gemini CLI	Gemini CLI MCP 문서
Kiro 및 기타 Agent Plugins 클라이언트	Kiro Powers 문서
Amazon Quick Suite	MCP 통합 가이드

Atlassian Rovo MCP Server는 localhost에서 실행되고 mcp-remote 프록시를 통해 서버에 연결할 수 있는 모든 로컬 MCP 호환 클라이언트도 지원합니다. 이를 통해 MCP 사양을 따르는 사용자 정의 또는 타사 통합이 가능합니다.

[!TIP] 지원 클라이언트의 최신 공식 목록과 단계별 설정은 Atlassian Rovo MCP Server 시작하기를 참조하세요. 클라이언트 자체의 MCP 문서나 내장 어시스턴트를 참조할 수도 있습니다.

플러그인 패키징 및 호환성

이 저장소는 클라이언트가 기본 검색 및 설치 흐름을 사용할 수 있도록 동일한 MCP 서버와 스킬을 여러 패키지 형식으로 게시합니다:

형식	매니페스트 및 구성	공유 구성 요소
Agent Plugins v1	`plugin.json` 및 `mcp.json`	`skills/`
Claude Code 플러그인	`.claude-plugin/plugin.json` 및 `.claude-plugin/marketplace.json`	`.mcp.json` 및 `skills/`
Cursor 플러그인	`.cursor-plugin/plugin.json`	`.mcp.json` 및 `skills/`
Gemini 확장	`gemini-extension.json`	매니페스트에 포함된 MCP 서버 구성
MCP 레지스트리	`server.json`	원격 서버 메타데이터

mcp.json와 .mcp.json는 모두 의도적입니다. Agent Plugins는 루트 mcp.json 파일 이름과 휴대용 전송 어휘를 요구하며, 기존 클라이언트는 계속 .mcp.json와 기본 구성 어휘를 사용합니다. 두 파일을 변경할 때 엔드포인트 설정을 일치시키세요.

루트 패키지는 Kiro Powers를 포함한 Agent Plugins를 구현하는 클라이언트에서 가져올 수 있습니다. 클라이언트별 매니페스트는 계속 사용할 수 있으며 휴대용 패키지로 대체되지 않습니다.

지원 제품 및 도구

도구는 제품과 용도(읽기, 쓰기, 검색)별로 구성됩니다. 조직 관리자는 권한 그룹 수준에서 액세스를 부여하거나 취소하며, 각 도구는 상위 그룹의 액세스를 상속합니다.

제품	권한 그룹	OAuth 2.1	API 토큰
Jira	`read` · `write` · `search`	✅	✅
Confluence	`read` · `write` · `search`	✅	✅
Jira Service Management	`read` · `write`	—	✅ (전용)
Bitbucket Cloud	`read` · `write`	—	✅ (범위 지정, 전용)
Compass	`read` · `write`	✅ (전용)	—
Atlassian 플랫폼	`read_teamwork_graph` · `search_atlassian`	✅	✅

[!NOTE] Jira Service Management 및 Bitbucket Cloud 도구는 API 토큰 인증을 통해서만 사용할 수 있으며, Compass 도구는 OAuth 2.1을 통해서만 사용할 수 있습니다. 전체 최신 도구 참조는 지원 도구를 참조하세요.

시작 전 확인 사항

서버를 설정하기 전에 환경이 다음 요구 사항을 충족하는지 확인하세요.

사전 요구 사항

요구 사항은 연결 방식에 따라 다릅니다:

지원 클라이언트용

Jira, Confluence, Jira Service Management, Bitbucket 또는 Compass 중 하나 이상이 포함된 Atlassian Cloud 사이트
선택한 클라이언트에 대한 액세스 권한
OAuth 2.1 인증 흐름을 완료할 최신 브라우저 또는 헤드리스 인증용 API 토큰 자격 증명

IDE 또는 로컬 클라이언트용(데스크톱 설정)

하나 이상의 지원 제품이 포함된 Atlassian Cloud 사이트
지원되는 IDE(예: Claude Desktop, VS Code 또는 Cursor) 또는 사용자 정의 MCP 호환 클라이언트
로컬 MCP 프록시 실행을 위한 Node.js v18+ 설치 (mcp-remote)
OAuth 로그인 완료를 위한 최신 브라우저 또는 헤드리스 인증용 API 토큰 자격 증명

데이터 및 보안

서버는 여러 보안 제어를 적용합니다:

모든 트래픽은 Atlassian의 보안 관행에 따라 **HTTPS(TLS 1.2 이상)**를 통해 전송 중 암호화됩니다.
OAuth 2.1 및 API 토큰 인증은 안전한 액세스 제어를 제공합니다.
데이터 액세스는 Jira, Confluence, Jira Service Management, Bitbucket, Compass 사용자 권한을 존중합니다.
조직에서 Atlassian Cloud 제품에 IP 허용 목록을 사용하는 경우 Atlassian Rovo MCP Server를 통한 도구 호출도 해당 IP 규칙을 준수합니다.

보안 모델 및 관리자 제어에 대한 자세한 개요는 다음을 참조하세요:

작동 방식

아키텍처 및 통신

지원 클라이언트가 서버 엔드포인트에 연결합니다. 대부분의 클라이언트에 권장되는 엔드포인트는 다음과 같습니다:
```
https://mcp.atlassian.com/v1/mcp/authv2
```
https://mcp.atlassian.com/v1/mcp 엔드포인트도 지원됩니다(예: API 토큰 구성용).
설정에 따라 보안 브라우저 기반 OAuth 2.1 흐름이 트리거되거나 API 토큰 인증이 사용됩니다.
권한이 부여되면 클라이언트는 연결된 Atlassian 제품에서 컨텍스트 데이터를 스트리밍하고 실시간 응답을 받습니다.

[!NOTE] 레거시 Server-Sent Events 엔드포인트(https://mcp.atlassian.com/v1/sse)는 계속 지원되지만, /sse을 사용하도록 구성된 사용자 정의 클라이언트는 이제 /mcp(또는 /mcp/authv2)를 가리키도록 업데이트하는 것이 좋습니다.

권한 관리

Atlassian Cloud에서 사용자가 이미 볼 수 있는 권한이 있는 데이터에만 액세스가 부여됩니다. 모든 작업은 기존 프로젝트 또는 공간 수준 역할을 존중합니다. OAuth 및 API 토큰 인증은 모두 구성된 범위와 Atlassian 권한을 준수합니다.

API 토큰 인증(헤드리스)

API 토큰 인증은 헤드리스, 서비스 스타일 또는 비대화형 클라이언트 설정(예: 백엔드 시스템 또는 자동화)에 사용할 수 있습니다. 또한 Jira Service Management 및 Bitbucket Cloud 도구에는 필수입니다.

관리자 활성화 필요: 조직 관리자는 Rovo MCP Server에 대한 API 토큰 인증을 활성화해야 합니다(Atlassian Administration → Rovo → Rovo MCP server → Authentication).
범위 지정 토큰 필요: 액세스해야 하는 도구와 데이터에 필요한 범위로 개인 API 토큰을 생성하세요.
구성 가이드: API 토큰을 통한 인증 구성
관리자 설정 참조: Atlassian Rovo MCP Server 설정 제어: 인증 구성

예제 워크플로

연결되면 클라이언트에서 다음과 같은 작업을 실행할 수 있습니다.

Jira 워크플로

검색: "Project Alpha의 모든 오픈 버그를 찾아줘."
생성/업데이트: "'온보딩 재설계'라는 제목의 스토리를 생성해줘."
일괄 생성: "이 노트들에서 Jira 이슈 5개를 만들어줘."

Confluence 워크플로우

요약: "Q2 계획 페이지를 요약해줘."
생성: "'팀 목표 Q3'라는 제목의 페이지를 생성해줘."
탐색: "내가 접근할 수 있는 스페이스는 무엇인가요?"

Compass 워크플로우

생성: "현재 리포지토리를 기반으로 서비스 컴포넌트를 생성해줘."
일괄 생성: "이 CSV/JSON에서 컴포넌트와 사용자 정의 필드를 가져와줘."
쿼리: "api-gateway 서비스에 의존하는 것은 무엇인가요?"

복합 작업

콘텐츠 연결: "이 Jira 티켓 3개를 '릴리스 계획' 페이지에 연결해줘."
문서 찾기: "이 Compass 컴포넌트에 연결된 Confluence 문서 페이지를 가져와줘."

[!NOTE] 실제 기능은 사용자의 권한 수준과 클라이언트 플랫폼에 따라 다릅니다.

팁과 요령

기본 CloudId, Jira 프로젝트 및 Confluence 스페이스 설정

AGENTS.md를 아래 Markdown으로 업데이트하여 검색 도구 호출을 줄이고, 시간과 토큰을 절약하며, 최대 검색 결과 수를 설정하세요.

## Atlassian Rovo MCP

When connected to atlassian-rovo-mcp:
- **MUST** use Jira project key = YOURPROJ
- **MUST** use Confluence spaceId = "123456"
- **MUST** use cloudId = "https://yoursite.atlassian.net" (do NOT call getAccessibleAtlassianResources)
- **MUST** use `maxResults: 10` or `limit: 10` for ALL Jira JQL and Confluence CQL search operations.

스킬 사용

Claude와 같은 데스크톱 클라이언트를 사용하는 경우, 반복 작업을 위해 스킬을 만들거나 재사용할 수 있습니다. 기본 Rovo MCP 스킬 보기.

Cursor의 경우, 스킬은 마켓플레이스 플러그인의 일부입니다.

관리자 참고 사항: 액세스 관리

조직에서 Atlassian Rovo MCP Server를 사용하도록 준비 중인 관리자라면 아래 사항을 검토하세요. 더 자세한 관리자 지침은 다음을 참조하세요:

설치 및 액세스

마켓플레이스 앱 아님: Atlassian Rovo MCP Server는 Atlassian Marketplace 또는 앱 관리 화면을 통해 설치되지 않습니다. 대신, 사용자가 OAuth 2.1(3LO) 동의 흐름을 처음 완료할 때 자동으로 설치됩니다(적시 설치 또는 "지연 로딩" 설치).
최초 설치 요구 사항: 사이트에서 3LO 동의 흐름을 완료하는 첫 번째 사용자는 MCP 범위가 요청하는 Atlassian 앱(예: Jira 및/또는 Confluence)에 대한 액세스 권한이 있어야 합니다. 이렇게 하면 MCP 앱이 사이트에 대한 올바른 권한으로 등록됩니다.
후속 사용자 액세스: 초기 설치 후, 하나의 Atlassian 앱(예: Jira 또는 Confluence만)에만 액세스할 수 있는 사용자도 3LO 흐름을 완료하여 MCP를 통해 해당 앱에 액세스할 수 있습니다.

액세스 관리, 모니터링 및 해지

관리자 제어: 사이트 및 조직 관리자는 조직의 Marketplace 및 타사 앱 관리에서 MCP 앱의 액세스를 관리, 검토 또는 해지할 수 있습니다. 앱은 첫 번째 성공적인 3LO 동의 후 사이트의 연결된 앱 목록에 나타납니다.
도메인 제어: Atlassian Administration의 Rovo MCP 서버 설정 페이지를 사용하여 연결이 허용되는 외부 AI 도구 및 도메인을 제어하세요. 기본적으로 Atlassian 지원 도메인이 허용됩니다. 신뢰할 수 있는 도메인을 추가하거나 지원 도메인을 차단할 수 있습니다. 도메인 제어는 OAuth 2.1 연결에 적용됩니다. 자세한 내용은 사용 가능한 Atlassian Rovo MCP 서버 도메인을 참조하세요.
IP 제어: 조직에서 Atlassian Cloud 앱에 IP 허용 목록을 사용하는 경우, Atlassian Rovo MCP Server를 통한 요청은 관련 앱에 대한 조직의 IP 허용 목록에 허용된 IP 주소에서 시작되어야 합니다. 구성 세부 정보는 제품 액세스용 IP 주소 지정을 참조하세요.
최종 사용자 제어: 개별 사용자는 프로필 설정에서 자신의 앱 권한을 해지할 수 있습니다.
감사 로깅: Atlassian Rovo MCP Server를 통해 도구가 사용될 때마다 조직의 감사 로그에 이벤트가 기록됩니다. 관리자는 Atlassian Administration의 인사이트 → 감사 로그에서 이를 검토할 수 있습니다(Rovo MCP 사용자 작업 필터 또는 MCP 검색). 자세한 내용은 Atlassian Rovo MCP 서버 활동 모니터링을 참조하세요.

일반적인 문제 해결

"사이트 관리자가 이 앱을 승인해야 합니다" 오류: 다른 사람이 MCP 앱을 사용하기 전에 사이트 관리자가 3LO 동의 흐름을 완료해야 합니다. 자세한 내용은 Atlassian Cloud 앱의 "사이트 관리자가 이 앱을 승인해야 합니다" 오류를 참조하세요.
"이 IP 주소에서 연결할 권한이 없습니다. 관리자에게 액세스를 요청하세요." 이는 일반적으로 IP 허용 목록이 활성화되어 있고 사용자의 현재 IP 주소가 Atlassian Rovo MCP Server를 통해 Jira, Confluence, Jira Service Management, Bitbucket 또는 Compass에 액세스할 수 없음을 나타냅니다. 사이트 또는 조직 관리자에게 IP 허용 목록 구성을 검토하고 적절한 경우 관련 네트워크 또는 VPN IP 범위를 추가하도록 요청하세요.
연결된 앱에 앱이 표시되지 않음: 사용자가 올바른 Atlassian 계정과 사이트를 사용하고 있는지 확인하고, 앱이 올바른 Atlassian 앱 범위(예: Jira 범위)를 요청하고 있는지 확인하세요. 문제가 지속되면 조직의 Marketplace 및 타사 앱 관리를 확인하거나 Atlassian 지원팀에 문의하세요. 또한 Atlassian Administration에서 사용자의 제품 권한을 확인하세요.

보안

MCP(Model Context Protocol)를 사용하면 AI 에이전트가 사용자 계정의 권한을 사용하여 도구와 Atlassian 데이터에 연결할 수 있습니다. 이는 강력한 워크플로우를 만들지만 구조적 위험도 수반합니다. 활성화하는 모든 MCP 클라이언트 또는 서버(예: IDE 플러그인, 데스크톱 앱, 호스팅된 MCP 서버 또는 "원클릭" 통합)는 AI 에이전트가 사용자를 대신하여 작업을 수행하게 할 수 있습니다.

LLM(대규모 언어 모델)은 프롬프트 인젝션 및 관련 공격(간접 프롬프트 인젝션 및 도구 중독 등)에 취약합니다. 이러한 공격은 에이전트에게 명시적인 요청 없이 데이터를 유출하거나 의도하지 않은 변경을 하도록 지시할 수 있습니다.

위험을 줄이려면 신뢰할 수 있는 MCP 클라이언트와 서버만 사용하고, 각 에이전트가 액세스할 수 있는 도구와 데이터를 신중하게 검토하며, 최소 권한(범위가 지정된 토큰, 최소 프로젝트/워크스페이스 액세스)을 적용하세요. 영향이 크거나 파괴적인 작업의 경우 인간 확인을 요구하고 비정상적인 활동에 대한 감사 로그를 모니터링하세요. Atlassian의 MCP 위험에 대한 지침을 MCP 클라이언트: 잠재적 보안 위험 이해에서 검토하는 것을 강력히 권장합니다.

지원 및 피드백

Atlassian Rovo MCP Server를 개선하기 위해 피드백을 사용합니다. 버그나 제한 사항이 발생하거나 제안 사항이 있는 경우:

Atlassian 지원 포털을 방문하여 문제 및 기능 요청을 보고하세요.
Atlassian 커뮤니티에서 경험과 질문을 공유하고, 개발자 관련 문의는 Atlassian 개발자 커뮤니티에 공유하세요.
앱을 구축 중이고 버그나 문제를 발견했거나 제안 사항이 있는 경우 에코시스템 개발자 포털로 이동하세요.

고지 사항

MCP 클라이언트는 기존 권한으로 Jira, Confluence, Jira Service Management, Bitbucket 및 Compass에서 작업을 수행할 수 있습니다. 최소 권한을 사용하고, 확인 전에 영향이 큰 변경 사항을 검토하며, 비정상적인 활동에 대한 감사 로그를 모니터링하세요.

자세히 알아보기: MCP 클라이언트: 잠재적 보안 위험 이해.