Confluence MCP Server

Enables page search and retrieval from Confluence using the Model Context Protocol

README.md

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 관한 내용 찾아줘
...

Tools 2

confluence_searchSearches for pages in Confluence using CQL (Confluence Query Language).
confluence_get_pageRetrieves the content of a specific Confluence page by its ID and converts HTML to text.

Environment Variables

CONFLUENCE_BASE_URLrequiredThe base URL of your Confluence instance (e.g., https://your-domain.atlassian.net)
CONFLUENCE_PATrequiredPersonal Access Token for Confluence authentication

Try it

Search for Confluence pages related to the project roadmap.
Find all documents mentioning 'Q4 strategy' in Confluence.
Get the content of the page with ID 12345 and summarize it for me.
Search for recent meeting notes regarding the new feature launch.

Frequently Asked Questions

What are the key features of Confluence MCP Server?

Search Confluence pages using CQL queries. Retrieve full page content by ID. Automatic conversion of Confluence HTML content to plain text for Claude. Secure authentication via Personal Access Tokens.

What can I use Confluence MCP Server for?

Quickly finding internal documentation without leaving the Claude interface. Summarizing long Confluence project pages into actionable tasks. Cross-referencing technical requirements stored in Confluence with current coding tasks. Extracting meeting notes to generate follow-up emails or summaries.

How do I install Confluence MCP Server?

Install Confluence MCP Server by running: npm install && npm run build

What MCP clients work with Confluence MCP Server?

Confluence MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Confluence MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare