Confluence MCP

by cosmix
Verified

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

  • Enables retrieving, searching, creating, and updating Confluence pages and spaces, as well as handling content transformation for AI consumption.

  • Referenced as a separate MCP server available from another repository, indicating integration capabilities with Jira.

コンフルエンスMCP

Confluence 用のモデル コンテキスト プロトコル (MCP) サーバー。AI アシスタントが標準化されたインターフェースを通じて Confluence コンテンツを操作できるようになります。

ℹ️ Jira には別の MCP サーバーがあります

特徴

  • 個人用APIトークンを使用してConfluenceに認証する
  • Confluence のページとスペースを取得および検索する
  • Confluence コンテンツの作成と更新
  • ページのコメントを取得して追加する
  • 添付ファイルを取得してページに追加する
  • Confluence コンテンツを AI 向けにクリーンアップして変換する
  • API通信、エラー処理、データ変換を処理する
  • APIの不正使用を防ぐための基本的なレート制限

前提条件

  • Bun (v1.0.0以上)
  • APIアクセス権限を持つConfluenceアカウント

インストール

# Clone the repository git clone https://github.com/cosmix/confluence-mcp.git cd confluence-mcp # Install dependencies bun install # Build the project bun run build

構成

この 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

ConfluenceページをIDで取得します。Formatはコンテンツの返される形式を示し、 textまたはmarkdownいずれかになります。includeMarkup includeMarkupを使用すると、元のConfluence Storage Format(XHTML)マークアップを取得できます。これは、書式設定を維持しながらページを更新するのに役立ちます。

{ "pageId": "123456", "format": "text", "includeMarkup": true }

検索ページ

CQL(Confluenceクエリ言語)を使用してConfluenceページを検索します。Formatはコンテンツの返される形式を示し、 textまたはmarkdownいずれかになります。includeMarkupパラメータincludeMarkup使用すると、各ページの元のConfluence Storage Format(XHTML)マークアップを取得できます。

{ "query": "space = DEV and label = documentation", "limit": 10, "format": "text", "includeMarkup": true }

スペースを取得する

利用可能なすべての Confluence スペースを一覧表示します。

{ "limit": 50 }

ページを作成

新しいConfluenceページを作成します。parentId 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 }

get_comments

特定の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 fileContentBase64 、ファイルコンテンツのBase64エンコードされた文字列である必要があります。

{ "pageId": "123456", "filename": "document.pdf", "fileContentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+P...", "comment": "Uploaded new version of the document" }

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENCEファイルを参照してください。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

AI アシスタントが Confluence コンテンツと対話し、ページやスペースの取得、検索、作成、更新などの操作をサポートできるようにするモデル コンテキスト プロトコル サーバー。

  1. Features
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Claude Desktop / Cline Configuration
        2. Development
          1. Available Tools
            1. get_page
            2. search_pages
            3. get_spaces
            4. create_page
            5. update_page
            6. get_comments
            7. add_comment
            8. get_attachments
            9. add_attachment
          2. LICENCE
            ID: hcc8z46c21