Atlassian MCP Server

공식

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

GitHub

871

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

Jira, Confluence 또는 Bitbucket 콘텐츠 검색 및 요약 — AI에게 search 도구를 사용하여 열린 버그를 찾거나, 페이지를 요약하거나, 프로젝트 전체를 검색하도록 요청하세요.
Jira 이슈 또는 Confluence 페이지 생성 및 업데이트 — 자연어를 사용하여 write 도구를 통해 스토리, 작업 또는 문서를 생성하세요.
Compass 구성 요소 조회 및 관리 — Compass read 및 write 도구를 사용하여 서비스 종속성을 조회하거나 리포지토리에서 구성 요소를 생성하세요.
노트나 명세서에서 항목 일괄 생성 — 회의 노트를 여러 Jira 이슈로 변환하거나 구조화된 데이터에서 구성 요소를 한 번에 가져오세요.
제품 간 관련 작업 연결 — Jira 티켓을 Confluence 페이지에 연결하거나 Compass 구성 요소에 연결된 문서를 가져오세요.

문서

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 문서
Amazon Quick Suite	MCP 통합 가이드

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

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

지원 제품 및 도구

도구는 제품 및 용도(읽기, 쓰기, 검색)별로 구성됩니다. 조직 관리자는 권한 그룹 수준에서 접근을 부여하거나 취소하며, 각 도구는 상위 그룹의 접근 권한을 상속받습니다.

제품	권한 그룹	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 프록시(mcp-remote)를 실행하기 위해 Node.js v18 이상 설치
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 관리 → Rovo → Rovo MCP 서버 → 인증).
범위 지정 토큰 필요: 접근해야 하는 도구 및 데이터에 필요한 범위로 개인 API 토큰을 생성하세요.
구성 가이드: API 토큰을 통한 인증 구성
관리자 설정 참조: Atlassian Rovo MCP Server 설정 제어: 인증 구성

워크플로 예시

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

Jira 워크플로

검색: "프로젝트 알파에서 열려 있는 모든 버그 찾기."
생성/업데이트: "'온보딩 재설계'라는 제목의 스토리 만들기."
대량 생성: "이 노트에서 Jira 이슈 5개 만들기."

Confluence 워크플로

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

Compass 워크플로

생성: "현재 리포지토리를 기반으로 서비스 구성 요소 만들기."
대량 생성: "이 CSV/JSON에서 구성 요소 및 사용자 정의 필드 가져오기."
쿼리: "api-gateway 서비스에 종속된 것은 무엇인가요?"

결합된 작업

콘텐츠 연결: "이 세 개의 Jira 티켓을 '릴리스 계획' 페이지에 연결해 줘."
문서 찾기: "이 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 서버는 Atlassian 마켓플레이스나 앱 관리 화면을 통해 설치되지 않습니다. 대신, 사용자가 OAuth 2.1 (3LO) 동의 흐름을 처음 완료할 때 자동으로 설치됩니다(적시 설치 또는 "지연 로딩" 설치).
최초 설치 요구 사항: 사이트에 대해 3LO 동의 흐름을 완료하는 첫 번째 사용자는 MCP 범위에서 요청하는 Atlassian 앱(예: Jira 및/또는 Confluence)에 접근할 수 있어야 합니다. 이렇게 하면 MCP 앱이 사이트에 올바른 권한으로 등록됩니다.
후속 사용자 접근: 최초 설치 후, 하나의 Atlassian 앱(예: Jira만 또는 Confluence만)에만 접근할 수 있는 사용자도 3LO 흐름을 완료하여 MCP를 통해 해당 앱에 접근할 수 있습니다.

관리, 모니터링 및 접근 권한 취소

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

일반적인 문제 해결

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

보안

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

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

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

지원 및 피드백

Atlassian Rovo MCP 서버를 개선하기 위해 여러분의 피드백을 사용합니다. 버그나 제한 사항을 발견했거나 제안 사항이 있는 경우:

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

면책 조항

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

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