remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Connects to Atlassian's platform to access Confluence data, requiring Atlassian site credentials (site name, email, API token) for authentication and data retrieval.
Enables access to Atlassian Confluence spaces, pages, and content with tools for searching content using CQL, listing spaces, getting space details, listing pages within spaces, and retrieving full page content.
アトラシアン Confluence MCP サーバー
このプロジェクトは、AIアシスタント(AnthropicのClaude、Cursor AI、その他のMCP対応クライアントなど)とAtlassian Confluenceインスタンス間の橋渡しとして機能するModel Context Protocol(MCP)サーバーを提供します。これにより、AIはConfluenceのスペースやページに安全にアクセスし、リアルタイムで操作できるようになります。
概要
MCPとは何ですか?
モデル コンテキスト プロトコル (MCP) は、AI システムが外部ツールやデータ ソースに安全かつコンテキストに応じて接続できるようにするオープン スタンダードです。
このサーバーは Confluence Cloud 専用の MCP を実装し、Confluence データを AI アシスタントと連携させます。
このサーバーを使用する理由
- 最小限の入力、最大限の出力という理念:
spaceKey
やpageId
といったシンプルな識別子だけで十分です。各ツールは、追加のフラグを必要とせずに包括的な詳細情報を返します。 - 完全なナレッジ ベース アクセス: AI アシスタントに、ドキュメント、Wiki、ナレッジ ベース コンテンツの完全な可視性をリアルタイムで提供します。
- リッチ コンテンツのフォーマット: すべてのページ コンテンツは、適切な見出し、表、リスト、その他のフォーマット要素を使用して、Atlassian ドキュメント形式から Markdown に自動的に変換されます。
- 安全なローカル認証:認証情報はサーバーに保存されません。サーバーはローカルで実行されるため、トークンはユーザーのマシンから外部に流出することはなく、必要な権限のみを要求できます。
- 直感的なマークダウン応答: すべての応答では、一貫した書式とナビゲーション リンクを使用して読みやすくするために、適切に構造化されたマークダウンが使用されています。
はじめる
前提条件
- Node.js (>=18.x):ダウンロード
- Confluence Cloud にアクセスできるAtlassian アカウント
ステップ1: Atlassian APIトークンを取得する
- Atlassian API トークン管理ページに移動します: https://id.atlassian.com/manage-profile/security/api-tokens
- 「API トークンの作成」をクリックします。
- 説明的なラベル(例:
mcp-confluence-access
) を付けます。 - [作成]をクリックします。
- 生成された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: AIアシスタントを接続する
このサーバーを起動するには、MCP 互換クライアントを構成します。
クロード / カーソル設定:
この構成では、実行時にサーバーが自動的に起動します。
ツール
このセクションでは、このサーバーをAIアシスタントと併用する際に利用できるMCPツールについて説明します。MCPツールでは、ツール名にsnake_case
、パラメータにcamelCase
が使用されることに注意してください。
list_spaces
オプションのフィルタリングを使用して、利用可能な Confluence スペースを一覧表示します。
または:
「すべての Confluence スペースを表示します。」
get_space
ホームページ情報を含む、特定のスペースの詳細情報を取得します。
「Confluence の DEV スペースについて教えてください。」
list_pages
オプションのフィルタリングを使用して、1 つ以上のスペース内のページを一覧表示します。
または:
「スペース 123456 の現在のページを表示します。」
get_page
特定のページの完全なコンテンツとメタデータを取得します。
「Confluence ページ 12345678 のコンテンツを取得します。」
search
CQL (Confluence クエリ言語) を使用して Confluence コンテンツを検索します。
または:
「プロジェクト計画に関するページを Confluence で検索します。」
コマンドラインインターフェース (CLI)
CLI では、コマンド (例: list-spaces
) とオプション (例: --space-key
) にケバブケースが使用されます。
npx
のクイック使用
グローバルにインストール
次に直接実行します:
その他の CLI オプションを確認する
使用可能なすべてのコマンドのフラグと使用方法を表示するには、 --help
を使用します。
または、特定のコマンドの詳細なヘルプを取得します。
ライセンス
You must be authenticated.
Claude のような AI アシスタントが Atlassian Confluence コンテンツにアクセスして検索できるようにし、組織のナレッジベースとの統合を可能にするモデル コンテキスト プロトコル サーバー。