Atlassian MCP Server (Jira & Confluence)

Atlassian MCP Server (Jira & Confluence) とは？

Atlassian MCP Server (Jira & Confluence) は、コミュニティプロジェクト mcp-atlassian です。AI アシスタントが Atlassian Cloud と Server/Data Center の両方で Jira の課題と Confluence のページを検索・閲覧・作成・更新できるようにする、オープンソースの MCP サーバーです。

GitHub 上で sooperset がメンテナンスしており（sooperset/mcp-atlassian）、PyPI では mcp-atlassian として公開され、MIT ライセンスで提供されています。Atlassian の公式製品ではありません。Atlassian は独自のホスト型サーバーを運営しており、後述の代替ツールの比較で紹介します。オンプレミスの Jira や Confluence にも対応したセルフホスト型の Atlassian MCP を探している場合によく選ばれる選択肢です。

Atlassian MCP Server (Jira & Confluence) の使い方

前提条件

• uvx でパッケージを実行するために uv をインストールしておきます（Docker や pip でも動作します）。
• Jira および／または Confluence の URL。
• 認証情報。Cloud の場合は https://id.atlassian.com/manage-profile/security/api-tokens で API token を作成し、アカウントのメールアドレスと組み合わせて使います。Server/Data Center の場合はプロフィールから Personal Access Token を作成し、ユーザー名と API token の代わりに JIRA_PERSONAL_TOKEN / CONFLUENCE_PERSONAL_TOKEN を設定します。mTLS クライアント証明書と OAuth 2.0 にも対応しています。

Jira のみ、Confluence のみ、または両方を設定できます。次のコマンドでサーバーが起動することを確認します。

uvx mcp-atlassian --help

Claude Desktop

claude_desktop_config.json を編集します（macOS：~/Library/Application Support/Claude/、Windows：%APPDATA%\Claude\、Linux：~/.config/Claude/）。

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Server/Data Center の場合は、自社の URL（例：https://jira.your-company.com）を使い、ユーザー名と API token を JIRA_PERSONAL_TOKEN / CONFLUENCE_PERSONAL_TOKEN に置き換えます。

Claude Code

同じ uvx コマンドを CLI で登録します。

claude mcp add mcp-atlassian \
  -e JIRA_URL=https://your-company.atlassian.net \
  -e JIRA_USERNAME=your.email@company.com \
  -e JIRA_API_TOKEN=your_api_token \
  -e CONFLUENCE_URL=https://your-company.atlassian.net/wiki \
  -e CONFLUENCE_USERNAME=your.email@company.com \
  -e CONFLUENCE_API_TOKEN=your_api_token \
  -- uvx mcp-atlassian

Cursor

Settings → MCP → + Add new global MCP server を開き、Claude Desktop と同じ JSON を貼り付けます。

VS Code

プロジェクトのドキュメントでは、VS Code（GitHub Copilot）は stdio 経由でサポートされています。.vscode/mcp.json に uvx コマンドを stdio サーバーとして追加します。

