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
Connects to Atlassian's platform to access Confluence data, requiring Atlassian site credentials (site name, email, API token) for authentication and data retrieval.
Enables access to Atlassian Confluence spaces, pages, and content with tools for searching content using CQL, listing spaces, getting space details, listing pages within spaces, and retrieving full page content.
Atlassian Confluence MCP 서버
이 프로젝트는 AI 어시스턴트(Anthropic의 Claude, Cursor AI 또는 기타 MCP 호환 클라이언트 등)와 Atlassian Confluence 인스턴스를 연결하는 모델 컨텍스트 프로토콜(MCP) 서버를 제공합니다. 이를 통해 AI는 Confluence 스페이스 및 페이지에 실시간으로 안전하게 접근하고 상호 작용할 수 있습니다.
개요
MCP란 무엇인가요?
MCP(Model Context Protocol)는 AI 시스템이 외부 도구 및 데이터 소스와 안전하고 상황에 맞게 연결할 수 있도록 하는 개방형 표준입니다.
이 서버는 Confluence Cloud를 위해 특별히 MCP를 구현하여 Confluence 데이터와 AI 도우미를 연결합니다.
왜 이 서버를 사용해야 하나요?
- 최소 입력, 최대 출력 철학 :
spaceKey및pageId와 같은 간단한 식별자만 있으면 됩니다. 각 도구는 추가 플래그 없이 포괄적인 세부 정보를 반환합니다. - 지식 기반 전체에 대한 접근 : AI 비서에게 문서, 위키, 지식 기반 콘텐츠에 대한 전체 가시성을 실시간으로 제공합니다.
- 풍부한 콘텐츠 형식 : 모든 페이지 콘텐츠는 적절한 제목, 표, 목록 및 기타 서식 요소를 포함하여 Atlassian 문서 형식에서 Markdown으로 자동 변환됩니다.
- 안전한 로컬 인증 : 자격 증명은 서버에 저장되지 않습니다. 서버는 로컬에서 실행되므로 토큰이 사용자 컴퓨터 외부로 유출되지 않으며, 필요한 권한만 요청할 수 있습니다.
- 직관적인 마크다운 응답 : 모든 응답은 일관된 서식과 탐색 링크를 통해 가독성을 높이기 위해 잘 구성된 마크다운을 사용합니다.
시작하기
필수 조건
- Node.js (>=18.x): 다운로드
- Confluence Cloud에 액세스할 수 있는 Atlassian 계정
1단계: Atlassian API 토큰 받기
- Atlassian API 토큰 관리 페이지로 이동하세요: https://id.atlassian.com/manage-profile/security/api-tokens
- API 토큰 만들기를 클릭합니다.
- 설명적인 라벨을 지정합니다(예:
mcp-confluence-access). - 만들기를 클릭합니다.
- 생성된 API 토큰을 즉시 복사하세요 . 다시 볼 수 없습니다.
2단계: 자격 증명 구성
방법 A: MCP 구성 파일(권장)
~/.mcp/configs.json 생성하거나 편집합니다.
지엑스피1
<YOUR_SITE_NAME>: Confluence 사이트 이름(예:mycompany.atlassian.net의 경우mycompany).<YOUR_ATLASSIAN_EMAIL>: Atlassian 계정 이메일입니다.<YOUR_COPIED_API_TOKEN>: 1단계의 API 토큰입니다.
방법 B: 환경 변수
서버를 실행할 때 자격 증명을 직접 전달합니다.
3단계: AI 도우미 연결
이 서버를 실행하려면 MCP 호환 클라이언트를 구성하세요.
Claude / 커서 구성:
이 구성을 사용하면 런타임에 서버가 자동으로 시작됩니다.
도구
이 섹션에서는 이 서버를 AI 어시스턴트와 함께 사용할 때 사용할 수 있는 MCP 도구에 대해 설명합니다. MCP 도구는 도구 이름에는 snake_case , 매개변수에는 camelCase 사용합니다.
list_spaces
선택적 필터링을 사용하여 사용 가능한 Confluence 공간을 나열합니다.
또는:
"Confluence의 모든 공간을 보여주세요."
get_space
홈페이지 정보를 포함하여 특정 공간에 대한 전체 세부 정보를 얻으세요.
"Confluence의 DEV 공간에 대해 말씀해 주세요."
list_pages
선택적 필터링을 사용하여 하나 이상의 공간에 있는 페이지를 나열합니다.
또는:
"123456공간의 현재 페이지를 보여주세요."
get_page
특정 페이지의 전체 콘텐츠와 메타데이터를 가져옵니다.
"Confluence 페이지 12345678의 내용을 가져옵니다."
search
CQL(Confluence Query Language)을 사용하여 Confluence 콘텐츠를 검색합니다.
또는:
"프로젝트 계획에 대한 페이지를 Confluence에서 검색하세요."
명령줄 인터페이스(CLI)
CLI는 명령(예: list-spaces )과 옵션(예: --space-key )에 케밥 케이스를 사용합니다.
npx 로 빠르게 사용하기
글로벌 설치
그런 다음 직접 실행하세요.
더 많은 CLI 옵션 알아보기
--help 사용하면 사용 가능한 모든 명령에 대한 플래그와 사용법을 확인할 수 있습니다.
또는 특정 명령에 대한 자세한 도움말을 받으세요.
특허
You must be authenticated.
Claude와 같은 AI 도우미가 Atlassian Confluence 콘텐츠에 액세스하고 검색할 수 있도록 하는 모델 컨텍스트 프로토콜 서버로, 조직의 지식 기반과 통합할 수 있습니다.