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

Playwright를 통한 브라우저 쿠키 인증으로 상위 mcp-atlassian 도구 세트를 래핑하는 MCP 서버입니다. API 토큰을 사용할 수 없는 기업용 SSO(Okta, SAML 등) 환경의 Atlassian Server/Data Center 인스턴스를 위해 설계되었습니다.

작동 방식

처음 사용 시(또는 세션 만료 시), Playwright가 수동 SSO/MFA를 위한 실제 Chromium 창을 엽니다.
로그인 후, 쿠키가 Playwright 스토리지 상태 파일에 저장됩니다.
이후의 모든 MCP 도구 호출은 사용자 지정 requests.Session 하위 클래스를 통해 해당 쿠키를 사용합니다.
API 응답이 SSO 리디렉션으로 보이면 브라우저가 자동으로 다시 열립니다.

이 서버는 mcp-atlassian의 JiraClient 및 ConfluenceClient 생성자를 몽키 패치하여 브라우저 기반 세션을 주입함으로써, 상위 도구 표면과 완벽한 호환성을 제공합니다(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`	실행기: 가상 환경 생성, `uv`를 통한 종속성 설치, 호환성 검사 실행, 서버 시작
`pyproject.toml`	종속성 고정

사용법

./run-atlassian-browser-mcp.sh

또는 편집기(Cursor, Claude Code 등)에서 실행기 스크립트를 가리키는 MCP 서버로 구성하십시오.

환경 변수

변수	기본값	설명
`JIRA_URL`	(필수)	Jira 기본 URL (예: `https://jira.example.com`)
`CONFLUENCE_URL`	(필수)	Confluence 기본 URL (예: `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`	(자동)	SSO 리디렉션 감지를 위한 쉼표로 구분된 URL/텍스트 마커. 기본값은 Okta, ADFS, Azure AD, PingOne, Google SAML을 포함합니다.
`TOOLSETS`	`all`	활성화할 상위 도구 세트