MCP Atlassian

Name: MCP Atlassian MCP Server
Author: sooperset

왜 쓰나요

핵심 기능

Jira: JQL 검색, 이슈 가져오기/생성/업데이트, 전환, 댓글 추가, 워크플로 나열
Confluence: 페이지 검색, 콘텐츠 가져오기, 페이지 생성/업데이트, 댓글, 첨부 파일
Cloud + Server/Data Center 지원
최소 권한 배포를 위한 읽기 전용 모드
사이트 필터 — 여러 프로젝트/스페이스가 있는 경우 단일로 제한
Stdio + HTTP/SSE 전송

라이브 데모

실제 사용 모습

mcp-atlassian-sooperset.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-atlassian-sooperset",
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-atlassian-sooperset": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-atlassian"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add mcp-atlassian-sooperset -- uvx mcp-atlassian

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: MCP Atlassian

연결된 Confluence 런북이 있는 Jira 티켓으로 프로덕션 오류 트리아지

👤 온콜 엔지니어 ⏱ ~10 min intermediate

언제 쓸까: Sentry 알림이 발생했을 때 — 빠르게 트리아지된 Jira 티켓과 런북 링크가 필요할 때.

사전 조건

API 토큰 — Atlassian → 내 계정 → 보안 → API 토큰

흐름

관련 항목 검색

Atlassian: 지난 30일 동안 'NullPointerException OrderService'가 포함된 Jira 이슈를 검색하세요. Confluence에서 OrderService를 언급하는 런북 페이지도 검색하세요.✓ 복사됨

→ 두 결과 집합 모두 반환됨
중복인지 새 항목인지 결정

지난 14일 내에 열린 BUG 이슈가 있으면 새 스택 트레이스로 댓글을 달아주세요. 그렇지 않으면 새 BUG를 생성하고, 런북 페이지를 연결하며, 우선순위를 High로 설정하세요.✓ 복사됨

→ jira_add_comment 또는 jira_create_issue 중 하나가 한 번 호출됨
인계

Slack에 게시할 수 있도록 티켓 키와 간단한 요약을 알려주세요.✓ 복사됨

→ ABC-1234 + 한 줄 요약

결과: 런북 링크가 포함된 트리아지된 티켓이 2분 이내에 생성됨; 중복 등록 없음

함정

스택 트레이스를 일반 텍스트로 Jira에 붙여넣으면 서식이 손실됨 — {code} 마커로 감싸기; MCP는 그대로 전달
사용자 입력을 통한 JQL 인젝션 — 항상 문자열 파라미터를 따옴표로 감싸기; 도구가 이스케이프하지만 명시적으로 처리

함께 쓰기: sentry · github

Jira에서 주간 상태 보고서 생성

👤 테크 리드 / EM ⏱ ~10 min beginner

언제 쓸까: 월요일 아침: 무엇이 출시되었고 무엇이 차단되어 있는지 요약해야 할 때.

흐름

지난주 완료 항목 가져오기

Atlassian: JQL project = PLAT AND status changed to Done during (-7d, now()) ORDER BY updated DESC✓ 복사됨

→ 담당자, 키, 요약이 있는 이슈 목록
차단된 항목 가져오기

이제 JQL project = PLAT AND status = Blocked — 각각에 대해 최신 댓글을 요약하세요.✓ 복사됨

→ 이슈별 마지막 댓글 요약이 있는 차단 목록
작성

출시됨 / 차단됨 / 위험으로 그룹화된 200자 주간 보고서 형식으로 작성하세요.✓ 복사됨

→ 붙여넣을 준비가 된 간결한 보고서

결과: 인용된 이슈 키와 함께 90초 만에 상태 보고서 작성

함정

긴 댓글 스레드가 컨텍스트를 부풀림 — fields=summary,status,assignee로만 jira_get_issue 사용

토론에서 Confluence RFC 초안 작성

👤 설계 문서를 작성하는 엔지니어 ⏱ ~20 min intermediate

언제 쓸까: 채팅에서 접근 방식을 토론했을 때; Confluence 페이지를 원할 때.

흐름

상위 스페이스 찾기

Atlassian: 'Engineering RFC' 스페이스를 찾아주세요. 최상위 페이지를 나열하세요.✓ 복사됨

→ 스페이스 + 상위 페이지 식별됨
작성

'RFC: Redis에서 Valkey로 전환' 제목의 새 페이지를 그 아래에 생성하세요. 섹션: 컨텍스트, 목표/비목표, 검토된 옵션, 결정, 계획. 위의 토론을 원자료로 사용하세요.✓ 복사됨

