MCP 아틀라시안

Atlassian 제품(Confluence 및 Jira)용 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 통합은 Atlassian Cloud 및 서버/데이터 센터 배포를 모두 지원합니다.

기능 데모

호환성

제품	배포 유형	지원 상태
합류	구름	✅ 완벽히 지원됨
합류	서버/데이터 센터	✅ 지원됨(버전 7.9+)
지라	구름	✅ 완벽히 지원됨
지라	서버/데이터 센터	✅ 지원됨(버전 8.14+)

설정 가이드

1. 인증 설정

먼저, 필요한 인증 토큰을 생성합니다.

Atlassian Cloud의 경우

https://id.atlassian.com/manage-profile/security/api-tokens 로 이동하세요
API 토큰 만들기를 클릭하고 이름을 지정하세요.
토큰을 즉시 복사하세요

서버/데이터 센터용

프로필(아바타) → 프로필 → 개인 액세스 토큰 으로 이동하세요.
토큰 만들기를 클릭하고 이름을 지정하고 만료일을 설정합니다.
토큰을 즉시 복사하세요

2. 설치

다음 설치 방법 중 하나를 선택하세요.

지엑스피1

3. 구성 및 사용

명령줄 인수를 사용하여 MCP 서버를 구성할 수 있습니다. 이 서버는 Confluence, Jira 또는 두 서비스 모두를 지원합니다. 사용 사례에 필요한 인수만 포함하세요.

필수 인수

Atlassian Cloud의 경우:

uvx mcp-atlassian \
  --confluence-url https://your-company.atlassian.net/wiki \
  --confluence-username your.email@company.com \
  --confluence-token your_api_token \
  --jira-url https://your-company.atlassian.net \
  --jira-username your.email@company.com \
  --jira-token your_api_token

서버/데이터 센터의 경우:

uvx mcp-atlassian \
  --confluence-url https://confluence.your-company.com \
  --confluence-personal-token your_token \
  --jira-url https://jira.your-company.com \
  --jira-personal-token your_token

참고: Confluence만, Jira만 또는 두 서비스 모두 구성할 수 있습니다. 사용하려는 서비스의 인수만 포함하면 됩니다. 예를 들어 Confluence Cloud만 사용하려면 --confluence-url , --confluence-username , --confluence-token 만 필요합니다.

선택적 인수

--transport : 전송 유형을 선택합니다( stdio [기본값] 또는 sse )
--port : SSE 전송을 위한 포트 번호(기본값: 8000)
--[no-]confluence-ssl-verify : Confluence Server/DC에 대한 SSL 검증을 전환합니다.
--[no-]jira-ssl-verify : Jira Server/DC에 대한 SSL 검증을 전환합니다.
--verbose : 로깅의 자세한 내용을 늘립니다(여러 번 사용 가능)
--read-only : 읽기 전용 모드로 실행(모든 쓰기 작업 비활성화)

참고: 모든 구성 옵션은 환경 변수를 통해서도 설정할 수 있습니다. 사용 가능한 환경 변수의 전체 목록은 저장소의 .env.example 파일을 참조하세요.

IDE 통합

클로드 데스크탑 설정

uvx 사용(권장) - 클라우드:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://confluence.your-company.com",
        "--confluence-personal-token=your_token",
        "--jira-url=https://jira.your-company.com",
        "--jira-personal-token=your_token"
      ]
    }
  }
}

참고: 아래 예시에서는 Atlassian Cloud 구성을 사용합니다. 서버/데이터 센터의 경우, 위 구성 섹션에 표시된 대로 해당 인수(--confluence-personal-token, --jira-personal-token)를 사용하세요.

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "python",
      "args": [
        "-m",
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

참고: 아래 예시에서는 Atlassian Cloud 구성을 사용합니다. 서버/데이터 센터의 경우, 위 구성 섹션에 표시된 대로 해당 인수(--confluence-personal-token, --jira-personal-token)를 사용하세요.

Docker 환경을 구성하는 방법은 두 가지가 있습니다.

config에서 cli 인수를 직접 사용:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

환경 파일 사용:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/path/to/your/.env",
        "mcp/atlassian"
      ]
    }
  }
}

