atlassian-browser-mcp

rowser-backed MCP wrapper for mcp-atlassian with Playwright SSO auth. Enables AI tools to access Atlassian Server/Data Center instances behind corporate SSO (Okta, SAML, ADFS) where API tokens are not available.

GitHub

atlassian-browser-mcp banner

atlassian-browser-mcp

License: GPL-3.0 Python 3.12+ GitHub stars mcp-atlassian GeiserX/atlassian-browser-mcp MCP server

MCP server that wraps the upstream mcp-atlassian toolset with browser-cookie authentication via Playwright. Designed for Atlassian Server/Data Center instances behind corporate SSO (Okta, SAML, etc.) where API tokens are not available.

How it works

  1. On first use (or when the session expires), Playwright opens a real Chromium window for manual SSO/MFA
  2. After login, cookies are saved to a Playwright storage-state file
  3. All subsequent MCP tool calls use those cookies via a custom requests.Session subclass
  4. If an API response looks like an SSO redirect, the browser reopens automatically

The server monkey-patches JiraClient and ConfluenceClient constructors in mcp-atlassian to inject the browser-backed session, giving full parity with the upstream tool surface (72 tools + 1 atlassian_login helper = 73 total).

Files

FilePurpose
atlassian_browser_mcp_full.pyEntrypoint. Patches upstream clients, registers atlassian_login tool, runs the MCP server
atlassian_browser_auth.pyShared auth: BrowserCookieSession, interactive_login(), SSO detection
run-atlassian-browser-mcp.shLauncher: creates venv, installs deps via uv, runs compatibility check, starts server
pyproject.tomlDependency pins

Usage

./run-atlassian-browser-mcp.sh

Or configure as an MCP server in your editor (Cursor, Claude Code, etc.) pointing to the launcher script.

Environment variables

VariableDefaultDescription
JIRA_URL(required)Jira base URL (e.g. https://jira.example.com)
CONFLUENCE_URL(required)Confluence base URL (e.g. https://confluence.example.com)
ATLASSIAN_BROWSER_AUTH_ENABLEDtrueEnable browser auth (set false to fall back to token auth)
ATLASSIAN_BROWSER_PROFILE_DIR./.atlassian-browser-profilePersistent Chromium profile directory
ATLASSIAN_STORAGE_STATE./.atlassian-browser-state.jsonPlaywright storage-state file
ATLASSIAN_LOGIN_TIMEOUT_SECONDS300Seconds to wait for manual login
ATLASSIAN_USERNAME(none)Optional: prefill username on SSO page
ATLASSIAN_SSO_MARKERS(auto)Comma-separated URL/text markers for SSO redirect detection. Defaults cover Okta, ADFS, Azure AD, PingOne, Google SAML
TOOLSETSallWhich upstream toolsets to enable

Requirements

  • Python 3.12+
  • uv (for dependency management)
  • Chromium (installed automatically by Playwright)
  • Network access to your Atlassian instance

相关服务器

NotebookLM 网页导入器

一键将网页和 YouTube 视频导入 NotebookLM。超过 200,000 用户信赖。

安装 Chrome 扩展