atlassian-dc-mcp-confluence

Atlassian Data Center MCP

注記： これはコミュニティによって保守されているプロジェクトであり、Atlassian との提携、承認、サポートはありません。 ご自身の判断でご利用ください。

このプロジェクトは、Jira、Confluence、Bitbucket などの Atlassian Data Center 製品向けに、Model Context Protocol（MCP）との連携を提供します。

クイックセットアップ

各パッケージには、OS で利用可能な最も安全な場所に認証情報を保存する、対話型の setup サブコマンドが用意されています。製品ごとに一度実行してください。

npx @atlassian-dc-mcp/jira setup
npx @atlassian-dc-mcp/confluence setup
npx @atlassian-dc-mcp/bitbucket setup

セットアップ CLI では、ホスト、API ベースパス、デフォルトのページサイズ、API トークンの入力を求められます。保存前に、明らかな入力ミスを検証し、選択した Atlassian 製品に対して認証済みリクエストをタイムアウト付きで実行するため、ホスト、ベースパス、トークンに誤りがあればセットアップ中に検出されます。

CLI フラグと非対話型モード

セットアップでは、値を事前入力したり、プロンプトを完全に省略したりするためのフラグを利用できます（スクリプトによる初期設定、CI、リモートセッションに便利です）。すべてのフラグについては、npx @atlassian-dc-mcp/<product> setup --help を実行してください。

フラグ	短縮形	説明
--host <value>	-H	ホスト。例：jira.example.com
--api-base-path <value>	-b	API ベースパスまたは完全な URL
--token <value>	-t	API トークン
--default-page-size <n>	-s	デフォルトのページサイズ（正の整数）
--non-interactive	-n	プロンプトを省略します。必須の値を解決できない場合は失敗します
--help	-h	使用方法を表示して終了します

対話型モードでは、指定したフラグの値がプロンプトに事前入力されます（たとえば --host を指定するとホストのプロンプトは省略されますが、ほかの項目は引き続き尋ねられます）。--non-interactive モードでは、不足している値を既存の設定（プロセス環境変数、~/.atlassian-dc-mcp/<product>.env、または macOS Keychain）から解決し、ホスト（または完全な URL の --api-base-path）とトークンが見つからない場合はゼロ以外の終了コードで終了します。--token を省略した場合、既存のトークンが再利用されます。

# Scripted, no prompts, write everything from flags
npx @atlassian-dc-mcp/jira setup --non-interactive \
  --host jira.example.com \
  --token "$JIRA_TOKEN"

# Re-validate the existing token without re-entering it
npx @atlassian-dc-mcp/jira setup --non-interactive --host jira.example.com

認証情報の検証動作はモードによって異なります。対話型モードでは、失敗時に再試行またはそのまま保存するかを尋ねます。一方、--non-interactive モードでは最初の検証失敗時にコード 1 で終了するため、CI のゲートとして使用できます。

トークンの保存先：

• macOS — /usr/bin/security を介してログイン Keychain に書き込まれます（サービス atlassian-dc-mcp、アカウント <product>-token）。
• Linux — POSIX モード 0600（自分のユーザーのみ読み書き可能。他のローカルユーザーアカウントは読み取り不可）で ~/.atlassian-dc-mcp/<product>.env に書き込まれます。
• Windows — %USERPROFILE%\.atlassian-dc-mcp\<product>.env に書き込まれます。Node はモードビットを渡しますが、Windows はこれを無視するため、ファイルにはユーザープロファイルディレクトリの ACL が継承されます。通常は、自分のユーザー、SYSTEM、Administrators のみが読み取れます。

シークレットではないフィールド（ホスト、API ベースパス、デフォルトのページサイズ）は、常にホームファイルに書き込まれます。macOS/Linux では ~/.atlassian-dc-mcp/<product>.env、Windows では %USERPROFILE%\.atlassian-dc-mcp\<product>.env です。Keychain への書き込みが成功すると、ホームファイルからトークンの行が消去されるため、より安全性の低い場所にトークンが二重に保存されることはありません。

セットアップを実行すると、MCP サーバーは環境変数をまったく設定せずに起動できます。

{
  "mcpServers": {
    "atlassian-jira-dc": { "command": "npx", "args": ["-y", "@atlassian-dc-mcp/jira"] },
    "atlassian-confluence-dc": { "command": "npx", "args": ["-y", "@atlassian-dc-mcp/confluence"] },
    "atlassian-bitbucket-dc": { "command": "npx", "args": ["-y", "@atlassian-dc-mcp/bitbucket"] }
  }
}

