MCP-Atlassian：Atlassianツールのインテリジェント統合サーバー | ConfluenceとJiraのAIアシスタント接続をサポート

MCP-Atlassian プロジェクト詳細

プロジェクト概要

MCP-Atlassian は、Model Context Protocol (MCP) に基づくサーバーであり、Atlassian 製品（Confluence と Jira）向けに設計されています。このプロジェクトにより、AI アシスタント（Claude など）が Atlassian ワークスペースのデータに直接アクセスして操作できるようになり、インテリジェントなワークフロー管理が実現します。

プロジェクト基本情報

プロジェクト名: mcp-atlassian
開発者: sooperset
GitHubアドレス: https://github.com/sooperset/mcp-atlassian
デプロイ方法: Docker コンテナ

核心機能特性

AI 駆動のインテリジェント操作

プロジェクトは、さまざまな AI アシスタント駆動のインテリジェント操作をサポートしています。

📝 自動 Jira 更新 - 「会議の議事録から Jira を更新する」
🔍 AI 駆動の Confluence 検索 - 「Confluence で OKR ガイドを見つけて要約する」
🐛 インテリジェントな Jira 問題フィルタリング - 「先週の PROJ プロジェクトの緊急バグを表示する」
📄 コンテンツ作成と管理 - 「XYZ 機能の技術設計ドキュメントを作成する」

製品互換性サポート

製品	デプロイタイプ	サポート状況
Confluence	Cloud	✅ 完全サポート
Confluence	Server/Data Center	✅ サポート (バージョン 6.0+)
Jira	Cloud	✅ 完全サポート
Jira	Server/Data Center	✅ サポート (バージョン 8.14+)

インストールと設定

前提条件

Docker 環境
Atlassian API トークン（クラウド版）または個人アクセストークン（サーバー版）

認証トークンの取得

Atlassian Cloud:

https://id.atlassian.com/manage-profile/security/api-tokens にアクセス
「Create API token」をクリックし、名前を付けてトークンをコピー

Server/Data Center:

個人プロファイル → 個人アクセストークンに移動
「Create token」をクリックし、有効期限を設定してトークンをコピー

Docker イメージの取得

# プリビルドイメージのプル
docker pull ghcr.io/sooperset/mcp-atlassian:latest

IDE 統合設定

Claude Desktop 設定

設定ファイル場所：

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

方法1：直接変数を渡す

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_USERNAME", 
        "-e", "CONFLUENCE_API_TOKEN",
        "-e", "JIRA_URL",
        "-e", "JIRA_USERNAME",
        "-e", "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "your_confluence_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "[email protected]", 
        "JIRA_API_TOKEN": "your_jira_api_token"
      }
    }
  }
}

方法2：環境ファイルを使用する

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm", 
        "-i",
        "--env-file",
        "/path/to/your/mcp-atlassian.env",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ]
    }
  }
}

Server/Data Center 設定

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i", 
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_PERSONAL_TOKEN",
        "-e", "CONFLUENCE_SSL_VERIFY",
        "-e", "JIRA_URL", 
        "-e", "JIRA_PERSONAL_TOKEN",
        "-e", "JIRA_SSL_VERIFY",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://confluence.your-company.com",
        "CONFLUENCE_PERSONAL_TOKEN": "your_confluence_pat",
        "CONFLUENCE_SSL_VERIFY": "false",
        "JIRA_URL": "https://jira.your-company.com",
        "JIRA_PERSONAL_TOKEN": "your_jira_pat", 
        "JIRA_SSL_VERIFY": "false"
      }
    }
  }
}

環境変数説明

よく使用される環境変数：

CONFLUENCE_SPACES_FILTER: スペースキーでフィルタリング (例: "DEV,TEAM,DOC")
JIRA_PROJECTS_FILTER: プロジェクトキーでフィルタリング (例: "PROJ,DEV,SUPPORT")
READ_ONLY_MODE: "true" に設定すると書き込み操作が無効になります
MCP_VERBOSE: "true" に設定すると詳細ログが有効になります
ENABLED_TOOLS: カンマ区切りのツール名リスト

利用可能なツール機能

Confluence ツール

ツール名	機能説明
`confluence_search`	CQL を使用して Confluence コンテンツを検索
`confluence_get_page`	特定のページコンテンツを取得
`confluence_get_page_children`	ページの子ページを取得
`confluence_get_page_ancestors`	ページの親ページを取得
`confluence_get_comments`	ページのコメントを取得
`confluence_create_page`	新しいページを作成
`confluence_update_page`	既存のページを更新
`confluence_delete_page`	ページを削除
`confluence_get_labels`	ラベルを取得
`confluence_add_label`	ラベルを追加

