remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides tools for interacting with Confluence Cloud, enabling management of spaces, pages, and content through features like listing spaces, creating/reading/updating pages, converting Confluence storage format to Markdown, searching content using CQL, and managing page labels.

Confluence Cloud MCP 서버

Confluence Cloud와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 어시스턴트는 표준화된 인터페이스를 통해 Confluence 공간, 페이지 및 콘텐츠를 관리할 수 있습니다.

특징

공간 관리
- 공간 나열
- 공간 세부 정보 가져오기
페이지 작업
- 페이지 만들기, 읽기, 업데이트
- 공간에 페이지 나열
- Confluence 저장 형식의 페이지 콘텐츠를 Markdown으로 변환
검색 및 라벨
- CQL을 사용하여 콘텐츠 검색
- 페이지 라벨 관리

설정

옵션 1: Docker 사용(권장)

이 서버를 사용하는 가장 쉬운 방법은 미리 빌드된 Docker 이미지를 사용하는 것입니다.

지엑스피1

옵션 2: 지역적으로 구축

저장소를 복제합니다.

git clone https://github.com/aaronsb/confluence-cloud-mcp.git
cd confluence-cloud-mcp

로컬 빌드 스크립트를 사용하여 빌드하고 실행합니다.

# Build the Docker image
./scripts/build-local.sh

# Run the server
CONFLUENCE_API_TOKEN=your-token CONFLUENCE_EMAIL=your-email ./scripts/run-local.sh

옵션 3: 소스에서

종속성 설치:

npm install

환경 변수 구성: Confluence 자격 증명으로 .env 파일을 만듭니다.

CONFLUENCE_DOMAIN=your-domain.atlassian.net
CONFLUENCE_EMAIL=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token

프로젝트를 빌드하세요:

npm run build

서버를 실행합니다:

node build/index.js

용법

서버를 MCP 구성에 추가하여 MCP 호환 AI 어시스턴트와 통합할 수 있습니다.

{
  "mcpServers": {
    "confluence": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/aaronsb/confluence-cloud-mcp:latest"],
      "env": {
        "CONFLUENCE_DOMAIN": "your-domain.atlassian.net",
        "CONFLUENCE_EMAIL": "your-email@domain.com",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

AI 도우미를 위한 참고 사항 : 클라인과 같은 AI 도우미가 이 MCP 서버를 설치하려는 경우, 자세한 설치 지침은 llms-install.md 파일을 참조하세요.

사용 가능한 도구

우주 도구

list_confluence_spaces : Confluence의 모든 공간을 나열합니다.
get_confluence_space : 특정 공간에 대한 세부 정보를 가져옵니다.

페이지 도구

list_confluence_pages : 공간의 페이지 목록
get_confluence_page : 특정 페이지와 해당 페이지를 가져옵니다(이제 마크다운 변환 포함)
create_confluence_page : 공간에 새 페이지를 만듭니다.
update_confluence_page : 기존 페이지 업데이트

get_confluence_page 도구는 이제 Confluence 저장 형식 콘텐츠를 마크다운으로 자동 변환하여 페이지 콘텐츠 작업을 더욱 간편하게 만들어 줍니다. 변환 기능은 다음을 처리합니다.

헤더(h1-h6)
목록(순서가 있는 목록과 순서가 없는 목록)
모래밭
강조(굵게/기울임체)
코드 블록
테이블
문단과 줄 바꿈

검색 및 레이블 도구

search_confluence_pages : CQL을 사용하여 Confluence 콘텐츠 검색
get_confluence_labels : 페이지의 레이블을 가져옵니다.
add_confluence_label : 페이지에 라벨을 추가합니다.
remove_confluence_label : 페이지에서 라벨을 제거합니다.

참고 : 모든 도구 이름은 일관성과 명확성을 위해 [동사] 합류 [명사] 명명 규칙을 따릅니다.

개발

이 프로젝트는 TypeScript로 작성되었으며, 서버 기능 구현을 위한 MCP SDK 규칙을 따릅니다. 코드베이스는 다음과 같이 구성됩니다.

src/client/ - Confluence API 클라이언트 구현
src/handlers/ - MCP 도구 요청 핸들러
src/schemas/ - 도구 입력을 위한 JSON 스키마
src/types/ - TypeScript 유형 정의
src/utils/ - 콘텐츠 형식 변환을 포함한 유틸리티 함수

CI/CD 파이프라인

이 프로젝트에서는 지속적인 통합 및 배포를 위해 GitHub Actions를 사용합니다.

풀 리퀘스트에 대한 자동화된 테스트 및 린팅
메인 브랜치 커밋을 기반으로 자동 Docker 이미지 빌드
다중 아키텍처 이미지 빌드(amd64, arm64)
GitHub 컨테이너 레지스트리에 컨테이너 게시

지역 개발

로컬 개발을 위해 제공된 스크립트를 사용하세요.

./scripts/build-local.sh : 프로젝트를 빌드하고 로컬 Docker 이미지를 생성합니다.
./scripts/run-local.sh : 자격 증명을 사용하여 로컬 Docker 이미지를 실행합니다.

특허

MIT

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

AI 어시스턴트가 MCP(Model Context Protocol)를 통해 Confluence Cloud와 상호 작용하여 공간, 페이지 및 콘텐츠를 관리할 수 있도록 지원합니다.

Related Resources

Reddit Discussion about this server

Confluence MCP Server