以下のセクションに示すように、環境変数または ATLASSIAN_DC_MCP_CONFIG_FILE を使って認証情報を渡すこともできます。これらはセットアップで保存した値より優先されます。

設定ソースと優先順位

起動時に、各 MCP サーバーはソースを次の順序で確認し、最初に見つかった空でない値を使って各設定キーを解決します。

優先度	ソース	読み取り対象	セットアップによる書き込み
100	process.env（JIRA_*、CONFLUENCE_*、BITBUCKET_*）	すべてのキー	—
80	環境変数ファイル — ATLASSIAN_DC_MCP_CONFIG_FILE または ./.env	すべてのキー	—
60	ホームディレクトリのファイル — macOS/Linux では ~/.atlassian-dc-mcp/<product>.env、Windows では %USERPROFILE%\.atlassian-dc-mcp\<product>.env（POSIX ではモード 0600、Windows ではユーザープロファイルの ACL を継承）	すべてのキー	host、apiBasePath、defaultPageSize（常時）；token（darwin 以外、またはキーチェーンのフォールバック時）
40	macOS キーチェーン — サービス atlassian-dc-mcp、アカウント <product>-token	token のみ	token（darwin のみ）

補足：

• プロセス環境変数はすべての設定より優先されるため、保存済みの認証情報を常に一時的に上書きできます。
• ATLASSIAN_DC_MCP_CONFIG_FILE には絶対パスを指定する必要があります。指定したファイルが見つからない場合、サーバーは直ちにエラー終了します。
• キーチェーンの読み取り結果は初期化時にキャッシュされます（製品トークンごとに execFileSync を1回実行）。そのため、ツールの呼び出し時にシェルコマンドが実行されることはありません。
• セットアップで保存しようとしている値が、より優先度の高いソースによって上書きされる場合、セットアップは該当する環境変数名を示す警告を出力するため、その変数を解除できます。
• Atlassian API リクエストは、デフォルトで30秒後にタイムアウトします。正のミリ秒値を ATLASSIAN_DC_MCP_REQUEST_TIMEOUT_MS に設定すると、タイムアウトを変更できます。

Claude Desktop の設定

Anthropic 公式クイックスタートガイド

これらの MCP コネクターを Claude Desktop で使用するには、次の内容を Claude Desktop の設定に追加します。

*_HOST 変数には、プロトコルを含めず、ドメインとポートのみを指定してください（例：your-instance.atlassian.net）。https プロトコルが自動的に使用されます。

または、*_HOST の代わりに *_API_BASE_PATH 変数を使い、プロトコルを含む完全な API ベース URL を指定できます（例：https://your-instance.atlassian.net/rest）。/api/latest/ の部分は固定で、コード内で自動的に追加されるため、*_API_BASE_PATH の値に含める必要はありません。

設定には、必要なサービスのみを残すことができます。

macOS：

~/Library/Application Support/Claude/claude_desktop_config.json

Windows：

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/jira"],
      "env": {
        "JIRA_HOST": "your-jira-host",
        "JIRA_API_TOKEN": "your-token"
      }
    },
    "atlassian-confluence-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/confluence"],
      "env": {
        "CONFLUENCE_HOST": "your-confluence-host",
        "CONFLUENCE_API_TOKEN": "your-token"
      }
    },
    "atlassian-bitbucket-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/bitbucket"],
      "env": {
        "BITBUCKET_HOST": "your-bitbucket-host",
        "BITBUCKET_API_TOKEN": "your-token"
      }
    }
  }
}

別の API ベースパス設定を使用することもできます。

{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/jira"],
      "env": {
        "JIRA_API_BASE_PATH": "https://your-jira-host/rest",
        "JIRA_API_TOKEN": "your-token"
      }
    },
    "atlassian-confluence-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/confluence"],
      "env": {
        "CONFLUENCE_API_BASE_PATH": "https://your-confluence-host/rest",
        "CONFLUENCE_API_TOKEN": "your-token"
      }
    },
    "atlassian-bitbucket-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/bitbucket"],
      "env": {
        "BITBUCKET_API_BASE_PATH": "https://your-bitbucket-host/rest",
        "BITBUCKET_API_TOKEN": "your-token"
      }
    }
  }
}

共有外部設定ファイル

1台のマシンで複数の MCP ホストまたはツールから同じ Atlassian 認証情報を再利用する場合は、既存の JIRA_*、CONFLUENCE_*、BITBUCKET_* 変数を dotenv 形式のファイルにまとめ、各 MCP サーバーから ATLASSIAN_DC_MCP_CONFIG_FILE を使ってそのファイルを指定します。

