atlassian-browser-mcp

Name: atlassian-browser-mcp
Author: GeiserX

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

MCP-Server, der das vorgelagerte mcp-atlassian Toolset mit Browser-Cookie-Authentifizierung via Playwright umschließt. Entwickelt für Atlassian Server/Data Center-Instanzen hinter Unternehmens-SSO (Okta, SAML, etc.), bei denen keine API-Token verfügbar sind.

Funktionsweise

Bei der ersten Verwendung (oder wenn die Sitzung abläuft) öffnet Playwright ein echtes Chromium-Fenster für die manuelle SSO/MFA-Anmeldung.
Nach der Anmeldung werden die Cookies in einer Playwright-Storage-State-Datei gespeichert.
Alle nachfolgenden MCP-Tool-Aufrufe verwenden diese Cookies über eine benutzerdefinierte requests.Session-Unterklasse.
Wenn eine API-Antwort wie eine SSO-Weiterleitung aussieht, öffnet sich der Browser automatisch erneut.

Der Server führt Monkey-Patches für die JiraClient- und ConfluenceClient-Konstruktoren in mcp-atlassian durch, um die browserbasierte Sitzung einzubinden. Dies bietet volle Parität mit dem vorgelagerten Tool-Umfang (72 Tools + 1 atlassian_login-Helfer = insgesamt 73).

Dateien

Datei	Zweck
`atlassian_browser_mcp_full.py`	Einstiegspunkt. Patcht vorgelagerte Clients, registriert das `atlassian_login`-Tool, startet den MCP-Server
`atlassian_browser_auth.py`	Gemeinsame Authentifizierung: `BrowserCookieSession`, `interactive_login()`, SSO-Erkennung
`run-atlassian-browser-mcp.sh`	Launcher: erstellt venv, installiert Abhängigkeiten via `uv`, führt Kompatibilitätsprüfung durch, startet Server
`pyproject.toml`	Abhängigkeits-Pins

Verwendung

./run-atlassian-browser-mcp.sh

Oder konfigurieren Sie ihn als MCP-Server in Ihrem Editor (Cursor, Claude Code, etc.), der auf das Launcher-Skript verweist.

Umgebungsvariablen

Variable	Standardwert	Beschreibung
`JIRA_URL`	(erforderlich)	Jira-Basis-URL (z. B. `https://jira.example.com`)
`CONFLUENCE_URL`	(erforderlich)	Confluence-Basis-URL (z. B. `https://confluence.example.com`)
`ATLASSIAN_BROWSER_AUTH_ENABLED`	`true`	Browser-Authentifizierung aktivieren (auf `false` setzen, um auf Token-Authentifizierung zurückzugreifen)
`ATLASSIAN_BROWSER_PROFILE_DIR`	`./.atlassian-browser-profile`	Permanentes Chromium-Profilverzeichnis
`ATLASSIAN_STORAGE_STATE`	`./.atlassian-browser-state.json`	Playwright-Storage-State-Datei
`ATLASSIAN_LOGIN_TIMEOUT_SECONDS`	`300`	Sekunden, die auf die manuelle Anmeldung gewartet werden soll
`ATLASSIAN_USERNAME`	(keine)	Optional: Benutzername auf der SSO-Seite vorab ausfüllen
`ATLASSIAN_SSO_MARKERS`	(automatisch)	Durch Kommas getrennte URL-/Text-Marker zur Erkennung von SSO-Weiterleitungen. Die Standardwerte decken Okta, ADFS, Azure AD, PingOne, Google SAML ab
`TOOLSETS`	`all`	Welche vorgelagerten Toolsets aktiviert werden sollen