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

Provides tools for interacting with Confluence Cloud, enabling management of spaces, pages, and content through features like listing spaces, creating/reading/updating pages, converting Confluence storage format to Markdown, searching content using CQL, and managing page labels.

Confluence Cloud MCP サーバー

Confluence Cloud と連携するためのツールを提供する Model Context Protocol (MCP) サーバー。このサーバーにより、AI アシスタントは標準化されたインターフェースを通じて Confluence のスペース、ページ、コンテンツを管理できるようになります。

特徴

スペース管理
- スペースをリストする
- スペースの詳細を取得する
ページ操作
- ページの作成、閲覧、更新
- スペース内のページを一覧表示する
- Confluence のストレージ形式から Markdown にページコンテンツを変換する
検索とラベル
- CQL を使用してコンテンツを検索する
- ページラベルを管理する

設定

オプション 1: Docker を使用する (推奨)

このサーバーを使用する最も簡単な方法は、事前に構築された Docker イメージを使用することです。

docker run --rm -i \
  -e CONFLUENCE_API_TOKEN=your-api-token \
  -e CONFLUENCE_EMAIL=your-email@domain.com \
  -e CONFLUENCE_DOMAIN=your-domain.atlassian.net \
  ghcr.io/aaronsb/confluence-cloud-mcp:latest

オプション2: ローカルで構築する

リポジトリをクローンします。

git clone https://github.com/aaronsb/confluence-cloud-mcp.git
cd confluence-cloud-mcp

ローカルビルドスクリプトを使用してビルドおよび実行します。

# Build the Docker image
./scripts/build-local.sh

# Run the server
CONFLUENCE_API_TOKEN=your-token CONFLUENCE_EMAIL=your-email ./scripts/run-local.sh

オプション3: ソースから

依存関係をインストールします:

npm install

環境変数を設定する: Confluence の資格情報を使用して.envファイルを作成します。

CONFLUENCE_DOMAIN=your-domain.atlassian.net
CONFLUENCE_EMAIL=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token

プロジェクトをビルドします。

npm run build

サーバーを実行します。

node build/index.js

使用法

サーバーを MCP 構成に追加することで、MCP 対応の AI アシスタントと統合できます。

{
  "mcpServers": {
    "confluence": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/aaronsb/confluence-cloud-mcp:latest"],
      "env": {
        "CONFLUENCE_DOMAIN": "your-domain.atlassian.net",
        "CONFLUENCE_EMAIL": "your-email@domain.com",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

AI アシスタント向けの注意: Cline のような AI アシスタントがこの MCP サーバーをインストールしようとしている場合は、詳細なインストール手順についてはllms-install.mdファイルを参照してください。

利用可能なツール

宇宙ツール

list_confluence_spaces : Confluence 内のすべてのスペースを一覧表示します
get_confluence_space : 特定のスペースの詳細を取得する

ページツール

list_confluence_pages : スペース内のページを一覧表示する
get_confluence_page : 特定のページとそのコンテンツを取得します（Markdown 変換が含まれるようになりました）
create_confluence_page : スペースに新しいページを作成する
update_confluence_page : 既存のページを更新する

get_confluence_pageツールは、Confluence ストレージ形式のコンテンツを Markdown に自動変換するようになりました。これにより、ページコンテンツの操作が容易になります。この変換処理では、以下の処理が行われます。

ヘッダー（h1-h6）
リスト（順序付きと順序なし）
リンク
強調（太字/斜体）
コードブロック
テーブル
段落と改行

検索とラベルツール

search_confluence_pages : CQL を使用して Confluence コンテンツを検索する
get_confluence_labels : ページのラベルを取得する
add_confluence_label : ページにラベルを追加する
remove_confluence_label : ページからラベルを削除する

注: すべてのツール名は、一貫性と明確さを保つために [動詞]合流[名詞] の命名規則に従います。

発達

このプロジェクトはTypeScriptで記述されており、サーバー機能を実装するためのMCP SDK規約に準拠しています。コードベースは以下のとおりです。

src/client/ - Confluence API クライアント実装
src/handlers/ - MCP ツールリクエストハンドラー
src/schemas/ - ツール入力用のJSONスキーマ
src/types/ - TypeScript 型定義
src/utils/ - コンテンツ形式の変換を含むユーティリティ関数

CI/CDパイプライン

このプロジェクトでは、継続的な統合とデプロイメントに GitHub Actions を使用します。

プルリクエストの自動テストとリンティング
メインブランチのコミット時に Docker イメージを自動ビルド
マルチアーキテクチャイメージビルド (amd64、arm64)
GitHub Container Registryへのコンテナ公開

地域開発

ローカル開発の場合は、提供されているスクリプトを使用します。

./scripts/build-local.sh : プロジェクトをビルドし、ローカル Docker イメージを作成します
./scripts/run-local.sh : 資格情報を使用してローカルの Docker イメージを実行します

ライセンス

マサチューセッツ工科大学

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

AI アシスタントが Confluence Cloud と対話して、モデルコンテキストプロトコル (MCP) を介してスペース、ページ、コンテンツを管理できるようにします。

Related Resources

Reddit Discussion about this server

Confluence MCP Server