Atlassian Confluence MCP Server

アトラシアン Confluence MCP サーバー

Atlassian Confluence Cloud 用の Node.js/TypeScript Model Context Protocol (MCP) サーバー。AI システム（Claude や Cursor AI などの LLM など）が Confluence のスペース、ページ、コンテンツと安全にリアルタイムでやり取りできるようにします。

このサーバーを使用する理由

• 最小限の入力、最大限の出力: シンプルな識別子により、追加のフラグを必要とせずに包括的な詳細が提供されます。
• 完全なナレッジベース アクセス: AI アシスタントにドキュメント、Wiki、ナレッジベース コンテンツの可視性を提供します。
• リッチ コンテンツのフォーマット: Atlassian ドキュメント形式を読み取り可能な Markdown に自動変換します。
• 安全なローカル認証: 資格情報を使用してローカルで実行し、トークンをリモート サーバーに保存することはありません。
• 直感的な Markdown 応答: すべての出力に対して、適切に構造化された一貫した Markdown 形式が採用されています。

MCPとは何ですか?

モデルコンテキストプロトコル（MCP）は、AIシステムを外部ツールやデータソースに安全に接続するためのオープンスタンダードです。このサーバーはConfluence Cloud向けにMCPを実装しており、AIアシスタントがConfluenceコンテンツをプログラム的に操作できるようにします。

前提条件

• Node.js (>=18.x):ダウンロード
• Confluence Cloud にアクセスできるAtlassian アカウント

設定

ステップ1: Atlassian APIトークンを取得する

1. Atlassian API トークン管理ページに移動します: https://id.atlassian.com/manage-profile/security/api-tokens
2. 「API トークンの作成」をクリックします。
3. 説明的なラベル(例: mcp-confluence-access ) を付けます。
4. [作成]をクリックします。
5. 生成されたAPIトークンはすぐにコピーしてください。再度表示することはできません。

ステップ2: 資格情報を構成する

オプション A: MCP 構成ファイル (推奨)

~/.mcp/configs.jsonを編集または作成します。

• <YOUR_SITE_NAME> : Confluence サイト名 (例: mycompany.atlassian.netの場合はmycompany )。
• <YOUR_ATLASSIAN_EMAIL> : Atlassian アカウントのメール アドレス。
• <YOUR_COPIED_API_TOKEN> : ステップ 1 の API トークン。

オプションB: 環境変数

ステップ3: インストールと実行

npxのクイックスタート

グローバルインストール

ステップ4：AIアシスタントに接続する

MCP 互換クライアント (例: Claude、Cursor AI) を構成します。

MCPツール

MCP ツールは、 snake_case名、 camelCaseパラメータを使用し、Markdown 形式の応答を返します。

• conf_ls_spaces : アクセス可能な Confluence スペースを一覧表示します ( type : str opt、 status : str opt、 limit : num opt、 cursor : str opt)。使用方法: 利用可能なスペースを表示します。
• conf_get_space : スペースの詳細情報を取得します（ spaceKey : str req）。用途: スペースのコンテンツとメタデータにアクセスします。
• conf_ls_pages : フィルタリングされたページを一覧表示します（ spaceIds : str[] opt、 spaceKeys : str[] opt、 title : str opt、 status : str[] opt、 sort : str opt、 limit : num opt、 cursor : str opt）。使用方法: 条件に一致するページを検索します。
• conf_get_page : 包括的なページコンテンツを取得します（ pageId : 文字列が必要です）。使用方法: ページ全体のコンテンツをMarkdown形式で表示します。
• conf_ls_page_comments : ページ（ pageId ：文字列必須）のコメントを一覧表示します。用途：ページのディスカッションを読み取ります。
• conf_search : Confluenceコンテンツを検索します（ cql : str opt、 query : str opt、 title : str opt、 spaceKey : str opt、 labels : str[] opt、 contentType : str opt、 limit : num opt、 cursor : str opt）。使用方法: 特定のコンテンツを検索します。

conf_ls_spaces

グローバルスペースの一覧:

conf_get_space

スペースの詳細を取得:

conf_ls_pages

スペースとタイトル別にページを一覧表示:

複数のスペースからページを一覧表示する:

conf_get_page

ページコンテンツを取得:

conf_ls_page_comments

リストページのコメント:

conf_search

シンプル検索:

高度な CQL 検索:

CLIコマンド

CLIコマンドはkebab-caseを使用します。詳細については、 --helpを実行してください（例： mcp-atlassian-confluence ls-spaces --help ）。

• ls-spaces : スペースを一覧表示します（ --type 、 --status 、 --limit 、 --cursor ）。例： mcp-atlassian-confluence ls-spaces --type global 。
• get-space : スペースの詳細を取得します ( --space-key )。例: mcp-atlassian-confluence get-space --space-key DEV 。
• ls-pages : ページを一覧表示します（ --space-keys 、 --title 、 --status 、 --sort 、 --limit 、 --cursor ）。例： mcp-atlassian-confluence ls-pages --space-keys DEV 。
• get-page : ページコンテンツを取得します（ --page-id ）。例： mcp-atlassian-confluence get-page --page-id 12345678 。
• ls-page-comments : コメントを一覧表示します ( --page-id )。例: mcp-atlassian-confluence ls-page-comments --page-id 12345678 。
• search : コンテンツを検索します（ --cql 、 --query 、 --space-key 、 --label 、 --type 、 --limit 、 --cursor ）。例： mcp-atlassian-confluence search --query "security" 。

リストスペース

グローバルスペースの一覧:

スペースを取得する

リストページ

複数のスペースキーを使用する場合:

タイトルフィルター付き:

ページを取得

リストページのコメント

検索

シンプル検索:

CQL 検索:

応答フォーマット

すべての回答は Markdown 形式です。これには以下が含まれます。

• タイトル: コンテンツの種類と名前。
• コンテンツ: ページ全体のコンテンツ、検索結果、またはアイテムのリスト。
• メタデータ: 作成者、日付、ラベル、その他の関連情報。
• ページ区切り: ページ区切りされた結果のナビゲーション情報。
• リンク: 該当する場合の関連リソースへの参照。

スペースリスト応答

ページコンテンツレスポンス

発達

貢献

貢献を歓迎します！ご協力をお願いします:

1. リポジトリをフォークします。
2. 機能ブランチを作成します ( git checkout -b feature/xyz )。
3. 変更をコミットします ( git commit -m "Add xyz feature" )。
4. ブランチにプッシュします ( git push origin feature/xyz )。
5. プルリクエストを開きます。

詳細については、 CONTRIBUTING.md を参照してください。

ライセンス

ISCライセンス