Home
Login
sooperset/mcp-atlassianPlease refer to the latest official releases for information GitHub Homepage

Atlassianツール（ConfluenceとJira）向けのMCPサーバー。AIアシスタントがワークスペースデータに直接アクセスして操作することをサポートします。

MITPython 2.2ksoopersetmcp-atlassian Last Updated: 2025-06-27

MCP-Atlassian プロジェクト詳細

プロジェクト概要

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

プロジェクト基本情報

核心機能特性

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:

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

Server/Data Center:

  1. 個人プロファイル → 個人アクセス トークンに移動
  2. 「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": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_confluence_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com", 
        "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) もサポートされています。

  1. ターミナルでサーバーを手動で起動します。
docker run --rm -p 9000:9000 \
  --env-file /path/to/your/.env \
  ghcr.io/sooperset/mcp-atlassian:latest \
  --transport sse --port 9000 -vv
  1. 実行中のサーバーに接続するように IDE を設定します。
{
  "mcpServers": {
    "mcp-atlassian-sse": {
      "url": "http://localhost:9000/sse"
    }
  }
}

安全に関する考慮事項

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

技術アーキテクチャ

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

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

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

Star History Chart