커서 IDE 설정

커서 설정 열기
Features > MCP Servers 로 이동
Add new MCP server 클릭하세요

stdio 전송의 경우:

name: mcp-atlassian
type: command
command: uvx mcp-atlassian --confluence-url=https://your-company.atlassian.net/wiki --confluence-username=your.email@company.com --confluence-token=your_api_token --jira-url=https://your-company.atlassian.net --jira-username=your.email@company.com --jira-token=your_api_token

name: mcp-atlassian
type: command
command: uvx mcp-atlassian --confluence-url=https://confluence.your-company.com --confluence-personal-token=your_token --jira-url=https://jira.your-company.com --jira-personal-token=your_token

SSE 전송의 경우 먼저 서버를 시작합니다.

uvx mcp-atlassian ... --transport sse --port 8000

그런 다음 커서에서 구성합니다.

name: mcp-atlassian
type: sse
Server URL: http://localhost:8000/sse

자원

참고: MCP 서버는 사용자의 기여와 과제를 기반으로 사용자가 적극적으로 상호 작용하는 Confluence 공간과 Jira 프로젝트만 표시하도록 리소스를 필터링합니다.

confluence://{space_key} : Confluence 공간에 접근합니다.
jira://{project_key} : Jira 프로젝트에 접근합니다.

사용 가능한 도구

도구	설명
`confluence_search`	CQL을 사용하여 Confluence 콘텐츠 검색
`confluence_get_page`	특정 Confluence 페이지의 콘텐츠 가져오기
`confluence_get_page_children`	특정 Confluence 페이지의 자식 페이지 가져오기
`confluence_get_page_ancestors`	특정 Confluence 페이지의 부모 페이지 가져오기
`confluence_get_comments`	특정 Confluence 페이지에 대한 의견 받기
`confluence_create_page`	새로운 Confluence 페이지 만들기
`confluence_update_page`	기존 Confluence 페이지 업데이트
`confluence_delete_page`	기존 Confluence 페이지 삭제
`jira_get_issue`	특정 Jira 문제에 대한 세부 정보 가져오기
`jira_search`	JQL을 사용하여 Jira 문제 검색
`jira_get_project_issues`	특정 Jira 프로젝트에 대한 모든 이슈 가져오기
`jira_create_issue`	Jira에서 새로운 이슈를 생성하세요
`jira_update_issue`	기존 Jira 이슈 업데이트
`jira_delete_issue`	기존 Jira 이슈 삭제
`jira_get_transitions`	Jira 이슈에 대해 사용 가능한 상태 전환 가져오기
`jira_transition_issue`	Jira 이슈를 새로운 상태로 전환
`jira_add_worklog`	Jira 이슈에 작업 로그 항목 추가
`jira_get_worklog`	Jira 이슈에 대한 작업 로그 항목 가져오기
`jira_link_to_epic`	이슈를 Epic에 연결
`jira_get_epic_issues`	특정 Epic에 연결된 모든 문제를 가져옵니다.

개발 및 디버깅

지역 개발 설정

저장소를 복제하고 로컬 버전을 실행하려면 다음을 수행합니다.

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/your/mcp-atlassian",
        "run", "mcp-atlassian",
        "--confluence-url=https://your-domain.atlassian.net/wiki",
        "--confluence-username=your.email@domain.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-domain.atlassian.net",
        "--jira-username=your.email@domain.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

디버깅 도구

# Using MCP Inspector
# For installed package
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# For local development version
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

# View logs
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

보안

API 토큰을 공유하지 마세요
.env 파일을 안전하고 비공개로 유지하세요
모범 사례는 SECURITY.md를 참조하세요.

특허

MIT 라이선스에 따라 배포됩니다. 라이선스 파일을 참조하세요. 이 제품은 Atlassian의 공식 제품이 아닙니다.

MCP Atlassian

Integrations