→ confluence_create_page가 URL 반환

결과: 검토 준비가 된 RFC 초안

함정

잘못된 상위 페이지 ID — 항상 스페이스로 confluence_search 먼저

오래된 티켓 일괄 정리

👤 엔지니어링 매니저 ⏱ ~30 min intermediate

언제 쓸까: 백로그에 200개의 좀비가 있을 때; 분류하고 싶을 때.

흐름

오래된 항목 식별

JQL: project = PLAT AND status = Open AND updated < -90d. Limit 50.✓ 복사됨

→ 오래된 이슈 목록
조치 제안

각각에 대해 제안: close-stale, reassign-to-triage, 또는 유지. 전환하기 전에 10개씩 보여주세요.✓ 복사됨

→ 이슈별 권장 사항; 배치로 승인
적용

승인한 항목들을 '오래됨으로 닫힘' 댓글과 함께 닫으세요.✓ 복사됨

→ 이슈별로 jira_transition_issue + jira_add_comment가 호출됨

결과: 이슈별 감사 추적이 있는 정리된 백로그

함정

합법적이지만 조용한 티켓을 자동으로 닫음 — 항상 전환 전에 배치 + 확인

조합

다른 MCP와 조합해 10배 효율

mcp-atlassian-sooperset + sentry

Sentry 오류를 잘 형식화된 Jira 티켓으로 변환

Sentry: 최신 심각한 이슈를 가져오세요. Atlassian: 스택 트레이스와 Sentry URL이 연결된 Jira BUG를 등록하세요.✓ 복사됨

mcp-atlassian-sooperset + github

PR을 Jira 티켓에 자동으로 연결

GitHub: 오늘 병합된 PR을 찾으세요. Atlassian: 각각에 대해 연결된 Jira 이슈에 PR URL을 댓글로 달아주세요.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
jira_search	jql: str, limit?	모든 Jira 조회	1 API call
jira_get_issue	key: str, fields?	단일 이슈의 전체 내용이 필요할 때	1 call
jira_create_issue	project, type, summary, description, fields?	새 티켓 등록	1 call
jira_transition_issue	key, transition, comment?	워크플로에서 이슈 이동	1 call
jira_add_comment	key, body	컨텍스트 추가	1 call
confluence_search	cql: str	문서 찾기	1 call
confluence_get_page	id: str	페이지 내용 읽기	1 call
confluence_create_page	space, parent_id, title, body	새 문서 생성	1 call
confluence_update_page	id, title, body, version	문서 편집	1 call

비용 및 제한

운영 비용

API 쿼터: Atlassian Cloud: 사용자/토큰당 5000 req/h (티어에 따라 다름)
호출당 토큰: 300–4000
금액: 무료 OSS; Atlassian 플랜 적용
팁: fields=를 사용하여 페이로드를 줄이기; jira_get_issue 기본값은 무거움

보안

권한, 시크릿, 파급범위

최소 스코프: read:jira-work write:jira-work read:confluence-content.all write:confluence-content

자격 증명 저장: 환경 변수에 API token; 내 계정을 통해 교체

데이터 외부 송신: 사용자의 atlassian.net (또는 자체 호스팅) 인스턴스만

절대 부여 금지: site-admin

Claude가 변경할 수 없어야 한다면 READ_ONLY_MODE=true 설정; 모든 쓰기 도구를 커버

문제 해결

자주 발생하는 오류와 해결

401 Unauthorized

토큰이 만료되었거나 잘못된 사용자명 (Cloud는 이메일이어야 함)

확인: curl -u email:token $URL/rest/api/3/myself

JQL 파싱 오류

문자열 값을 따옴표로 감싸고 특수 문자를 이스케이프; Jira UI에서 먼저 미리보기

스페이스에서 생성 시 Forbidden

토큰 사용자에게 해당 스페이스의 '페이지 추가' 권한이 없음

속도 제한 429

백오프; 병렬 팬아웃 줄이기; 토큰당 Atlassian 속도 제한 확인

확인: X-RateLimit headers

대안

MCP Atlassian 다른 것과 비교

대안	언제 쓰나	단점/장점
Atlassian 공식 MCP (Cloud)	Cloud만 사용하고 OAuth를 원할 때	최신이지만 더 좁은 툴셋; Server/DC 미지원
Linear MCP	Jira가 아닌 Linear를 사용할 때	다른 시스템; 더 빠르고 깔끔하지만 Confluence 동등물 없음