Confluence Cloud について
Confluence Cloudのページ、スペース、添付ファイル、ナビゲーションを管理するMCPサーバーです。セッションで変更を追跡するブロック編集とネイティブマクロに対応し、ページ全体の書き換えを避けられます。
主な機能
- 01ページとスペースの管理
- 02追跡セッションでのブロック編集
- 03ネイティブマクロの処理
- 04添付ファイルの検索と管理
- 05リンクとページ階層のナビゲーション
- 06参照付きの一括操作
活用シーン
- 01ページ全体を書き換えず指定箇所を更新
- 02テキスト、ラベル、投稿者でページを検索
- 03バックリンクや関連ページを確認
- 04依存関係のあるConfluence操作を一括実行
MCP 対応
ページ、コンテンツ、スペース、メディア、検索、ナビゲーション、一括操作のツールをMCPクライアントに公開します。ツールのドキュメントとマクロ一覧もMCPリソースとして提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @aaronsb/confluence-cloud-mcpCONFLUENCE_API_TOKENシークレットConfluence API token (generate at https://id.atlassian.com/manage/api-tokens)CONFLUENCE_EMAILAtlassian account email addressCONFLUENCE_HOSTConfluence instance URL (e.g., https://your-team.atlassian.net)ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
8掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| body | string | いいえ | コメントのテキスト(Markdown 形式。add_comment 用)。ページコンテンツと同じディレクティブパーサーでレンダリングされます。 |
| label | string | いいえ | 削除するラベル(remove_label 操作用) |
| title | string | いいえ | ページタイトル(create では必須、update では任意) |
| expand | array | いいえ | レスポンスに含める追加データ |
| labels | array | いいえ | 追加するラベル(add_labels 操作用) |
| pageId | string | いいえ | ページ ID(get、update、delete、move、copy、get_versions、pull_for_editing、get_comments、add_comment、archive、archive_tree、unarchive に必須) |
| spaceId | string | いいえ | スペース ID(create に必須、list_archived で使用可能) |
| parentId | string | いいえ | 親ページ ID(create では任意、move では必須、copy では任意) |
| spaceKey | string | いいえ | スペースキー(list_archived 用) |
| operation | enum | はい | 実行する操作get | create | update | delete | move | copy | get_versions | pull_for_editing | get_comments | add_comment | get_labels | add_labels | remove_label | get_properties | get_property | set_property | delete_property | archive | archive_tree | unarchive | list_archived |
| propertyKey | string | いいえ | コンテンツプロパティキー(get_property、set_property、delete_property 用) |
| propertyValue | object | いいえ | JSON オブジェクト形式のコンテンツプロパティ値(set_property 用) |
| parentCommentId | string | いいえ | 返信先のコメント ID(add_comment では任意)。ID は get_comments から取得します。インラインコメントへの返信は、そのスレッドに追加されます。 |
詳細
Confluence Cloud MCP サーバー
Confluence Cloud と連携するための Model Context Protocol サーバーです。セッションベースの変更追跡、ネイティブマクロのサポート、グラフベースのナビゲーションによる構造化されたページ編集ができます。
インストール
Claude Desktop(ワンクリック)
confluence-cloud-mcp.mcpb をダウンロードして開くと、Claude Desktop が Confluence の認証情報を求めます。
Claude Code
claude mcp add confluence-cloud -e CONFLUENCE_API_TOKEN=your-token -e CONFLUENCE_EMAIL=your-email -e CONFLUENCE_HOST=https://your-team.atlassian.net -- npx -y @aaronsb/confluence-cloud-mcp
手動(任意の MCP クライアント)
{
"mcpServers": {
"confluence-cloud": {
"command": "npx",
"args": ["-y", "@aaronsb/confluence-cloud-mcp"],
"env": {
"CONFLUENCE_API_TOKEN": "your-api-token",
"CONFLUENCE_EMAIL": "your-email",
"CONFLUENCE_HOST": "https://your-team.atlassian.net"
}
}
}
}
認証情報
Atlassian Account Settings で API トークンを生成します。
ツール
| ツール | 説明 |
|---|---|
manage_confluence_page | ページの取得、作成、更新、削除、移動、コピー、編集用の取得 |
edit_confluence_content | 追跡中のセッション内での構造ブロック編集 — セクションのパッチ適用、追加、置換、検索/置換、同期 |
manage_confluence_space | スペースの一覧表示、詳細の取得、スペース設定の管理 |
search_confluence | CQL、全文検索、ラベル、投稿者を使った検索 |
manage_confluence_media | ページ添付ファイルのアップロード、ダウンロード、一覧表示、削除 |
navigate_confluence | ページ階層のたどり、バックリンク(GraphQL 経由)、フォワードリンク、関連ページの検出 |
queue_confluence_operations | 結果参照($0.pageId)とエラー処理方式を指定して複数の操作を一括実行 |
queue_confluence_operations は operations 配列を受け取り、それ以外の各ツールは operation パラメーターを受け取ります。ツールごとのドキュメントは、MCP リソース confluence://tools/{tool_name}/documentation で利用できます。
主な機能
セッションベースの編集 — ページを追跡対象のセッションに取り込み、個々のブロック(セクション、段落、マクロ、表)をピンポイントで編集してから、変更箇所だけを同期します。ページ全体を書き換える必要はありません。
ネイティブマクロのサポート — ステータスバッジ、情報/警告/エラーパネル、展開ブロック、目次を、読みやすい :::directive 構文で表示します。サーバーが正しいネイティブノードタイプを使って ADF をシリアライズします。
GraphQL ナビゲーション — バックリンクとフォワードリンクには、正確で高速な関係性の検出を可能にする Atlassian GraphQL ゲートウェイのリンクグラフを使用します。GraphQL を利用できない場合は REST にフォールバックします。
レンダリングファサード — すべての応答は、次の手順を状況に応じて案内するヒント付きの、トークン効率に優れた Markdown です。生の JSON は返しません。
MCP リソース
| リソース | 説明 |
|---|---|
confluence://macros | パラメータースキーマと使用例を含む、利用可能なマクロのレジストリ |
アーキテクチャ
5 層アーキテクチャ、ハイブリッドクライアント、コンテンツモデル、セッション編集、マクロ処理、ナビゲーション、レンダリングファサードを扱う 8 つの ADR については、docs/architecture/INDEX.md を参照してください。
ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。