Confluence MCP

by cosmix
Verified

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

  • Enables retrieving, searching, creating, and updating Confluence pages and spaces, as well as handling content transformation for AI consumption.

  • Referenced as a separate MCP server available from another repository, indicating integration capabilities with Jira.

컨플루언스 MCP

Confluence용 MCP(Model Context Protocol) 서버는 AI 어시스턴트가 표준화된 인터페이스를 통해 Confluence 콘텐츠와 상호 작용할 수 있도록 지원합니다.

ℹ️ Jira에는 별도의 MCP 서버가 있습니다.

특징

  • 개인 API 토큰을 사용하여 Confluence에 인증합니다.
  • Confluence 페이지 및 공간 검색 및 검색
  • Confluence 콘텐츠 생성 및 업데이트
  • 페이지에 댓글 검색 및 추가
  • 페이지에 첨부 파일 검색 및 추가
  • AI 사용을 위해 Confluence 콘텐츠를 정리하고 변환합니다.
  • API 통신, 오류 처리 및 데이터 변환을 처리합니다.
  • API 남용을 방지하기 위한 기본 속도 제한

필수 조건

  • Bun (v1.0.0 이상)
  • API 액세스가 가능한 Confluence 계정

설치

지엑스피1

구성

이 MCP 서버를 사용하려면 다음 환경 변수를 설정해야 합니다.

CONFLUENCE_API_TOKEN=your_api_token CONFLUENCE_BASE_URL=your_confluence_instance_url # e.g., https://your-domain.atlassian.net/wiki CONFLUENCE_USER_EMAIL=your_email

클로드 데스크탑/클라인 구성

설정 파일에 다음 구성을 추가하세요.

{ "mcpServers": { "confluence": { "command": "bun", "args": ["/absolute/path/to/confluence-mcp/dist/index.js"], "env": { "CONFLUENCE_API_TOKEN": "your_api_token", "CONFLUENCE_BASE_URL": "your_confluence_instance_url/wiki", "CONFLUENCE_USER_EMAIL": "your_email" } } } }

개발

# Run in development mode bun run dev # Run tests bun test

사용 가능한 도구

Confluence MCP 서버는 다음과 같은 도구를 제공합니다.

get_page

ID로 Confluence 페이지를 검색합니다. 형식은 콘텐츠의 반환 형식을 나타내며 text 또는 markdown 일 수 있습니다. includeMarkup 매개변수를 사용하면 원본 Confluence Storage Format(XHTML) 마크업을 검색할 수 있으며, 이는 서식을 유지하면서 페이지를 업데이트하는 데 유용합니다.

{ "pageId": "123456", "format": "text", "includeMarkup": true }

검색 페이지

CQL(Confluence Query Language)을 사용하여 Confluence 페이지를 검색합니다. 형식은 콘텐츠의 반환 형식을 나타내며 text 또는 markdown 일 수 있습니다. includeMarkup 매개변수를 사용하면 각 페이지의 원본 Confluence Storage Format(XHTML) 마크업을 가져올 수 있습니다.

{ "query": "space = DEV and label = documentation", "limit": 10, "format": "text", "includeMarkup": true }

get_spaces

사용 가능한 모든 Confluence 공간을 나열합니다.

{ "limit": 50 }

페이지 생성

새 Confluence 페이지를 만드세요. parentId 선택 사항이며 기존 페이지 아래에 자식 페이지를 만드는 데 사용할 수 있습니다.

{ "spaceKey": "DEV", "title": "New Page Title", "content": "<p>Page content in Confluence Storage Format (XHTML)</p>", "parentId": "123456" }

업데이트_페이지

기존 Confluence 페이지를 업데이트합니다.

{ "pageId": "123456", "title": "Updated Page Title", "content": "<p>Updated content in Confluence Storage Format (XHTML)</p>", "version": 1 }

댓글을 받으세요

특정 Confluence 페이지에 대한 댓글을 검색합니다. 형식은 콘텐츠의 반환 형식을 나타내며 text 또는 markdown 일 수 있습니다.

{ "pageId": "123456", "limit": 25, "format": "text" }

댓글 추가

Confluence 페이지에 댓글을 추가하세요. parentId 스레드 답글을 만들 때 선택 사항입니다.

{ "pageId": "123456", "content": "<p>This is a new comment.</p>", "parentId": "789012" }

첨부 파일 가져오기

특정 Confluence 페이지의 첨부 파일을 검색합니다.

{ "pageId": "123456", "limit": 25 }

첨부파일 추가

Confluence 페이지에 첨부 파일을 추가합니다. fileContentBase64 는 파일 내용을 base64로 인코딩한 문자열이어야 합니다.

{ "pageId": "123456", "filename": "document.pdf", "fileContentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+P...", "comment": "Uploaded new version of the document" }

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENCE 파일을 참조하세요.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

AI 어시스턴트가 Confluence 콘텐츠와 상호 작용하여 페이지와 공간을 검색, 생성, 업데이트하는 등의 작업을 지원할 수 있는 모델 컨텍스트 프로토콜 서버입니다.

  1. Features
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Claude Desktop / Cline Configuration
        2. Development
          1. Available Tools
            1. get_page
            2. search_pages
            3. get_spaces
            4. create_page
            5. update_page
            6. get_comments
            7. add_comment
            8. get_attachments
            9. add_attachment
          2. LICENCE
            ID: hcc8z46c21