Atlassian MCP Server

Integrations

  • Provides a server for integrating with Atlassian cloud services, requiring an Atlassian account and API token.

  • Allows retrieving page content by ID and searching for content within Confluence pages.

  • Enables getting ticket details, searching tickets with JQL, creating new tickets, and adding comments to tickets in Jira.

Atlassian MCP 서버

Atlassian JIRA 및 Confluence와 통합하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 MCP 프로토콜을 통해 JIRA 티켓 및 Confluence 페이지와 상호 작용할 수 있는 도구를 제공합니다.

특징

  • JIRA 티켓 세부 정보 받기
  • JQL을 사용하여 JIRA 티켓 검색
  • 새로운 JIRA 티켓 만들기
  • JIRA 티켓에 댓글 추가
  • Confluence 페이지 콘텐츠 가져오기
  • Confluence에서 콘텐츠 검색

필수 조건

  • Node.js 16 이상
  • Atlassian Cloud 계정
  • Atlassian API 토큰

설치

옵션 1: Cline Marketplace에서 설치(권장)

  1. 오픈 클라인
  2. 설정 > MCP 서버로 이동하세요
  3. "마켓플레이스" 탭을 선택하세요
  4. "Atlassian"을 검색하세요
  5. "설치"를 클릭하세요
  6. 메시지가 표시되면 Atlassian 자격 증명을 구성하세요.

옵션 2: npm에서 설치

지엑스피1

옵션 3: 소스에서 설치

  1. 저장소를 복제합니다
  2. 설치 스크립트를 실행합니다.
./install.sh

또는 수동으로:

  1. 종속성 설치
npm install
  1. 프로젝트를 빌드하세요
npm run build
  1. 전역적으로 설치
npm install -g .
  1. 설치 프로그램을 실행하세요
atlassian-mcp-setup

구성

설치 스크립트, 구성 파일 또는 환경 변수를 사용하여 서버를 구성할 수 있습니다.

설치 스크립트 사용(권장)

설정 스크립트를 실행하여 구성 파일을 만듭니다.

npx atlassian-mcp-setup

또는 로컬로 설치된 경우:

npm run setup

스크립트는 구성 과정을 안내하고 config 디렉토리에 config.json 파일을 생성합니다.

구성 파일을 수동으로 사용

  1. config 디렉토리에 config.json 파일을 만듭니다( config.sample.json 에서 복사 가능)
  2. Atlassian 세부 정보를 입력하세요.
{ "atlassian": { "baseUrl": "https://your-instance.atlassian.net", "email": "your-email@example.com", "token": "your-api-token-here" }, "server": { "name": "atlassian-server", "version": "0.1.0" } }

환경 변수 사용

다음 환경 변수를 설정하세요.

  • ATLASSIAN_BASE_URL : Atlassian 인스턴스 URL(예: https://your-instance.atlassian.net )
  • ATLASSIAN_EMAIL : Atlassian 계정 이메일
  • ATLASSIAN_TOKEN : Atlassian API 토큰
  • ATLASSIAN_CONFIG_PATH : (선택 사항) 사용자 정의 구성 파일 위치 경로

Atlassian API 토큰 받기

  1. https://id.atlassian.com/manage-profile/security/api-tokens 에서 Atlassian 계정에 로그인하세요.
  2. "API 토큰 만들기"를 클릭하세요
  3. 토큰에 이름을 지정하세요(예: "MCP 서버")
  4. 생성된 토큰을 복사하세요(다시는 볼 수 없습니다)

용법

서버 실행

atlassian-mcp-server

또는 소스에서 설치한 경우:

npm start

Cline과 통합

옵션 1: 마켓플레이스에서 설치(권장)

  1. 오픈 클라인
  2. 설정 > MCP 서버로 이동하세요
  3. "마켓플레이스" 탭을 선택하세요
  4. "Atlassian"을 검색하세요
  5. "설치"를 클릭하세요
  6. 메시지가 표시되면 Atlassian 자격 증명을 구성하세요.

옵션 2: 수동 구성

서버를 수동으로 설치한 경우 MCP 설정에 다음을 추가하세요.

{ "mcpServers": { "atlassian": { "command": "atlassian-mcp-server", "args": [], "env": { "ATLASSIAN_CONFIG_PATH": "/path/to/your/config.json" }, "disabled": false } } }

또는 설정에서 자격 증명을 직접 제공할 수 있습니다.

{ "mcpServers": { "atlassian": { "command": "atlassian-mcp-server", "args": [], "env": { "ATLASSIAN_BASE_URL": "https://your-instance.atlassian.net", "ATLASSIAN_EMAIL": "your-email@example.com", "ATLASSIAN_TOKEN": "your-api-token-here" }, "disabled": false } } }

사용 가능한 도구

get_jira_ticket

키로 JIRA 티켓의 세부 정보를 가져옵니다.

매개변수:

  • ticket_key : JIRA 티켓 키(예: "PROJ-123")

검색_지라_티켓

JQL을 사용하여 JIRA 티켓을 검색하세요.

매개변수:

  • jql : JQL 쿼리 문자열
  • max_results : 반환할 최대 결과 수(기본값: 10)

지라 티켓 생성

새로운 JIRA 티켓을 만듭니다.

매개변수:

  • project_key : 프로젝트 키(예: "PROJ")
  • summary : 티켓 요약/제목
  • description : 티켓 설명
  • issue_type : 이슈 유형(예: "버그", "작업", "스토리")(기본값: "작업")

지라 티켓에 댓글 추가

JIRA 티켓에 댓글을 추가합니다.

매개변수:

  • ticket_key : JIRA 티켓 키(예: "PROJ-123")
  • comment : 댓글 텍스트

get_confluence_page

ID로 Confluence 페이지를 가져옵니다.

매개변수:

  • page_id : Confluence 페이지 ID

검색 합류

Confluence에서 콘텐츠를 검색하세요.

매개변수:

  • query : 검색 쿼리
  • limit : 최대 결과 수 (기본값: 10)

마켓플레이스에 게시

이 서버는 https://github.com/kompallik/ATLASSIAN-MCP 에 있는 GitHub 저장소를 사용하여 Cline MCP Marketplace에 게시되도록 구성되었습니다.

업데이트를 게시하려면:

  1. 제공된 스크립트를 사용하여 변경 사항을 GitHub 저장소에 푸시하세요.
npm run push-github
  1. 아직 없는 경우 assets 디렉토리에 icon.png 파일을 추가합니다.
  2. 게시 스크립트를 실행합니다.
npm run publish-mcp
  1. npm에 게시하거나 배포 패키지를 생성하기 위한 프롬프트를 따르세요.
  2. Cline MCP Marketplace 팀에 저장소 URL을 제출하세요.

특허

MIT

ID: ok85tqlb4u