コンフルエンスMCP

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

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

特徴

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

Related MCP server: Atlassian Confluence MCP Server

前提条件

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"
}