Skip to Content
User Guide🧩 利用可能なMCPサーバーAtlassian (Confluence)

Atlassian Confluence

Atlassian Confluenceと連携してチーム協業および文書化プラットフォームを管理できます。

主要機能

  • ページとブログ投稿管理
  • スペースと権限管理
  • コンテンツ検索と照会
  • ユーザー検索と管理
  • コメントと協業機能
  • 添付ファイル管理

基本情報

認証方式

OAuth 2.0を使用して認証します。

必要な権限

  • delete:page:confluence: ページ削除
  • offline_access: オフラインアクセス
  • read:me: ユーザー情報読み取り
  • read:page:confluence: ページ読み取り
  • read:space:confluence: スペース読み取り
  • read:user:confluence: ユーザー情報読み取り
  • write:page:confluence: ページ書き込み
  • search:confluence: 検索機能
  • read:content-details:confluence: コンテンツ詳細情報読み取り

サポートするMCPツール

スペース管理ツール

get_spaces

すべてのスペース一覧を返します。結果はID昇順でソートされ、limitパラメータで結果数を制限できます。

ページ管理ツール

get_pages

すべてのページ一覧を返します。結果数はlimitパラメータで制限でき、追加結果はLinkレスポンスヘッダーのnext URLで確認できます。

get_page_by_id

特定ページの詳細情報を照会します。

create_page

スペースに新しいページを作成します。

update_page

IDでページを更新します。

🛠️

注意： update_page ツールを使用すると、画像や動画などの元のコンテンツが失われる可能性があります。重要なメディアを含むページは、Confluence上で直接編集することを推奨します。 コンテンツの保持は今後デフォルト動作となり、現在のトークン節約のための簡略化更新はオプション設定として提供される予定です。

delete_page

IDでページを削除します。

ユーザー管理ツール

bulk_user_lookup

リクエスト本文に提供されたIDのユーザー詳細情報を返します。

search_users

🔍

新機能！ 新しく追加された機能です。

CQL（Confluence Query Language）を使用してユーザー固有のクエリでユーザーを検索します。

検索ツール

search_content

📄

新機能！ 新しく追加された機能です。

CQL（Confluence Query Language）を使用してコンテンツを検索します。

使用例

例えば、

  • プロンプトで「特定スペースのページ一覧を照会して」と入力すると、
  • LLMはMCPを通じてget_pagesツールを呼び出してページ一覧を照会します。
  • そして、ツール呼び出し結果に基づいてチャットで応答します。

OAuthアプリ設定方法

  1. Atlassian Developer ConsoleでOAuth 2.0アプリを作成します。
  2. 必要な権限スコープを設定します。
  3. コールバックURLを設定します。
  4. 生成されたClient IDとClient Secretを安全に保管します。

注意事項

  • 生成されたOAuth認証情報は安全に保管してください。
  • 必要最小限の権限のみを付与することを推奨します。
  • HTTPSを使用することを推奨します。
  • CQLクエリ作成時はConfluenceのクエリ構文に従ってください。

コンテンツ保全に関するご案内

現在、update_page ツールを使用する際、レスポンス軽量化のためのトークン節約方式により、画像、動画、添付ファイルなどの元のメディアコンテンツが削除または損失する可能性があります。 近いうちにコンテンツ保全機能がデフォルトで適用され、トークン節約用のレスポンス整形機能はオプションとして提供される予定です。

制約事項

現在は、Confluence APIレスポンスのADF（JSON形式）ドキュメント構造を走査し、見出し、リスト、コードブロックなどの基本的なテキスト書式のみをMarkdownに変換します。

⚠️ データ軽量化（トークン節約）のため、ADF固有の視覚的・動的・構造的な機能は意図的に削除または簡略化されます。

完全に失われる機能:

  • media, mediaSingle: 画像、動画、添付ファイル
  • layoutSection, layoutColumn: 複数カラムレイアウト（単一列に平坦化）
  • extension, bodiedExtension: 目次、Jira課題などすべてのマクロ
  • mention: ユーザーメンション（@username）
  • taskList, decisionList: チェックリストおよび決定事項
  • emoji: 絵文字

簡略化される機能:

  • table: セル結合、背景色、ヘッダー書式などが削除された基本的なMarkdown表に変換
  • panel: 色とアイコンが削除された単純な引用文に変換
  • inlineCard: プレビューが削除された単純なリンクに変換
  • date: YYYY-MM-DD形式の通常テキストに変換
  • marks: 文字色、上付き/下付き文字などの高度な書式は無視

⚠️ 推奨事項 画像、表、レイアウトなど重要な書式が含まれるページは、データ損失を防ぐため、必ずConfluence Webで直接編集および確認してください。

Last updated on
Box MCPAtlassian (Jira)