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

Servidor MCP que envuelve el conjunto de herramientas original mcp-atlassian con autenticación mediante cookies de navegador a través de Playwright. Diseñado para instancias de Atlassian Server/Data Center detrás de SSO corporativo (Okta, SAML, etc.) donde los tokens de API no están disponibles.

Cómo funciona

En el primer uso (o cuando la sesión caduca), Playwright abre una ventana real de Chromium para el SSO/MFA manual.
Después de iniciar sesión, las cookies se guardan en un archivo de estado de almacenamiento de Playwright.
Todas las llamadas posteriores a herramientas MCP utilizan esas cookies a través de una subclase personalizada de requests.Session.
Si una respuesta de la API parece una redirección de SSO, el navegador se vuelve a abrir automáticamente.

El servidor aplica parches (monkey-patch) a los constructores de JiraClient y ConfluenceClient en mcp-atlassian para inyectar la sesión respaldada por el navegador, proporcionando paridad total con la superficie de herramientas original (72 herramientas + 1 asistente atlassian_login = 73 en total).

Archivos

Archivo	Propósito
`atlassian_browser_mcp_full.py`	Punto de entrada. Parchea los clientes originales, registra la herramienta `atlassian_login`, ejecuta el servidor MCP
`atlassian_browser_auth.py`	Autenticación compartida: `BrowserCookieSession`, `interactive_login()`, detección de SSO
`run-atlassian-browser-mcp.sh`	Lanzador: crea venv, instala dependencias mediante `uv`, ejecuta comprobación de compatibilidad, inicia el servidor
`pyproject.toml`	Versiones de dependencias

Uso

./run-atlassian-browser-mcp.sh

O configúralo como un servidor MCP en tu editor (Cursor, Claude Code, etc.) apuntando al script de lanzamiento.

Variables de entorno

Variable	Predeterminado	Descripción
`JIRA_URL`	(requerido)	URL base de Jira (ej. `https://jira.example.com`)
`CONFLUENCE_URL`	(requerido)	URL base de Confluence (ej. `https://confluence.example.com`)
`ATLASSIAN_BROWSER_AUTH_ENABLED`	`true`	Habilitar autenticación por navegador (establecer `false` para volver a la autenticación por token)
`ATLASSIAN_BROWSER_PROFILE_DIR`	`./.atlassian-browser-profile`	Directorio de perfil persistente de Chromium
`ATLASSIAN_STORAGE_STATE`	`./.atlassian-browser-state.json`	Archivo de estado de almacenamiento de Playwright
`ATLASSIAN_LOGIN_TIMEOUT_SECONDS`	`300`	Segundos de espera para el inicio de sesión manual
`ATLASSIAN_USERNAME`	(ninguno)	Opcional: rellenar previamente el nombre de usuario en la página de SSO
`ATLASSIAN_SSO_MARKERS`	(auto)	Marcadores de URL/texto separados por comas para la detección de redirección de SSO. Los valores predeterminados cubren Okta, ADFS, Azure AD, PingOne, Google SAML
`TOOLSETS`	`all`	Qué conjuntos de herramientas originales habilitar