Jira ツール

ツール名	機能説明
`jira_get_issue`	特定の問題の詳細を取得
`jira_search`	JQL を使用して問題を検索
`jira_get_project_issues`	プロジェクトの問題を取得
`jira_get_epic_issues`	エピック問題を取得
`jira_create_issue`	新しい問題を作成
`jira_batch_create_issues`	問題を一括作成
`jira_update_issue`	既存の問題を更新
`jira_delete_issue`	問題を削除
`jira_get_transitions`	問題のステータス遷移を取得
`jira_transition_issue`	問題のステータスを遷移
`jira_add_comment`	コメントを追加
`jira_add_worklog`	作業ログを追加
`jira_get_worklog`	作業ログを取得
`jira_download_attachments`	添付ファイルをダウンロード
`jira_link_to_epic`	エピックにリンク
`jira_get_agile_boards`	カンバンを取得
`jira_get_board_issues`	カンバンの問題を取得
`jira_get_sprints_from_board`	カンバンのスプリントを取得
`jira_get_sprint_issues`	スプリントの問題を取得
`jira_create_sprint`	スプリントを作成
`jira_update_sprint`	スプリントを更新
`jira_get_issue_link_types`	問題リンクタイプを取得
`jira_create_issue_link`	問題リンクを作成
`jira_remove_issue_link`	問題リンクを削除

*注：印の付いたツールは Jira Cloud でのみ利用可能です

アクセス制御

ツールフィルタリング

--enabled-tools フラグまたは ENABLED_TOOLS 環境変数を使用して、利用可能なツールを指定します。

# 環境変数を使用
ENABLED_TOOLS="confluence_search,jira_get_issue,jira_search"

# またはコマンドラインフラグを使用
docker run ... --enabled-tools "confluence_search,jira_get_issue,jira_search" ...

読み書き制御

ツールは読み取り操作と書き込み操作に分類されます。READ_ONLY_MODE を有効にすると、ENABLED_TOOLS の設定に関係なく、読み取り操作のみが利用可能になります。

トラブルシューティング

よくある問題の解決

認証失敗:

クラウド版：API トークン（アカウントパスワードではない）を確認
サーバー/データセンター版：個人アクセストークンが有効で期限切れでないことを確認
旧バージョンの Confluence サーバー：CONFLUENCE_USERNAME と CONFLUENCE_API_TOKEN (トークンはパスワード) を使用する必要がある場合があります

SSL 証明書の問題:
サーバー/データセンターのデプロイメントで SSL エラーが発生した場合は、CONFLUENCE_SSL_VERIFY=false または JIRA_SSL_VERIFY=false を設定します

権限エラー:
Atlassian アカウントに、関連するスペース/プロジェクトにアクセスするための十分な権限があることを確認します

デバッグ方法

MCP Inspector を使用してテスト:

npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

ログの確認:

# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

# Windows  
type %APPDATA%\Claude\logs\mcp*.log | more

SSE 転送の使用

標準の stdio 転送に加えて、Server-Sent Events (SSE) もサポートされています。

ターミナルでサーバーを手動で起動します。

docker run --rm -p 9000:9000 \
  --env-file /path/to/your/.env \
  ghcr.io/sooperset/mcp-atlassian:latest \
  --transport sse --port 9000 -vv

実行中のサーバーに接続するように IDE を設定します。

{
  "mcpServers": {
    "mcp-atlassian-sse": {
      "url": "http://localhost:9000/sse"
    }
  }
}

安全に関する考慮事項

API トークンを絶対に共有しないでください
.env ファイルを安全かつ秘密に保ちます
ベストプラクティスについては SECURITY.md を参照してください

技術アーキテクチャ

このプロジェクトは Docker コンテナ化されたデプロイメントを採用し、Model Context Protocol を介して AI アシスタントと通信します。さまざまな転送方法 (stdio と SSE) をサポートし、さまざまなデプロイメント環境と使用シナリオに柔軟に対応できます。

プロジェクト設計はエンタープライズアプリケーションのニーズを考慮し、Atlassian のクラウド版とプライベートデプロイメント版をサポートし、完全な認証、権限制御、およびセキュリティメカニズムを提供します。

注意: これは Atlassian の公式製品ではなく、コミュニティ開発者 sooperset によってメンテナンスされているオープンソースプロジェクトです。