컨플루언스 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": "Page content in Confluence Storage Format (XHTML)", "parentId": "123456" }

업데이트_페이지

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

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

댓글을 받으세요

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

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

댓글 추가

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

{ "pageId": "123456", "content": "This is a new comment.", "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" }