컨플루언스 MCP

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

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

특징

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

Related MCP server: Atlassian Confluence MCP Server

필수 조건

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"
}