Confluence MCP Server

Confluence API를 사용하여 페이지 검색 및 조회 기능을 제공하는 MCP(Model Context Protocol) 서버입니다.

기능

Tools

Tool	설명
confluence_search	CQL을 사용하여 Confluence에서 페이지를 검색합니다
confluence_get_page	페이지 ID로 본문을 가져옵니다 (HTML을 텍스트로 변환)

설치

npm install
npm run build

Personal Access Token 발급

1. Confluence 설정 > Personal Access Tokens 이동
2. "Create token" 클릭
3. 토큰 이름 입력 후 생성

Claude Desktop 설정

claude_desktop_config.json에 다음을 추가합니다:

위 파일의 경로 macOS 기준:

  ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "confluence": {
      "command": "node",
      "args": ["/path/to/confluence-mcp/dist/server.js"],
      "env": {
        "CONFLUENCE_BASE_URL": "https://your-domain.atlassian.net",
        "CONFLUENCE_PAT": "your-personal-access-token"
      }
    }
  }
}

.env 파일 대신 위처럼 env 필드에 직접 설정해도 됩니다.

사용 예시

1. mcp server 를 실행한다.
2. claude desktop을 킨후 + 커넥터를 보고 연동이 되었는지 확인 합니다. (이때 안 켜졌다면 claude desktop을 완전히 종료 후 실행)
3. 그 후 claude desktop 채팅창에 아래와 같이 검색합니다.

페이지 검색:

Confluence에서 관련 문서를 검색해줘
playMcp 관한 내용 찾아줘
...