mcp-confluence

Confluence の検索・ページ取得機能を提供する MCP サーバー。

インストール

バイナリをダウンロード

Releases ページ から環境に合ったバイナリをダウンロード：

| プラットフォーム | ファイル名 | |------------------|------------| | macOS (Apple Silicon) | mcp-confluence-darwin-arm64 | | Linux (x64) | mcp-confluence-linux-x64 | | Windows (x64) | mcp-confluence-windows-x64.exe |

ダウンロード後、PATH の通った場所に配置して実行権限を付与：

chmod +x mcp-confluence-*
mv mcp-confluence-* ~/.local/bin/mcp-confluence

ソースからビルド

git clone https://github.com/tjun1/mcp-confluence.git
cd mcp-confluence
./install.sh

~/.local/bin/mcp-confluence にバイナリがインストールされる。

前提条件: Bun がインストールされていること。

セットアップ

Atlassian API トークンの取得

1. Atlassian API トークン管理ページ にアクセス
2. 「API トークンを作成」をクリック
3. トークンに名前を付けて「作成」
4. 表示されたトークンをコピーして安全に保管（再表示不可）

スペース ID の確認方法

Confluence のスペースを開き、URL を確認する：

https://your-domain.atlassian.net/wiki/spaces/SPACE_KEY/...
                                         ^^^^^^^^^^
                                         これがスペースキー

または、スペース設定 → スペースの詳細 で確認できる。

環境変数

| 変数名 | 必須 | 説明 | |--------|------|------| | CONFLUENCE_BASE_URL | ○ | Confluence の URL（例: https://your-domain.atlassian.net/wiki） | | CONFLUENCE_EMAIL | △ | Atlassian アカウントのメールアドレス | | CONFLUENCE_API_TOKEN | △ | Atlassian API トークン | | CONFLUENCE_BEARER_TOKEN | △ | Bearer トークン（Email + API Token の代わりに使用可） | | CONFLUENCE_DEFAULT_SPACES | - | 検索対象のスペースをカンマ区切りで指定（例: SPACE1,SPACE2） |

認証方式: CONFLUENCE_EMAIL + CONFLUENCE_API_TOKEN（Basic認証）または CONFLUENCE_BEARER_TOKEN のいずれかが必要。

MCP クライアントへの設定

グローバル設定（~/.claude/）

すべてのプロジェクトで使いたい場合、~/.claude/claude_desktop_config.json に設定する：

{
  "mcpServers": {
    "confluence": {
      "command": "/Users/your-name/.local/bin/mcp-confluence",
      "args": [],
      "env": {
        "CONFLUENCE_BASE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_EMAIL": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "CONFLUENCE_DEFAULT_SPACES": "SPACE1,SPACE2"
      }
    }
  }
}

プロジェクトローカル設定（.mcp.json）

特定のプロジェクトでのみ使いたい場合、プロジェクトルートに .mcp.json を作成する：

{
  "mcpServers": {
    "confluence": {
      "command": "/Users/your-name/.local/bin/mcp-confluence",
      "args": [],
      "env": {
        "CONFLUENCE_BASE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_EMAIL": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "CONFLUENCE_DEFAULT_SPACES": "PROJECT_SPACE"
      }
    }
  }
}

.mcp.json をバージョン管理しない

.mcp.json には API トークンなどの認証情報が含まれるため、絶対にバージョン管理に含めてはいけない。

.gitignore に追加：

.mcp.json

チームで設定を共有したい場合は、.mcp.json.example のようなテンプレートファイルを用意し、各自がコピーして使う運用にする。

VSCode + GitHub Copilot

VSCode の GitHub Copilot から mcp-confluence を利用できる。

前提条件:

• VS Code 1.102 以降
• GitHub Copilot 拡張機能
• GitHub Copilot Chat 拡張機能

セットアップ手順

プロジェクトルートに .vscode/mcp.json を作成する。設定方法は2つある。

方法1: シンプルな設定（inputs 不使用）