パスには絶対パスを指定する必要があります。直接指定した環境変数は、共有ファイルの値より優先されます。

共有ファイルの例：

JIRA_HOST=your-jira-host
JIRA_API_TOKEN=your-jira-token
JIRA_DEFAULT_PAGE_SIZE=50

CONFLUENCE_HOST=your-confluence-host
CONFLUENCE_API_TOKEN=your-confluence-token

BITBUCKET_HOST=your-bitbucket-host
BITBUCKET_API_TOKEN=your-bitbucket-token
BITBUCKET_DEFAULT_PAGE_SIZE=50

共有ファイルを使用する Claude Desktop の例：

{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/jira"],
      "env": {
        "ATLASSIAN_DC_MCP_CONFIG_FILE": "/Users/your-user/.config/atlassian-dc-mcp.env"
      }
    },
    "atlassian-confluence-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/confluence"],
      "env": {
        "ATLASSIAN_DC_MCP_CONFIG_FILE": "/Users/your-user/.config/atlassian-dc-mcp.env"
      }
    },
    "atlassian-bitbucket-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/bitbucket"],
      "env": {
        "ATLASSIAN_DC_MCP_CONFIG_FILE": "/Users/your-user/.config/atlassian-dc-mcp.env"
      }
    }
  }
}

Windows のパスの例：

{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/jira"],
      "env": {
        "ATLASSIAN_DC_MCP_CONFIG_FILE": "C:\\\\Users\\\\your-user\\\\AppData\\\\Roaming\\\\atlassian-dc-mcp.env"
      }
    }
  }
}

Claude Code CLI の設定

これらの MCP コネクターを Claude Code で使用するには、claude mcp add コマンドを使って MCP サーバーを追加します。

サーバーはプロジェクトスコープ（.mcp.json に保存）またはユーザースコープ（-s user）で追加できます。必要に応じてスコープと含めるサービスを調整してください。

# Jira
claude mcp add atlassian-jira-dc \
  -e JIRA_HOST=your-jira-host \
  -e JIRA_API_TOKEN=your-token \
  -- npx -y @atlassian-dc-mcp/jira

# Confluence
claude mcp add atlassian-confluence-dc \
  -e CONFLUENCE_HOST=your-confluence-host \
  -e CONFLUENCE_API_TOKEN=your-token \
  -- npx -y @atlassian-dc-mcp/confluence

# Bitbucket
claude mcp add atlassian-bitbucket-dc \
  -e BITBUCKET_HOST=your-bitbucket-host \
  -e BITBUCKET_API_TOKEN=your-token \
  -- npx -y @atlassian-dc-mcp/bitbucket

Claude Desktop の例と同様に、*_HOST の代わりに *_API_BASE_PATH を使用することもできます。

claude mcp add atlassian-jira-dc \
  -e JIRA_API_BASE_PATH=https://your-jira-host/rest \
  -e JIRA_API_TOKEN=your-token \
  -- npx -y @atlassian-dc-mcp/jira

サーバーをユーザースコープで追加するには（すべてのプロジェクトで使用可能）：

claude mcp add -s user atlassian-jira-dc \
  -e JIRA_HOST=your-jira-host \
  -e JIRA_API_TOKEN=your-token \
  -- npx -y @atlassian-dc-mcp/jira

認証情報をコマンドに直接渡す代わりに、共有設定ファイルを使用するには：

claude mcp add atlassian-jira-dc \
  -e ATLASSIAN_DC_MCP_CONFIG_FILE=/Users/your-user/.config/atlassian-dc-mcp.env \
  -- npx -y @atlassian-dc-mcp/jira

Windows PowerShell の例：

claude mcp add atlassian-jira-dc `
  -e ATLASSIAN_DC_MCP_CONFIG_FILE=C:\Users\your-user\AppData\Roaming\atlassian-dc-mcp.env `
  -- npx -y @atlassian-dc-mcp/jira

API トークンの生成

Data Center のインストールでは、各サービス用のパーソナルアクセストークン（PAT）を生成する必要があります。

Jira Data Center

1. Jira インスタンスにログインします
2. Profile > Personal Access Tokens に移動します
3. 「Create token」をクリックします
4. わかりやすい名前を付け、適切な権限を設定します
5. 生成されたトークンをすぐにコピーします（再表示されません）

Confluence Data Center

