Skip to main content
Glama

MCP Atlassian Server

Atlassian 제품(Confluence, Jira)과 통합하기 위한 Model Context Protocol (MCP) 서버입니다. AI 어시스턴트가 Atlassian Cloud API와 상호작용하여 문서 관리, 검색, 내보내기 기능을 사용할 수 있게 합니다.

📋 목차

Related MCP server: MCP Atlassian Server

주요 기능

🔵 Confluence 통합

  • 읽기 & 검색: 페이지, 스페이스, 콘텐츠 접근

  • 콘텐츠 관리: 페이지 생성, 수정, 댓글 작성

  • 페이지 계층: 부모/자식 페이지 관계 탐색

  • 내보내기: 이미지가 포함된 HTML 또는 Markdown으로 내보내기

  • 첨부파일: 첨부파일 목록, 다운로드, 업로드

  • 레이블: 페이지 레이블 관리

  • 사용자: 사용자 검색 및 개인 활동 추적

  • 개인 대시보드: 최근 페이지 및 멘션 확인

🟢 Jira 통합

  • 이슈: 이슈 읽기, 검색, 개인 작업 조회

  • 프로젝트: 프로젝트 목록 및 탐색

  • 보드 & 스프린트: 보드 목록, 스프린트 보기, 활성 작업 추적

  • 댓글: 이슈에 댓글 추가

  • 이슈 생성: 커스텀 필드를 포함한 새 이슈 생성

  • 사용자 관리: 현재 사용자 정보 조회

  • 개인 대시보드: 열린 이슈 및 스프린트 작업 확인

빠른 시작

1. Atlassian API 토큰 발급

  1. Atlassian 보안 설정으로 이동

  2. "API 토큰 만들기" 클릭

  3. 토큰 라벨 입력 (예: "MCP Integration")

  4. 생성된 토큰을 복사 (한 번만 표시됩니다!)

⚠️ 중요: API 토큰은 비밀번호처럼 안전하게 보관하세요.

2. MCP 설정 파일 찾기

Claude Desktop

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

Cursor

  • 모든 OS: ~/.cursor/mcp.json

3. 설정 파일 수정

설정 파일을 열고 다음 내용을 추가하세요:

