Atlassian (browser SSO)

atlassian-browser-mcp

企業の SSO（Okta、SAML など）を介し、API トークンが利用できない Atlassian Server／Data Center インスタンス向けに、Playwright によるブラウザー Cookie 認証で、上流の mcp-atlassian ツールセットをラップする MCP サーバーです。stdio 経由でローカル実行されます。同梱の CLI で一度ログインすると、サーバーが Cookie を再利用します。

機能

• mcp-atlassian の Jira および Confluence ツールをすべて利用できます。API トークンの代わりに SSO ブラウザーセッションで認証し、上流独自のネットワーク保護（SSRF リダイレクトチェック、DNS ピンニング、リトライ、レート制限、プロキシおよび TLS の設定）も維持されます。
• CLI でサービスごとに一度ログインします。サーバー自体がブラウザーを起動することはないため、ブラウザーを待って停止することもありません。
• atlassian_auth_status により、タスクの途中で失敗する前に、どのサービスでログインが必要かをエージェントに知らせます。
• 必要に応じて、実際の Chrome プロファイルから自動化プロファイルへ一度だけ初期データを取り込めます（ATLASSIAN_SEED_FROM_CHROME_PROFILE）。そのため、最初のログインは多くの場合ワンクリックで完了します。
• macOS では、インストール済みの Chromium 系ブラウザー（Arc、Brave、Edge、Chrome など）の有効なセッションを、ウィンドウを開かずに再利用します。そのブラウザーの Keychain キーを読み取り、その旨を stderr に出力します。この機能は無効にできます。
• Jira と Confluence 用に Cookie jar を分け、それぞれのホストの Cookie のみを保存します。権限は 0600 です。Jira のみ、または Confluence のみの構成にも対応しています。
• スクリプトやエージェント向けのコマンドラインフロントエンド（atlassian-cli）を提供します。課題やページの取得と検索ができます。
• ATLASSIAN_BROWSER_AUTH_ENABLED=false を指定すると、トークン認証にフォールバックします。

クイックスタート

uv をインストールした状態で PyPI からインストールする場合：

JIRA_URL=https://jira.example.com uvx --from atlassian-browser-mcp atlassian-cli login jira   # once per service, opens your browser
CONFLUENCE_URL=https://confluence.example.com uvx --from atlassian-browser-mcp atlassian-cli login confluence
JIRA_URL=https://jira.example.com CONFLUENCE_URL=https://confluence.example.com uvx atlassian-browser-mcp

チェックアウトから uv.lock に記載された正確なバージョンで実行する場合：

git clone https://github.com/GeiserX/atlassian-browser-mcp.git && cd atlassian-browser-mcp
UV_PROJECT_ENVIRONMENT=.venv-atlassian-browser uv sync --frozen   # installs the versions in uv.lock
JIRA_URL=https://jira.example.com CONFLUENCE_URL=https://confluence.example.com ./atlassian-cli login jira   # once per service

Python 3.11 以降、uv、Google Chrome、およびログイン用のディスプレイが必要です。サーバーがブラウザーウィンドウを開くことはありません。保存済みの Cookie を読み取り、Cookie がないか期限切れの場合は、再度ログインするよう求める AuthRequiredError を返します。また macOS では、インストール済みのブラウザーに有効なセッションがないかバックグラウンドで確認するため、数秒後に再試行すればそのまま使えることがあります。Chrome からの初期データの取り込みと各種設定については、Getting started を参照してください。

クライアントに追加する

各クライアントは、stdio 経由でサーバーを実行します。使用するサービスの URL だけを設定してください。以下の例では、uvx 経由で PyPI パッケージを使用しています。チェックアウトしたリポジトリを使用する場合は、uvx atlassian-browser-mcp を /path/to/atlassian-browser-mcp/run-atlassian-browser-mcp.sh に置き換えてください。

Claude Code

claude mcp add --transport stdio atlassian \
  --env JIRA_URL=https://jira.example.com \
  --env CONFLUENCE_URL=https://confluence.example.com \
  -- uvx atlassian-browser-mcp

Claude Desktop（claude_desktop_config.json）および Cursor（~/.cursor/mcp.json または .cursor/mcp.json）

{
  "mcpServers": {
    "atlassian": {
      "command": "uvx",
      "args": ["atlassian-browser-mcp"],
      "env": {
        "JIRA_URL": "https://jira.example.com",
        "CONFLUENCE_URL": "https://confluence.example.com"
      }
    }
  }
}

VS Code（.vscode/mcp.json）

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "uvx",
      "args": ["atlassian-browser-mcp"],
      "env": {
        "JIRA_URL": "https://jira.example.com",
        "CONFLUENCE_URL": "https://confluence.example.com"
      }
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.atlassian]
command = "uvx"
args = ["atlassian-browser-mcp"]
env = { JIRA_URL = "https://jira.example.com", CONFLUENCE_URL = "https://confluence.example.com" }

プロトコル。 stdio 経由で MCP 2025-11-25、2025-06-18、2025-03-26、2024-11-05 を使用します。これにより、initialize ハンドシェイクを開始時に行うクライアント（現在の Claude Code、Claude Desktop、Cursor、VS Code）に対応します。MCP 2026-07-28 はまだサポートされていません。上流の mcp-atlassian が mcp<2 と fastmcp<4 を固定しているためです（https://github.com/sooperset/mcp-atlassian/issues/1541）。上流が対応したら、このサーバーも追随します。このサーバーは stdio でのみ実行され、ほかの FASTMCP_TRANSPORT が設定されている場合は起動を拒否します。

読み取り専用モード

書き込みツールは、SSO の ID を使用してあなたの代わりに操作します。書き込みツール（作成、更新、削除、遷移、アップロード、制限）をすべて非表示にするには、サーバーの env で READ_ONLY_MODE=true を設定してください。上流では、ツールの一覧表示時と呼び出し時にこれが適用されます。ENABLED_TOOLS（ツール名をカンマ区切りで指定する許可リスト）と TOOLSETS を設定すると、一覧をさらに絞り込めます。詳しくは設定をご覧ください。

ツール

ツール	機能	ヒント
atlassian_auth_status	各サービスの保存済みセッションが存在し、動作するかどうかを確認します。Cookie jar の経過時間、Cookie の有効期限、ライブチェック、次の手順を表示します	読み取り専用
atlassian_login	ユーザーに表示する正確な atlassian-cli login <service> コマンドです	読み取り専用
jira_*（63）	上流のすべての Jira ツールです。課題、検索、コメント、遷移、スプリント、ボード、バージョン、リンク、作業ログ、添付ファイル、サービスデスク、フォームに対応します	読み取り専用 38 件、書き込み 25 件
confluence_*（35）	上流のすべての Confluence ツールです。ページ、検索、コメント、ラベル、添付ファイル、履歴、テンプレート、制限に対応します	読み取り専用 20 件、書き込み 15 件

各ツールにはタイトルと4種類すべての注釈ヒント（読み取り専用、破壊的、冪等、オープンワールド）が付いているため、クライアントは読み取りを自動承認し、書き込み時に確認を求めることができます。全ツールの一覧と CLI については、使用方法をご覧ください。

ドキュメント

• はじめに：要件、インストール、初回ログイン、Chrome からのシード、MCP クライアントの設定
• 設定：すべての環境変数とそのデフォルト値
• 使用方法：MCP ツールと CLI コマンド
• 仕組み：ログインとサーバー実行が別プロセスである理由、およびファイルについて
• トラブルシューティング：症状、原因、解決方法、バグ報告に記載する内容

ライセンス

GPL-3.0-or-later