Skip to main content
Glama

Atlassian Confluence MCP Server

by aashari

アトラシアン 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 形式が採用されています。

MCPとは何ですか?

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

前提条件

  • Node.js (>=18.x):ダウンロード

  • Confluence Cloud にアクセスできるAtlassian アカウント

設定

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

  1. Atlassian API トークン管理ページに移動します: https://id.atlassian.com/manage-profile/security/api-tokens

  2. 「API トークンの作成」をクリックします。

  3. 説明的なラベル(例: mcp-confluence-access ) を付けます。

  4. [作成]をクリックします。

  5. 生成された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

貢献

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

  1. リポジトリをフォークします。

  2. 機能ブランチを作成します ( git checkout -b feature/xyz )。

  3. 変更をコミットします ( git commit -m "Add xyz feature" )。

  4. ブランチにプッシュします ( git push origin feature/xyz )。

  5. プルリクエストを開きます。

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

ライセンス

ISCライセンス

Related MCP Servers

  • A
    security
    F
    license
    A
    quality
    A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
    Last updated -
    12
    305
    1
    • Apple
  • A
    security
    A
    license
    A
    quality
    A Model Context Protocol server that enables AI assistants to interact with Confluence content, supporting operations like retrieving, searching, creating, and updating pages and spaces.
    Last updated -
    9
    8
    MIT License
  • -
    security
    F
    license
    -
    quality
    A Model Context Protocol server that extends AI capabilities by providing file system access and management functionalities to Claude or other AI assistants.
    Last updated -
    418
    6
    • Apple
  • A
    security
    F
    license
    A
    quality
    A Model Context Protocol server that provides secure access to Atlassian Confluence, allowing users to search, create, update, and manage Confluence pages and spaces through natural language commands.
    Last updated -
    10
    1

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aashari/mcp-server-atlassian-confluence'

If you have feedback or need assistance with the MCP directory API, please join our Discord server