{
  "mcpServers": {
    "atlassian": {
      "command": "npx",
      "args": ["-y", "mcp-atlassian"],
      "env": {
        "ATLASSIAN_BASE_URL": "https://your-company.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@company.com",
        "ATLASSIAN_API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

설정값 설명:

  • ATLASSIAN_BASE_URL: 회사의 Atlassian URL (끝에 / 제거)

  • ATLASSIAN_EMAIL: Atlassian 계정 이메일

  • ATLASSIAN_API_TOKEN: 1단계에서 생성한 API 토큰

4. 앱 재시작

  • Claude Desktop: 앱을 완전히 종료하고 다시 시작

  • Cursor: ⌘+Q (또는 Ctrl+Q) 후 다시 실행

5. 연결 확인

AI 어시스턴트에게 다음과 같이 물어보세요:

"Atlassian MCP 서버가 연결되었는지 확인해줘"

사용 가능한 도구

Confluence 도구 (23개)

도구

설명

get_confluence_current_user

인증된 사용자 정보 조회

get_confluence_user

특정 사용자 정보 조회

search_pages_by_user_involvement

사용자 활동으로 페이지 검색

list_pages_created_by_user

사용자가 작성한 페이지 목록

list_attachments_uploaded_by_user

사용자가 업로드한 첨부파일 목록

read_confluence_page

ID 또는 제목으로 페이지 읽기

search_confluence_pages

CQL로 페이지 검색

list_confluence_spaces

접근 가능한 스페이스 목록

get_confluence_space

특정 스페이스 정보 조회

create_confluence_page

새 페이지 생성

update_confluence_page

기존 페이지 수정

list_confluence_page_children

하위 페이지 목록

list_confluence_page_ancestors

상위 페이지 계층 조회

export_confluence_page

이미지 포함 HTML/Markdown 내보내기

list_attachments_on_page

페이지 첨부파일 목록

download_confluence_attachment

특정 첨부파일 다운로드

upload_confluence_attachment

페이지에 파일 업로드

get_page_with_attachments

모든 콘텐츠와 함께 페이지 다운로드

add_confluence_comment

페이지에 댓글 추가

list_confluence_page_labels

페이지 레이블 조회

add_confluence_page_label

페이지에 레이블 추가

find_confluence_users

사용자 검색

get_my_recent_confluence_pages

내 최근 페이지 목록

get_confluence_pages_mentioning_me

나를 멘션한 페이지 찾기

Jira 도구 (16개)

도구

설명

get_jira_current_user

인증된 사용자 정보 조회

get_jira_user

특정 사용자 정보 조회

search_issues_by_user_involvement

사용자 관련 이슈 검색

list_issues_by_user_role

역할별 사용자 이슈 목록 (날짜 필터링)

get_user_activity_history

댓글 및 상태 변경 포함 사용자 활동 추적

get_user_time_tracking

시간 추적 항목 및 합계 조회

read_jira_issue

키로 이슈 상세 정보 읽기

search_jira_issues

JQL로 이슈 검색

list_jira_projects

접근 가능한 프로젝트 목록

create_jira_issue

새 이슈 생성

add_jira_comment

이슈에 댓글 추가

list_agile_boards

스크럼/칸반 보드 목록

list_sprints_for_board

보드의 스프린트 목록

get_sprint_details

스프린트 상세 정보 조회

get_my_current_sprint_issues

활성 스프린트의 내 작업 조회

get_my_unresolved_issues

모든 미해결 이슈 조회

사용 예시

Confluence 페이지 검색

"내가 작성한 Confluence 페이지 중 최근 5개를 보여줘"
"'API 문서'라는 제목이 포함된 페이지를 검색해줘"

Confluence 페이지 읽기

"페이지 ID 882573681의 내용을 마크다운으로 보여줘"

Jira 이슈 조회

"나한테 할당된 미해결 이슈를 모두 보여줘"
"현재 스프린트에서 내 작업 목록을 보여줘"

프로젝트 및 보드 탐색

"접근 가능한 Jira 프로젝트 목록을 보여줘"
"스크럼 보드 목록을 보여줘"

CQL을 사용한 고급 검색

"type = page AND creator = currentUser() 조건으로 Confluence 페이지를 검색해줘"

문제 해결

연결이 안 될 때

  1. API 토큰 재확인

    • Base URL 형식: https://your-company.atlassian.net (끝에 / 제거)

    • 이메일과 토큰이 정확한지 확인

    • 토큰에 필요한 권한이 있는지 확인

  2. 앱 완전 재시작

    • Claude Desktop: 앱을 완전히 종료하고 다시 시작

    • Cursor: ⌘+Q 후 재실행

  3. 설정 파일 확인

    • JSON 형식이 올바른지 확인 (쉼표, 중괄호 등)

    • 환경 변수 이름이 정확한지 확인

성능이 느릴 때

검색 범위를 좁히면 속도가 향상됩니다:

"최대 10개의 결과만 보여줘"
"DEV 스페이스에서만 검색해줘"
"최근 1주일 이내의 이슈만 보여줘"

기타 문제

제한사항

  • Atlassian Cloud만 지원 (Server/Data Center 미지원)

  • 안전을 위해 삭제 작업은 지원하지 않음

  • 일부 Confluence 매크로는 Markdown 변환 시 제한적

  • Atlassian Cloud API 속도 제한이 적용됨

라이선스

MIT License


Made with ❤️ for better Atlassian integration

Available Tools

40 tools
add_confluence_commentA

Adds a comment to a Confluence page. Can also be used to reply to an existing comment.

Inputs: pageId (required), content (required), parentCommentId.

add_confluence_page_labelA

Adds one or more labels to a Confluence page. Labels are useful for organizing and categorizing content.

Inputs: labels (required), pageId (required).

add_jira_commentA

Adds a comment to an existing Jira issue. You can also control the visibility of the comment.

Inputs: body (required), issueKey (required), visibility.

create_confluence_pageC

Creates a new page or blog post in a Confluence space. Content can be provided in Markdown or Confluence storage format (XHTML).

Inputs: title (required), content (required), spaceKey (required), type, +1 more.

create_jira_issueA

Creates a new issue in a Jira project. You must specify the project, issue type, and a summary. Other fields like description, priority, and assignee are optional.

Inputs: summary (required), issueType (required), projectKey (required), labels, +5 more.

download_confluence_attachmentA

Downloads a specific Confluence attachment and returns its content as a base64-encoded string. This is useful for reading the content of files attached to a page.

Inputs: attachmentId (required), version.

export_confluence_pageA

Exports a Confluence page to either HTML or Markdown format. All images in the page content are embedded directly into the exported file as base64 data, making it self-contained. Use this when you want to create a portable, self-contained file of a page.

Inputs: format (required), pageId (required).

find_confluence_usersA

Searches for Confluence users based on various criteria. This is useful for finding user details like account IDs when you have partial information or need to perform a broader search. Use this tool when you need to find users based on a query.

Inputs: cql, limit, start, expand, +3 more.

get_confluence_current_userA

Get details of the authenticated Confluence user. Returns information about the current user including account ID, display name, email, and profile picture.

Inputs: no named parameters.

get_confluence_pages_mentioning_meA

Search for pages that mention the current user. Returns pages where you have been @mentioned.

Inputs: limit, start, spaceKey.

get_confluence_spaceA

Get details of a specific Confluence space by its key. Returns space information including name, type, status, and description.

Inputs: spaceKey (required), expand.

get_confluence_userA

Get details for a specific Confluence user by a unique identifier like username, account ID, or email. Returns user profile information. Use this tool when you are confident you can uniquely identify a user.

Inputs: email, username, accountId.

get_jira_current_userA

Get details of the authenticated Jira user. Returns information about the current user including account ID, display name, email, and avatar URLs.

Inputs: no named parameters.

get_jira_userA

Get details for a specific Jira user by username, account ID, or email. Returns user profile information.

Inputs: email, username, accountId.

get_my_current_sprint_issuesA

Get all issues assigned to you in the currently active sprint(s). Useful for daily standups or checking your current sprint workload. Can filter by specific board or project.

Inputs: boardId, projectKey.

get_my_recent_confluence_pagesA

List pages recently created or updated by the current user. Returns pages where you are the creator or last modifier.

Inputs: limit, start, spaceKey.

get_my_unresolved_issuesA

Get all unresolved issues currently assigned to you, organized by status and priority. Perfect for checking your backlog or identifying what needs attention.

Inputs: maxResults, projectKeys.

get_page_with_attachmentsA

Performs a comprehensive download of a Confluence page, including its full content, metadata, and optionally, all of its attachments. Attachments are base64-encoded. Use this when you need the page content, metadata, and all associated attachments.

Inputs: pageId (required), attachmentTypes, maxAttachmentSize, includeAttachments.

get_sprint_detailsA

Get comprehensive details about a specific sprint including its name, start/end dates, goals, and all issues included in the sprint.

Inputs: sprintId (required).

get_user_activity_historyC

Get a stream of recent user activity, such as issue comments, status changes, and field updates. Can filter by activity type and project.

Inputs: days, startAt, username, accountId, +3 more.

get_user_time_trackingB

Retrieve time tracking work logs (worklogs) for a specific user. Shows all time entries logged by the user within a date range, useful for timesheet and worklog reporting.

Inputs: endDate, startAt, username, accountId, +3 more.

list_agile_boardsA

List all accessible Agile boards (both Scrum and Kanban types). Can be filtered by project or board type to find specific boards.

Inputs: type, startAt, maxResults, projectKeyOrId.

list_attachments_on_pageC

Lists all attachments for a specific Confluence page. Can be filtered by filename or media type.

Inputs: pageId (required), limit, start, filename, +1 more.

list_attachments_uploaded_by_userB

List all attachments uploaded by a specific user, with optional filtering by space.

Inputs: limit, start, spaceKey, username, +1 more.

list_confluence_page_ancestorsA

Retrieve the parent hierarchy of a Confluence page. Returns the full ancestry path from root to the immediate parent.

Inputs: pageId (required).

list_confluence_page_childrenA

List child pages under a given Confluence page. Returns a hierarchical list of direct child pages.

Inputs: pageId (required), limit, start, expand.

list_confluence_page_labelsB

Retrieves all labels for a specific Confluence page.

Inputs: pageId (required), limit, start, prefix.

list_confluence_spacesA

Lists all Confluence spaces that the user has permission to view. Can be filtered by type and status.

Inputs: type, limit, status.

list_issues_by_user_roleC

List issues where a user has a specific role (assignee, reporter, or creator). Includes date filtering for finding issues within specific time periods.

Inputs: role (required), endDate, startAt, username, +4 more.

list_jira_projectsA

Lists all Jira projects that the user has permission to view. This is useful for discovering available projects to work with.

Inputs: expand.

list_pages_created_by_userA

List all pages created by a specific user, with optional filtering by space or time range.

Inputs: limit, start, endDate, spaceKey, +3 more.

list_sprints_for_boardA

List all sprints for a specific Agile board. Can filter by sprint state (active, closed, or future) to find current or historical sprints.

Inputs: boardId (required), state, startAt, maxResults.

read_confluence_pageA

Retrieves the content of a Confluence page. You can specify the page by its ID or by its title and space key. The content can be returned in raw storage format (XHTML) or converted to Markdown. Use this for quickly reading the text content of a page.

Inputs: title, expand, format, pageId, +1 more.

read_jira_issueA

Retrieves detailed information about a specific Jira issue, including its fields, status, and transitions. Use this to get the full picture of a single issue.

Inputs: issueKey (required), expand.

search_confluence_pagesB

Performs a search for Confluence pages using Confluence Query Language (CQL). This is useful for finding pages that match specific criteria.

Inputs: cql (required), limit, start, expand.

search_issues_by_user_involvementB

Search for issues based on how a specific user is involved (assignee, reporter, creator, watcher, or any). Provides comprehensive filtering to find all issues a user is connected to.

Inputs: searchType (required), status, startAt, username, +4 more.

search_jira_issuesB

Searches for Jira issues using Jira Query Language (JQL). This is the primary way to find issues that match specific criteria.

Inputs: jql (required), fields, startAt, maxResults.

search_pages_by_user_involvementB

Search pages based on a user's involvement, such as being the creator or last modifier. Can filter by creator, last modifier, or both.

Inputs: searchType (required), limit, start, spaceKey, +2 more.

update_confluence_pageA

Updates an existing Confluence page. You must provide the page ID and its current version number to prevent conflicts. You can update the title, content, or both.

Inputs: pageId (required), version (required), title, content, +2 more.

upload_confluence_attachmentB

Upload a file attachment to a Confluence page. The file should be provided as a base64-encoded string.

Inputs: file (required), pageId (required), filename (required), comment, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 40 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes (Confluence vs Jira, different actions). However, a few pairs like 'get_confluence_user' vs 'find_confluence_users' and 'list_issues_by_user_role' vs 'search_issues_by_user_involvement' could cause minor confusion, but descriptions help disambiguate.

    Naming Consistency5/5

    Consistent verb_noun pattern with snake_case throughout. Prefixes like add_, create_, get_, list_, search_ are uniform. Minor variation between 'get' and 'read' for different resource types but this aligns with standard conventions.

    Tool Count3/5

    40 tools is high, covering both Confluence and Jira extensively. While each tool serves a distinct purpose, the count feels heavy for a single server, bordering on overwhelming. A more focused subset might improve usability.

    Completeness3/5

    Covers many operations (create, read, search, list, add comments/labels/attachments) but lacks update and delete for Jira issues, and no issue transitions. These are notable gaps that may hinder agent workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers