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-сервер, который оборачивает набор инструментов mcp-atlassian с аутентификацией через браузерные cookie с помощью Playwright. Предназначен для экземпляров Atlassian Server/Data Center, находящихся за корпоративным SSO (Okta, SAML и т. д.), где API-токены недоступны.

Как это работает

При первом использовании (или когда сессия истекает) Playwright открывает реальное окно Chromium для ручного входа через SSO/MFA.
После входа cookie сохраняются в файл состояния хранилища Playwright.
Все последующие вызовы инструментов MCP используют эти cookie через подкласс requests.Session.
Если ответ API выглядит как перенаправление на SSO, браузер открывается автоматически.

Сервер применяет monkey-patching к конструкторам JiraClient и ConfluenceClient в mcp-atlassian для внедрения сессии на базе браузера, обеспечивая полную функциональность с исходным набором инструментов (72 инструмента + 1 вспомогательный atlassian_login = всего 73).

Файлы

Файл	Назначение
`atlassian_browser_mcp_full.py`	Точка входа. Патчит исходные клиенты, регистрирует инструмент `atlassian_login`, запускает MCP-сервер
`atlassian_browser_auth.py`	Общая аутентификация: `BrowserCookieSession`, `interactive_login()`, обнаружение SSO
`run-atlassian-browser-mcp.sh`	Запуск: создает venv, устанавливает зависимости через `uv`, выполняет проверку совместимости, запускает сервер
`pyproject.toml`	Фиксация версий зависимостей

Использование

./run-atlassian-browser-mcp.sh

Или настройте его как MCP-сервер в вашем редакторе (Cursor, Claude Code и т. д.), указав путь к скрипту запуска.

Переменные окружения

Переменная	По умолчанию	Описание
`JIRA_URL`	(обязательно)	Базовый URL Jira (например, `https://jira.example.com`)
`CONFLUENCE_URL`	(обязательно)	Базовый URL Confluence (например, `https://confluence.example.com`)
`ATLASSIAN_BROWSER_AUTH_ENABLED`	`true`	Включить аутентификацию через браузер (установите `false` для перехода на аутентификацию по токену)
`ATLASSIAN_BROWSER_PROFILE_DIR`	`./.atlassian-browser-profile`	Директория постоянного профиля Chromium
`ATLASSIAN_STORAGE_STATE`	`./.atlassian-browser-state.json`	Файл состояния хранилища Playwright
`ATLASSIAN_LOGIN_TIMEOUT_SECONDS`	`300`	Время ожидания ручного входа в секундах
`ATLASSIAN_USERNAME`	(нет)	Опционально: предварительное заполнение имени пользователя на странице SSO
`ATLASSIAN_SSO_MARKERS`	(авто)	Маркеры URL/текста, разделенные запятыми, для обнаружения перенаправления SSO. По умолчанию охватывают Okta, ADFS, Azure AD, PingOne, Google SAML
`TOOLSETS`	`all`	Какие наборы инструментов включить