{
  "servers": {
    "mcp-atlassian": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Docker と HTTP

Docker イメージは ghcr.io/sooperset/mcp-atlassian:latest として公開されています。共有環境やリモート環境では、サーバーを HTTP サービスとして実行できます。streamable-http は /mcp、sse は /sse エンドポイントを提供します。

uvx mcp-atlassian --transport streamable-http --port 9000 -vv

Atlassian MCP Server (Jira & Confluence) の主な機能

• Cloud と Server/Data Center の Jira・Confluence に対応（Jira 8.14+、Confluence 6.0+）。
• 100 近いツール（現行ドキュメントでは 98 個）をツールセット単位でまとめ、必要なものだけ有効化できます。
• Jira の課題は JQL、Confluence のコンテンツは CQL で検索。
• Markdown で書けば、Cloud では ADF、Server/Data Center では wiki markup にサーバーが変換します。
• 4 種類の認証方式：API token、Personal Access Token、mTLS クライアント証明書、OAuth 2.0。
• READ_ONLY_MODE=true、ENABLED_TOOLS、TOOLSETS、JIRA_PROJECTS_FILTER、CONFLUENCE_SPACES_FILTER で、エージェントが参照・変更できる範囲を制限できます。
• stdio、SSE、streamable-http のトランスポートに対応し、ステートレスモードやマルチユーザー認証も利用可能。
• 企業ネットワーク向けに、プロキシ、カスタムヘッダー、OS の証明書ストアに対応。

Atlassian MCP Server (Jira & Confluence) のツール

ツール名には jira_ または confluence_ の接頭辞が付きます。TOOLSETS=default には 6 つのコアツールセット jira_issues、jira_fields、jira_comments、jira_transitions、confluence_pages、confluence_comments が含まれます。

• Jira の課題と検索：jira_search（JQL）、jira_get_issue、jira_create_issue、jira_batch_create_issues、jira_update_issue、jira_assign_issue、ステータス変更用の jira_transition_issue。
• Jira のアジャイルとプロジェクト：ボードとスプリント（jira_get_agile_boards、jira_get_sprint_issues、jira_create_sprint、jira_add_issues_to_sprint）、バージョン、コンポーネント、jira_link_to_epic などの課題リンク。
• Jira のその他の機能：作業ログ、ウォッチャー、添付ファイル、Jira Service Management のキューとリクエスト、SLA と課題の日付、開発情報。
• Confluence のページ：confluence_search（CQL）、confluence_get_page、confluence_create_page、confluence_update_page、confluence_update_page_section、confluence_move_page、ページ履歴と差分。
• Confluence のコラボレーション：コメント、インラインコメント、ラベル、添付ファイル、テンプレート（confluence_create_page_from_template）、権限チェック。

confluence_get_page_views や jira_batch_get_changelogs など、一部のツールは Cloud 専用です。

Atlassian MCP Server (Jira & Confluence) のユースケース

• 自分のバックログを整理する：「Find issues assigned to me in PROJ project.」
• チャットやログからバグを起票する：「Create a bug ticket for the login issue.」
• Jira を開かずに作業を進める：「Update the status of PROJ-123 to Done.」
• Confluence をナレッジベースとして使う：「Search Confluence for onboarding docs.」
• ドキュメントを作成する：JQL クエリからリリースノートを下書きし、Confluence ページとして公開するようエージェントに依頼します。

Atlassian MCP Server (Jira & Confluence) と代替ツールの比較

• Atlassian 公式 MCP サーバー（Rovo）：Atlassian は https://mcp.atlassian.com/v2/mcp で独自のリモート MCP サーバーをホストしています。OAuth 2.1 または API token でサインインし、Jira、Confluence、Jira Service Management、Bitbucket、Compass、Loom をカバーしますが、Atlassian Cloud 専用です。インストール不要でベンダーがサポートするホスト型を求めるならこちら、Server/Data Center、セルフホスト、細かいツール制御が必要なら mcp-atlassian が向いています。
• Atlassian Data Center MCP：mcp.so に掲載されているコミュニティサーバーで、Data Center 版の Bitbucket、Confluence、Jira を対象としています。

Atlassian MCP Server (Jira & Confluence) のトラブルシューティング

• Cloud で 401/403 が出る：アカウントのパスワードではなく API token を使ってください。JIRA_USERNAME / CONFLUENCE_USERNAME がメールアドレスであること、token の有効期限が切れていないことを確認します。
• Server/Data Center で認証に失敗する：Personal Access Token が有効か確認します。古い Confluence サーバーでは、CONFLUENCE_USERNAME と CONFLUENCE_API_TOKEN（token にはパスワードを指定）による基本認証を試してください。
• 自己署名証明書で SSL エラーが出る：OS の証明書ストアにある企業 CA は自動的に信頼されます。それ以外の自己署名証明書では JIRA_SSL_VERIFY=false / CONFLUENCE_SSL_VERIFY=false を設定します。
• クライアントにツールが 0 個と表示される（GitHub Copilot など）：mcp-atlassian 0.16.0 以降にアップグレードするか、uvx mcp-atlassian@latest を実行します。
• 詳しいログが必要：MCP_VERBOSE=true または MCP_VERY_VERBOSE=true を設定します。macOS の Claude Desktop では ~/Library/Logs/Claude/mcp*.log を確認します。