API トークンを設定ファイルに直接記述する方法。

手順:

1. .vscode ディレクトリを作成（存在しない場合）

   mkdir -p .vscode

1. .vscode/mcp.json を作成して以下を記述

   {
     "servers": {
       "confluence": {
         "command": "$HOME/.local/bin/mcp-confluence",
         "args": [],
         "env": {
           "CONFLUENCE_BASE_URL": "https://your-domain.atlassian.net/wiki",
           "CONFLUENCE_EMAIL": "your-email@example.com",
           "CONFLUENCE_API_TOKEN": "your-api-token",
           "CONFLUENCE_DEFAULT_SPACES": "SPACE1,SPACE2"
         }
       }
     }
   }

1. VSCode を再起動
2. GitHub Copilot Chat から @confluence として利用可能

方法2: 推奨設定（inputs 使用）

API トークンを起動時にプロンプトで入力する方法。認証情報がファイルに残らないため安全。

手順:

1. .vscode ディレクトリを作成（存在しない場合）

   mkdir -p .vscode

1. .vscode/mcp.json を作成して以下を記述

   {
     "inputs": {
       "confluenceApiToken": {
         "type": "promptString",
         "password": true,
         "description": "Confluence API Token"
       }
     },
     "servers": {
       "confluence": {
         "command": "$HOME/.local/bin/mcp-confluence",
         "args": [],
         "env": {
           "CONFLUENCE_BASE_URL": "https://your-domain.atlassian.net/wiki",
           "CONFLUENCE_EMAIL": "your-email@example.com",
           "CONFLUENCE_API_TOKEN": "${input:confluenceApiToken}",
           "CONFLUENCE_DEFAULT_SPACES": "SPACE1,SPACE2"
         }
       }
     }
   }

1. VSCode を再起動
2. GitHub Copilot を使用する際、API トークンの入力プロンプトが表示される（password: true により入力内容は隠される）

サンプルファイルの利用

プロジェクトルートの mcp.vscode.example.json をコピーして使うこともできる：

mkdir -p .vscode
cp mcp.vscode.example.json .vscode/mcp.json
# エディタで .vscode/mcp.json を開いて環境に合わせて編集

Claude Desktop との形式の違い

| 項目 | Claude Desktop | VSCode | |------|----------------|--------| | 設定ファイル | ~/.claude/claude_desktop_config.json または .mcp.json | .vscode/mcp.json | | ルートキー | mcpServers | servers | | command | 絶対パスが必要 | $HOME 変数が使える | | 機密情報 | env に直接記述 | inputs で変数化可能 |

注意事項

• .vscode/mcp.json には認証情報が含まれるため、バージョン管理から除外すること（.gitignore に追加済み）
• チームで設定を共有する場合は、各自が mcp.vscode.example.json をコピーして .vscode/mcp.json を作成する運用にする

利用可能なツール

MCP クライアント（Claude など）に対して、ツール名を明示して指示するのが基本。 ただし、会話の文脈から判断してくれることもあるため、必須ではない。

confluence_search

Confluence のコンテンツを検索する。

使い方の例:

• 「confluence_search を使って最新のスプリントレビューを探して」
• 「confluence_search でミーティング記録を検索して、新しい順に5件」

confluence_get_page

ページの内容を取得する。

使い方の例:

• 「confluence_get_page でそのページの内容を見せて」
• 「confluence_get_page でページID 12345678 の詳細を取得して」

開発者向け情報

開発環境のセットアップ

git clone https://github.com/tjun1/mcp-confluence.git
cd mcp-confluence
bun install

環境変数の設定

.env ファイルを作成（Bun が自動で読み込む）：

CONFLUENCE_BASE_URL=https://your-domain.atlassian.net/wiki
CONFLUENCE_EMAIL=your-email@example.com
CONFLUENCE_API_TOKEN=your-api-token
CONFLUENCE_DEFAULT_SPACES=DEV,TEST

実行

bun run src/index.ts

テスト

bun test

License

MIT License. See LICENSE for details.