mcpField
C
Confluence Cloud

Confluence Cloud

ローカル
github.com生産性05 週間前に更新

Confluence Cloud について

Confluence Cloudのページ、スペース、添付ファイル、ナビゲーションを管理するMCPサーバーです。セッションで変更を追跡するブロック編集とネイティブマクロに対応し、ページ全体の書き換えを避けられます。

主な機能

  1. 01ページとスペースの管理
  2. 02追跡セッションでのブロック編集
  3. 03ネイティブマクロの処理
  4. 04添付ファイルの検索と管理
  5. 05リンクとページ階層のナビゲーション
  6. 06参照付きの一括操作

活用シーン

  1. 01ページ全体を書き換えず指定箇所を更新
  2. 02テキスト、ラベル、投稿者でページを検索
  3. 03バックリンクや関連ページを確認
  4. 04依存関係のあるConfluence操作を一括実行

MCP 対応

ページ、コンテンツ、スペース、メディア、検索、ナビゲーション、一括操作のツールをMCPクライアントに公開します。ツールのドキュメントとマクロ一覧もMCPリソースとして提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"aaronsb-confluence-cloud": {
"command": "npx",
"args": [
"-y",
"@aaronsb/confluence-cloud-mcp"
],
"env": {
"CONFLUENCE_API_TOKEN": "<CONFLUENCE_API_TOKEN>",
"CONFLUENCE_EMAIL": "<CONFLUENCE_EMAIL>",
"CONFLUENCE_HOST": "<CONFLUENCE_HOST>"
}
}
}
}
起動コマンドnpx -y @aaronsb/confluence-cloud-mcp
設定が必要な環境変数
CONFLUENCE_API_TOKENシークレットConfluence API token (generate at https://id.atlassian.com/manage/api-tokens)
CONFLUENCE_EMAILAtlassian account email address
CONFLUENCE_HOSTConfluence instance URL (e.g., https://your-team.atlassian.net)

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@aaronsb/confluence-cloud-mcp0.6.0

ツール

8

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
bodystringいいえコメントのテキスト(Markdown 形式。add_comment 用)。ページコンテンツと同じディレクティブパーサーでレンダリングされます。
labelstringいいえ削除するラベル(remove_label 操作用)
titlestringいいえページタイトル(create では必須、update では任意)
expandarrayいいえレスポンスに含める追加データ
labelsarrayいいえ追加するラベル(add_labels 操作用)
pageIdstringいいえページ ID(get、update、delete、move、copy、get_versions、pull_for_editing、get_comments、add_comment、archive、archive_tree、unarchive に必須)
spaceIdstringいいえスペース ID(create に必須、list_archived で使用可能)
parentIdstringいいえ親ページ ID(create では任意、move では必須、copy では任意)
spaceKeystringいいえスペースキー(list_archived 用)
operationenumはい実行する操作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
propertyKeystringいいえコンテンツプロパティキー(get_property、set_property、delete_property 用)
propertyValueobjectいいえJSON オブジェクト形式のコンテンツプロパティ値(set_property 用)
parentCommentIdstringいいえ返信先のコメント 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_confluenceCQL、全文検索、ラベル、投稿者を使った検索
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 を参照してください。

ライセンス

MIT ライセンス

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。