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 トークンの取得
- Atlassian API トークン管理ページ にアクセス
- 「API トークンを作成」をクリック
- トークンに名前を付けて「作成」
- 表示されたトークンをコピーして安全に保管（再表示不可）
スペース 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 トークンを設定ファイルに直接記述する方法。
手順:
.vscodeディレクトリを作成（存在しない場合）
mkdir -p .vscode.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"
}
}
}
}- VSCode を再起動
- GitHub Copilot Chat から
@confluenceとして利用可能
方法2: 推奨設定（inputs 使用）
API トークンを起動時にプロンプトで入力する方法。認証情報がファイルに残らないため安全。
手順:
.vscodeディレクトリを作成（存在しない場合）
mkdir -p .vscode.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"
}
}
}
}- VSCode を再起動
- 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 testLicense
MIT License. See LICENSE for details.
