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

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

NPMバージョンビルドステータス

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

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

Related MCP server: Confluence MCP

MCPとは何ですか?

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

前提条件

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を編集または作成します。

{
	"confluence": {
		"environments": {
			"ATLASSIAN_SITE_NAME": "<YOUR_SITE_NAME>",
			"ATLASSIAN_USER_EMAIL": "<YOUR_ATLASSIAN_EMAIL>",
			"ATLASSIAN_API_TOKEN": "<YOUR_COPIED_API_TOKEN>"
		}
	}
}

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

オプションB: 環境変数

export ATLASSIAN_SITE_NAME="<YOUR_SITE_NAME>"
export ATLASSIAN_USER_EMAIL="<YOUR_EMAIL>"
export ATLASSIAN_API_TOKEN="<YOUR_API_TOKEN>"

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

`npx`のクイックスタート

npx -y @aashari/mcp-server-atlassian-confluence ls-spaces

グローバルインストール

npm install -g @aashari/mcp-server-atlassian-confluence
mcp-atlassian-confluence ls-spaces

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

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

{
	"mcpServers": {
		"confluence": {
			"command": "npx",
			"args": ["-y", "@aashari/mcp-server-atlassian-confluence"]
		}
	}
}

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`

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

{ "type": "global", "status": "current", "limit": 10 }

`conf_get_space`

スペースの詳細を取得:

{ "spaceKey": "DEV" }

`conf_ls_pages`

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

{
	"spaceKeys": ["DEV"],
	"title": "API Documentation",
	"status": ["current"],
	"sort": "-modified-date"
}

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

{
	"spaceKeys": ["DEV", "HR", "MARKETING"],
	"limit": 15,
	"sort": "-modified-date"
}

`conf_get_page`

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

{ "pageId": "12345678" }

`conf_ls_page_comments`

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

{ "pageId": "12345678" }

`conf_search`

シンプル検索:

{
	"query": "release notes Q1",
	"spaceKey": "PRODUCT",
	"contentType": "page",
	"limit": 5
}

高度な CQL 検索:

{ "cql": "space = DEV AND label = api AND created >= '2023-01-01'" }

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" 。

リストスペース

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

mcp-atlassian-confluence ls-spaces --type global --status current --limit 10

スペースを取得する

mcp-atlassian-confluence get-space --space-key DEV

リストページ

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

mcp-atlassian-confluence ls-pages --space-keys DEV HR MARKETING --limit 15 --sort "-modified-date"

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

mcp-atlassian-confluence ls-pages --space-keys DEV --title "API Documentation" --status current

ページを取得

mcp-atlassian-confluence get-page --page-id 12345678

リストページのコメント

mcp-atlassian-confluence ls-page-comments --page-id 12345678

検索

シンプル検索:

mcp-atlassian-confluence search --query "security best practices" --space-key DOCS --type page --limit 5

CQL 検索:

mcp-atlassian-confluence search --cql "label = official-docs AND creator = currentUser()"

応答フォーマット

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

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

スペースリスト応答

# Confluence Spaces

Showing **5** global spaces (current)

| Key | Name | Description |
|---|---|---|
| [DEV](#) | Development | Engineering and development documentation |
| [HR](#) | Human Resources | Employee policies and procedures |
| [MARKETING](#) | Marketing | Brand guidelines and campaign materials |
| [PRODUCT](#) | Product | Product specifications and roadmaps |
| [SALES](#) | Sales | Sales processes and resources |

*Retrieved from mycompany.atlassian.net on 2025-05-19 14:22 UTC*

Use `cursor: "next-page-token-123"` to see more spaces.

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

# API Authentication Guide

**Space:** [DEV](#) (Development)
**Created by:** Jane Smith on 2025-04-01
**Last updated:** John Doe on 2025-05-15
**Labels:** api, security, authentication

## Overview

This document outlines the authentication approaches supported by our API platform.

## Authentication Methods

### OAuth 2.0

We support the following OAuth 2.0 flows:

1. **Authorization Code Flow** - For web applications
2. **Client Credentials Flow** - For server-to-server
3. **Implicit Flow** - For legacy clients only

### API Keys

Static API keys are supported but discouraged for production use due to security limitations:

| Key Type | Use Case | Expiration |
|---|---|---|
| Development | Testing | 30 days |
| Production | Live systems | 90 days |

## Implementation Examples

  import requests

  def get_oauth_token():
      return requests.post(
          'https://api.example.com/oauth/token',
          data={
              'client_id': 'YOUR_CLIENT_ID',
              'client_secret': 'YOUR_CLIENT_SECRET',
              'grant_type': 'client_credentials'
          }
      ).json()['access_token']

*Retrieved from mycompany.atlassian.net on 2025-05-19 14:25 UTC*

発達

# Clone repository
git clone https://github.com/aashari/mcp-server-atlassian-confluence.git
cd mcp-server-atlassian-confluence

# Install dependencies
npm install

# Run in development mode
npm run dev:server

# Run tests
npm test

貢献

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

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

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

ライセンス

ISCライセンス

Atlassian Confluence MCP Server

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

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

MCPとは何ですか?

前提条件

設定

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

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

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

オプションB: 環境変数

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

`npx`のクイックスタート

グローバルインストール

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

MCPツール

`conf_ls_spaces`

`conf_get_space`

`conf_ls_pages`

`conf_get_page`

`conf_ls_page_comments`

`conf_search`

CLIコマンド

リストスペース

スペースを取得する

リストページ

ページを取得

リストページのコメント

検索

応答フォーマット

スペースリスト応答

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

発達

貢献

ライセンス

Resources

Tools

Appeared in Searches

Latest Blog Posts

MCP directory API

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

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

MCPとは何ですか?

前提条件

設定

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

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

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

オプションB: 環境変数

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

npxのクイックスタート

グローバルインストール

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

MCPツール

conf_ls_spaces

conf_get_space

conf_ls_pages

conf_get_page

conf_ls_page_comments

conf_search

CLIコマンド

リストスペース

スペースを取得する

リストページ

ページを取得

リストページのコメント

検索

応答フォーマット

スペースリスト応答

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

発達

貢献

ライセンス

Resources

Tools

Appeared in Searches

Latest Blog Posts

MCP directory API

`npx`のクイックスタート

`conf_ls_spaces`

`conf_get_space`

`conf_ls_pages`

`conf_get_page`

`conf_ls_page_comments`

`conf_search`