1. Confluence インスタンスにログインします
2. 「設定」>「個人用アクセストークン」に移動します
3. 「トークンを作成」をクリックします
4. トークンに名前を付け、必要な権限を設定します
5. 保存してトークンをコピーします（表示されるのは一度だけです）

Bitbucket Data Center

1. Bitbucket にログインします
2. 「アカウントの管理」>「HTTP アクセストークン」に移動します
3. 「トークンを作成」をクリックします
4. 名前と権限を設定します
5. トークンを生成し、すぐにコピーします

これらのトークンは安全に保管し、上記の例に従って Claude Desktop の設定で使用してください。

概要

Atlassian DC MCP を使用すると、AI アシスタントは標準化されたインターフェースを通じて Atlassian 製品を操作できます。以下のツールが用意されています。

• Jira：課題の検索、表示、作成
• Confluence：コンテンツへのアクセスと管理
• Bitbucket：リポジトリとコードの操作

前提条件

• Node.js 18 以降
• npm 7 以降（ワークスペースのサポートに必要）
• Atlassian Data Center インスタンスまたは Cloud インスタンス
• 使用する Atlassian 製品の API トークン

インストール

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

git clone https://github.com/b1ff/atlassian-dc-mcp.git
cd atlassian-dc-mcp

開発

このプロジェクトは、ワークスペースを使用する npm モノレポとして構成されています。ワークスペースは packages/ ディレクトリにまとめられており、Atlassian 製品ごとの連携パッケージが用意されています。

依存関係のインストール

モノレポ内のすべてのパッケージの依存関係をインストールするには、次のコマンドを実行します。

npm install

次の依存関係がインストールされます。

• ルートの package.json で定義されているルートレベルの依存関係
• ワークスペース内の各パッケージのすべての依存関係

特定のパッケージに依存関係をインストールするには、次のコマンドを実行します。

npm install <package-name> --workspace=@atlassian-dc-mcp/jira

ルートレベルに依存関係をインストールするには、次のコマンドを実行します。

npm install <package-name> -W

プロジェクトのビルド

すべてのパッケージをビルドするには、次のコマンドを実行します。

npm run build

特定のパッケージをビルドするには、次のコマンドを実行します。

npm run build --workspace=@atlassian-dc-mcp/jira

開発モードでの実行

特定のパッケージを開発モードで実行するには、次のコマンドを実行します。

npm run dev:jira     # For Jira
npm run dev:confluence  # For Confluence
npm run dev:bitbucket   # For Bitbucket

設定

本番環境で使用する場合は、上記の クイックセットアップ CLI を使用してください。トークンは macOS Keychain に、シークレットではないフィールドはホームディレクトリ内のファイル（macOS/Linux では ~/.atlassian-dc-mcp/<product>.env、Windows では %USERPROFILE%\.atlassian-dc-mcp\<product>.env）に自動的に書き込みます。

ローカル開発では、ルートディレクトリに .env ファイルを作成するか、ディスク上の任意の場所に共有 dotenv 形式のファイルを作成し、ATLASSIAN_DC_MCP_CONFIG_FILE でそのファイルを指定して、以下の変数を設定します。

# Jira configuration - choose one of these options:
JIRA_HOST=your-instance.atlassian.net
# OR
JIRA_API_BASE_PATH=https://your-instance.atlassian.net/rest
# Note: part /api/2/search/ is added automatically, do not include it
JIRA_API_TOKEN=your-api-token

# Confluence configuration - choose one of these options:
CONFLUENCE_HOST=your-instance.atlassian.net
# OR
CONFLUENCE_API_BASE_PATH=https://your-instance.atlassian.net/confluence
# Note: part /rest/api is added automatically, do not include it
CONFLUENCE_API_TOKEN=your-api-token

# Bitbucket configuration - choose one of these options:
BITBUCKET_HOST=your-instance.atlassian.net
# OR
BITBUCKET_API_BASE_PATH=https://your-instance.atlassian.net/rest
# Note: part /api/latest/ is added automatically, do not include it
BITBUCKET_API_TOKEN=your-api-token

各キーの優先順位は process.env → ATLASSIAN_DC_MCP_CONFIG_FILE（または ./.env）→ ホームディレクトリ内のファイル（macOS/Linux では ~/.atlassian-dc-mcp/<product>.env、Windows では %USERPROFILE%\.atlassian-dc-mcp\<product>.env）→ macOS Keychain です。上記の設定ソースと優先順位を参照してください。

ライセンス

MIT