Skip to Content
사용자 가이드🧩 Available MCP ServersAtlassian (Confluence)

Atlassian Confluence

Atlassian Confluence와 연결하여 팀 협업 및 문서화 플랫폼을 관리할 수 있습니다.

주요 기능

  • 페이지 및 블로그 포스트 관리
  • 스페이스 및 권한 관리
  • 콘텐츠 검색 및 조회
  • 사용자 검색 및 관리
  • 댓글 및 협업 기능
  • 첨부파일 관리

기본 정보

인증 방식

OAuth 2.0을 사용하여 인증합니다.

필요한 권한

  • delete:page:confluence: 페이지 삭제
  • offline_access: 오프라인 액세스
  • read:me: 사용자 정보 읽기
  • read:page:confluence: 페이지 읽기
  • read:space:confluence: 스페이스 읽기
  • read:user:confluence: 사용자 정보 읽기
  • write:page:confluence: 페이지 쓰기
  • search:confluence: 검색 기능
  • read:content-details:confluence: 콘텐츠 상세 정보 읽기

지원하는 MCP 도구

스페이스 관리 도구

get_spaces

모든 스페이스 목록을 반환합니다. 결과는 ID 오름차순으로 정렬되며, limit 파라미터로 결과 수를 제한할 수 있습니다.

페이지 관리 도구

get_pages

모든 페이지 목록을 반환합니다. 결과 수는 limit 파라미터로 제한할 수 있으며, 추가 결과는 Link 응답 헤더의 next URL을 통해 확인할 수 있습니다.

get_page_by_id

특정 페이지의 상세 정보를 조회합니다.

create_page

스페이스에 새로운 페이지를 생성합니다.

update_page

ID로 페이지를 업데이트합니다.

🛠️

주의: update_page 사용 시 이미지·동영상 등 원본 콘텐츠가 유실될 수 있습니다. 중요한 페이지는 Confluence에서 직접 수정해 주세요.
빠른 시일 내에 콘텐츠 보존 기능이 기본적으로 적용되며, 토큰 절약용 응답 정제 기능은 옵션으로 제공될 예정입니다.

delete_page

ID로 페이지를 삭제합니다.

사용자 관리 도구

bulk_user_lookup

요청 본문에 제공된 ID들에 대한 사용자 세부 정보를 반환합니다.

search_users

🔍

NEW! 새로 추가된 기능입니다.

CQL(Confluence Query Language)을 사용하여 사용자별 쿼리로 사용자를 검색합니다.

검색 도구

search_content

📄

NEW! 새로 추가된 기능입니다.

CQL(Confluence Query Language)을 사용하여 콘텐츠를 검색합니다.

사용 예시

예를 들어,

  • Prompt로 “특정 스페이스의 페이지 목록을 조회해줘” 라고 입력하면,
  • LLM은 MCP를 통해 get_pages 도구를 호출하여 페이지 목록을 조회합니다.
  • 그리고, Tool 호출 결과를 기반으로 채팅에서 응답합니다.

OAuth 앱 설정 방법

  1. Atlassian Developer Console에서 OAuth 2.0 앱을 생성합니다.
  2. 필요한 권한 스코프를 설정합니다.
  3. 콜백 URL을 설정합니다.
  4. 생성된 Client ID와 Client Secret을 안전하게 보관합니다.

주의사항

  • 생성한 OAuth 자격 증명은 안전하게 보관하세요.
  • 필요한 최소한의 권한만 부여하는 것을 권장합니다.
  • HTTPS를 사용하는 것을 권장합니다.
  • CQL 쿼리 작성 시 Confluence의 쿼리 문법을 준수하세요.

콘텐츠 보존 관련 안내

현재 update_page 툴 사용 시, 응답 경량화를 위한 토큰 절약 방식으로 인해 이미지, 동영상, 첨부파일 등의 원본 미디어 콘텐츠가 삭제되거나 손실될 수 있습니다. 빠른 시일 내에 콘텐츠 보존 기능이 기본적으로 적용되며, 토큰 절약용 응답 정제 기능은 옵션으로 제공될 예정입니다.

제약 사항

현재는 Confluence API 응답의 ADF(JSON 형식) 문서 구조를 순회하며, 기본적인 텍스트 서식(제목, 목록, 코드 블록 등)만을 마크다운으로 변환합니다.

⚠️ 데이터 경량화(토큰 절약)를 위해 ADF 고유의 시각적·동적·구조적 기능은 의도적으로 제거되거나 단순화됩니다.

완전히 소실되는 기능:

  • media, mediaSingle: 이미지, 동영상, 첨부 파일
  • layoutSection, layoutColumn: 다단 컬럼 레이아웃 (단일 열로 평탄화)
  • extension, bodiedExtension: 목차, Jira 이슈 등 모든 매크로
  • mention: 사용자 멘션 (@username)
  • taskList, decisionList: 체크리스트 및 결정 사항
  • emoji: 이모지

단순화되는 기능:

  • table: 셀 병합, 배경색, 헤더 서식 등이 제거된 기본 마크다운 표로 변환
  • panel: 색상과 아이콘이 제거된 단순 인용문으로 변환
  • inlineCard: 미리보기가 제거된 단순 링크로 변환
  • date: YYYY-MM-DD 형식의 일반 텍스트로 변환
  • marks: 글자 색상, 위/아래 첨자 등 고급 서식 무시

⚠️ 권장 사항 이미지, 표, 레이아웃 등 중요한 서식이 포함된 페이지는 데이터 유실을 방지하기 위해 반드시 Confluence 웹에서 직접 수정 및 검토해주세요.

Last updated on
Google CalendarAtlassian (Jira)