Atlassian

Atlassian MCP 서버는 Atlassian Cloud 제품(Confluence, Jira, Bitbucket 등)과 상호작용할 수 있는 Model Context Protocol 서버입니다. 이 서버는 AI 어시스턴트가 Atlassian 제품군의 다양한 기능에 접근하여 문서 관리, 이슈 추적, 프로젝트 관리 등의 작업을 수행할 수 있도록 지원합니다.

특징

• Confluence 페이지 및 문서 생성, 편집, 검색
• Jira 이슈 생성, 업데이트, 할당 및 관리
• 프로젝트 대시보드 및 보고서 접근
• 워크플로우 상태 및 작업 흐름 관리
• 사용자 및 그룹 권한 관리
• 댓글 및 피드백 작성 및 조회
• Bitbucket 저장소 및 풀 리퀘스트 관리
• 다양한 Atlassian API 확장 기능 지원
• API 키 및 OAuth 인증 지원
• 다중 워크스페이스 및 프로젝트 지원

API

리소스

atlassian://confluence/pages/{page_id}

• 특정 Confluence 페이지의 내용과 메타데이터를 제공합니다.

atlassian://jira/issues/{issue_key}

• 특정 Jira 이슈의 세부 정보와 상태를 제공합니다.

atlassian://bitbucket/repositories/{repo_slug}

• 특정 Bitbucket 저장소의 정보와 파일 목록을 제공합니다.

도구

Confluence 도구

list_confluence_spaces

사용 가능한 Confluence 스페이스를 나열합니다. - 입력: - limit: (선택적) 반환할 최대 스페이스 수 - start: (선택적) 결과 시작 오프셋 - status: (선택적) 스페이스 상태 필터링(current, archived) - type: (선택적) 스페이스 유형(global, personal) - 출력: 스페이스 키, 이름, URL 등의 목록

get_confluence_space

특정 Confluence 스페이스의 정보를 가져옵니다. - 입력: - space_key: 스페이스 키 - 출력: 스페이스 상세 정보

search_confluence

Confluence 콘텐츠를 검색합니다. - 입력: - query: 검색 쿼리 - space_key: (선택적) 검색할 스페이스 키 - content_type: (선택적) 콘텐츠 유형(page, blogpost, comment) - limit: (선택적) 최대 결과 수 - 출력: 검색 결과 목록

get_confluence_page

특정 Confluence 페이지의 내용을 가져옵니다. - 입력: - page_id: 페이지 ID - expand: (선택적) 확장할 속성(body, version, space 등) - 출력: 페이지 내용 및 메타데이터

create_confluence_page

새 Confluence 페이지를 생성합니다. - 입력: - space_key: 스페이스 키 - title: 페이지 제목 - body: 페이지 내용(XHTML 또는 Storage 형식) - parent_id: (선택적) 상위 페이지 ID - labels: (선택적) 레이블 배열 - 출력: 생성된 페이지 정보

update_confluence_page

기존 Confluence 페이지를 업데이트합니다. - 입력: - page_id: 페이지 ID - title: (선택적) 새 제목 - body: (선택적) 새 내용 - version: 페이지 버전 정보 - labels: (선택적) 새 레이블 배열 - 출력: 업데이트된 페이지 정보

add_confluence_comment

Confluence 페이지에 댓글을 추가합니다. - 입력: - page_id: 페이지 ID - body: 댓글 내용 - parent_comment_id: (선택적) 상위 댓글 ID(답글용) - 출력: 생성된 댓글 정보

Jira 도구

list_jira_projects

사용 가능한 Jira 프로젝트를 나열합니다. - 입력: - recent: (선택적) 최근 프로젝트만 포함할지 여부 - max_results: (선택적) 최대 결과 수 - 출력: 프로젝트 키, 이름, URL 등의 목록

get_jira_project

특정 Jira 프로젝트의 정보를 가져옵니다. - 입력: - project_key: 프로젝트 키 - 출력: 프로젝트 상세 정보

search_jira_issues

Jira 이슈를 검색합니다. - 입력: - jql: Jira 쿼리 언어(JQL) 검색 문자열 - max_results: (선택적) 최대 결과 수 - fields: (선택적) 반환할 필드 목록 - 출력: 이슈 목록

get_jira_issue

특정 Jira 이슈의 정보를 가져옵니다. - 입력: - issue_key: 이슈 키 - fields: (선택적) 반환할 필드 목록 - expand: (선택적) 확장할 속성 - 출력: 이슈 상세 정보

create_jira_issue

새 Jira 이슈를 생성합니다. - 입력: - project_key: 프로젝트 키 - issue_type: 이슈 유형 - summary: 이슈 제목 - description: (선택적) 이슈 설명 - priority: (선택적) 우선순위 - assignee: (선택적) 담당자 - custom_fields: (선택적) 사용자 정의 필드 - 출력: 생성된 이슈 정보

update_jira_issue

기존 Jira 이슈를 업데이트합니다. - 입력: - issue_key: 이슈 키 - summary: (선택적) 새 제목 - description: (선택적) 새 설명 - status: (선택적) 새 상태 - priority: (선택적) 새 우선순위 - assignee: (선택적) 새 담당자 - custom_fields: (선택적) 사용자 정의 필드 - 출력: 업데이트된 이슈 정보

add_jira_comment

Jira 이슈에 댓글을 추가합니다. - 입력: - issue_key: 이슈 키 - body: 댓글 내용 - 출력: 생성된 댓글 정보

transition_jira_issue

Jira 이슈의 상태를 변경합니다. - 입력: - issue_key: 이슈 키 - transition_id: 전환 ID 또는 이름 - comment: (선택적) 전환에 대한 코멘트 - fields: (선택적) 전환과 함께 업데이트할 필드 - 출력: 전환 결과

Bitbucket 도구

list_bitbucket_repositories

사용 가능한 Bitbucket 저장소를 나열합니다. - 입력: - workspace: 작업 공간 - limit: (선택적) 최대 결과 수 - 출력: 저장소 목록

get_bitbucket_repository

특정 Bitbucket 저장소의 정보를 가져옵니다. - 입력: - workspace: 작업 공간 - repo_slug: 저장소 슬러그 - 출력: 저장소 상세 정보

list_bitbucket_pull_requests

Bitbucket 풀 리퀘스트를 나열합니다. - 입력: - workspace: 작업 공간 - repo_slug: 저장소 슬러그 - state: (선택적) 풀 리퀘스트 상태(OPEN, MERGED, DECLINED) - 출력: 풀 리퀘스트 목록

get_bitbucket_pull_request

특정 Bitbucket 풀 리퀘스트의 정보를 가져옵니다. - 입력: - workspace: 작업 공간 - repo_slug: 저장소 슬러그 - pull_request_id: 풀 리퀘스트 ID - 출력: 풀 리퀘스트 상세 정보

사용 방법

설치 및 구성

1. 사전 요구 사항:
2. Atlassian Cloud 계정

3. API 키 또는 OAuth 토큰

4. MCP 서버 설치:

   pip install atlassian-mcp-server

5. Claude Desktop 구성:

   {
     "mcpServers": {
       "atlassian": {
         "command": "python",
         "args": ["-m", "atlassian_mcp"],
         "env": {
           "ATLASSIAN_URL": "https://your-domain.atlassian.net",
           "ATLASSIAN_EMAIL": "your-email@example.com",
           "ATLASSIAN_API_TOKEN": "your-api-token",
           "ATLASSIAN_DEFAULT_PROJECT": "PROJ"
         }
       }
     }
   }

6. 구성 옵션:

7. ATLASSIAN_URL: Atlassian Cloud 인스턴스 URL
8. ATLASSIAN_EMAIL: Atlassian 계정 이메일
9. ATLASSIAN_API_TOKEN: API 토큰 (Atlassian 계정 설정에서 생성)
10. ATLASSIAN_DEFAULT_PROJECT: 기본 Jira 프로젝트 키
11. ATLASSIAN_DEFAULT_SPACE: 기본 Confluence 스페이스 키
12. ATLASSIAN_DEFAULT_WORKSPACE: 기본 Bitbucket 작업 공간
13. ATLASSIAN_CACHE_TTL: 캐시 수명(초) (기본값: 300)
14. ATLASSIAN_LOG_LEVEL: 로그 수준 (기본값: INFO)

기본 사용 예시

1. Confluence 스페이스 목록 확인:

   list_confluence_spaces({
     limit: 10
   })

2. Confluence 페이지 검색:

   search_confluence({
     query: "프로젝트 계획",
     space_key: "TEAM",
     limit: 5
   })

3. Confluence 페이지 생성:

   create_confluence_page({
     space_key: "TEAM",
     title: "2025년 2분기 마케팅 계획",
     body: "<p>이 문서는 2025년 2분기 마케팅 전략과 실행 계획을 다룹니다.</p><h2>목표</h2><p>주요 목표는 다음과 같습니다:</p><ul><li>신규 고객 30% 증가</li><li>기존 고객 유지율 85% 달성</li></ul>",
     labels: ["marketing", "planning", "2025Q2"]
   })

4. Jira 이슈 검색:

   search_jira_issues({
     jql: "project = PROJ AND status = 'In Progress' AND assignee = currentUser()",
     max_results: 20
   })

5. Jira 이슈 생성:

   create_jira_issue({
     project_key: "PROJ",
     issue_type: "Task",
     summary: "모바일 앱 성능 개선",
     description: "사용자 피드백에 따르면 iOS 앱의 시작 시간이 너무 깁니다. 최적화가 필요합니다.",
     priority: "High",
     assignee: "john.doe",
     custom_fields: {
       "customfield_10001": "2025-06-30"
     }
   })

6. Jira 이슈 상태 변경:

   transition_jira_issue({
     issue_key: "PROJ-123",
     transition_id: "In Progress",
     comment: "작업을 시작했습니다. 이번 주 내로 완료 예정입니다."
   })

7. Bitbucket 저장소 목록 확인:

   list_bitbucket_repositories({
     workspace: "my-workspace",
     limit: 10
   })

8. Bitbucket 풀 리퀘스트 목록 확인:

   list_bitbucket_pull_requests({
     workspace: "my-workspace",
     repo_slug: "my-project",
     state: "OPEN"
   })

보안 고려사항

• Atlassian API 토큰은 민감한 정보이므로 안전하게 관리해야 합니다.
• 필요한 최소한의 권한만 가진 API 토큰을 사용하세요.
• 환경 변수나 구성 파일에 저장된 API 토큰을 안전하게 관리하세요.
• 민감한 프로젝트 데이터나 개인 정보가 포함된 내용을 외부에 노출하지 않도록 주의하세요.

연결된 구성 요소

• Notion - Notion API와 상호작용
• Linear - 검색, 생성, 업데이트 등을 포함한 Linear API와 상호작용
• GitHub - 저장소 관리, 파일 작업 및 GitHub API 통합
• Obsidian Markdown Notes - Obsidian 볼트 또는 Markdown 노트가 포함된 디렉토리 읽기 및 검색