convez.ai
MCP ServerIntegração & APIsAvançado
baekchangjoon

Atlassian Browser Skills

baekchangjoon/atlassian-browser-skills

Controle Jira/Confluence via navegador autenticado, sem APIs bloqueadas

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que lê e escreve em Jira e Confluence através do navegador local já autenticado (Safari/Chrome/Edge), sem precisar de token de API. Solução para ambientes corporativos onde APIs externas e MCP são bloqueados — executa operações via fetch() no contexto autenticado do navegador.

Instalação

$npx convez-ai baekchangjoon/atlassian-browser-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
v1.4.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de tarefas Jira/Confluence em ambientes com restrições de segurança corporativa
  • Leitura e criação de issues, comentários e páginas Confluence via agente LLM
  • Workaround para corporações que bloqueiam MCP e tokens API pessoais

Veredito

Solução criativa e prática para contornar restrições corporativas, usando o próprio navegador autenticado como canal de comunicação com Atlassian. Bem-testado (macOS/Windows), mas requer compreensão técnica de como funciona o protocolo DevTools e segurança de contexto de navegador.

README

A tradução para o português deste README ainda está na fila.

atlassian-browser-skills

🌐 한국어 (현재 문서) · English

Atlassian MCP·API 토큰이 막혀 있거나 쓸 수 없는 환경에서, 사용자가 이미 로그인해 둔 로컬 브라우저(Safari/Chrome/Edge)를 구동해 LLM 에이전트로 Jira·Confluence를 읽고 쓰는 스킬 모음입니다. API 토큰도, MCP도 필요 없습니다.

설치

Claude Code (플러그인 마켓플레이스 — 권장)

이 저장소는 Claude Code 플러그인 마켓플레이스입니다. Claude Code 안에서:

/plugin marketplace add baekchangjoon/atlassian-browser-skills
/plugin install atlassian-browser-skills@atlassian-browser-skills
/reload-plugins

설치하면 두 스킬(atlassian-browser-macos, atlassian-browser-windows)이 함께 들어오고, OS·작업에 따라 모델이 알아서 호출합니다.

스킬만 직접 설치 (플러그인 없이)

Agent Skills 호환 에이전트(Claude Code/Claude.ai/Cursor/Gemini CLI 등) 어디서나 스킬 폴더만 복사해 쓸 수 있습니다:

git clone https://github.com/baekchangjoon/atlassian-browser-skills
cp -r atlassian-browser-skills/skills/atlassian-browser-macos   ~/.claude/skills/   # macOS
cp -r atlassian-browser-skills/skills/atlassian-browser-windows ~/.claude/skills/   # Windows

스킬이 참조하는 공용 cookbook은 저장소 루트의 references/atlassian-rest-cookbook.md에 있습니다. 스킬만 떼어 쓸 땐 그 경로도 함께 두세요(플러그인 설치 시에는 자동 포함).

업데이트 받기

서드파티 마켓플레이스는 Claude Code에서 자동 업데이트가 기본 꺼져 있어, 새 버전이 릴리스돼도 설치본은 그대로입니다. 둘 중 하나를 선택하세요:

  • 수동 업데이트 — 새 버전이 나왔을 때:
    /plugin marketplace update atlassian-browser-skills
    /plugin update atlassian-browser-skills@atlassian-browser-skills
    
  • 자동 업데이트 켜기 (1회 설정, 권장): /plugin → Marketplaces 탭 → atlassian-browser-skills 선택 → Enable auto-update. 이후 Claude Code 시작 시 자동으로 최신 버전이 반영됩니다.

아이디어

막혀 있는 것은 외부 접근 경로(Atlassian MCP, 개인 API 토큰)입니다. 정작 사용자가 평소 Jira/Confluence를 여는 브라우저 자체는 막히지 않습니다. 그래서 외부 API 클라이언트를 쓰는 대신, 인증된 브라우저 탭 안에서 동일 출처(same-origin) fetch()를 실행해 Atlassian 자기 자신의 REST API — Jira/Confluence SPA가 내부적으로 쓰는 바로 그 엔드포인트 — 를 호출합니다.

LLM 에이전트
  └─ skill (REST cookbook에서 고른 METHOD + PATH + BODY)
       └─ transport: 로그인된 탭에서 JS 실행
            ├─ macOS:   osascript → Safari / Chrome  (do JavaScript / execute javascript)
            └─ Windows: PowerShell/Python → Chrome DevTools Protocol (Runtime.evaluate)
                 └─ fetch(location.origin + PATH)  ← 세션 쿠키 / SSO 자동 포함
                      └─ Atlassian REST API  →  이슈·페이지 CRUD

장점: API 토큰·MCP·추가 로그인 모두 불필요. 그리고 DOM 스크래핑이 아니라 REST API를 호출하므로 결과가 구조적이고 안정적입니다.

구성

references/atlassian-rest-cookbook.md      # 공용: 모든 엔드포인트 + 페이로드 (Jira/Confluence, Cloud & DC)
skills/
  atlassian-browser-macos/                 # Safari 또는 Chrome, osascript 사용 (실 세션)
    SKILL.md
    scripts/atl_safari.sh                   #   Safari 래퍼: fetch JS 생성 → osascript 실행 → 폴링
    scripts/safari_atl.applescript          #     탭 찾기 + do JavaScript + 폴링
    scripts/atl_chrome_mac.sh               #   Chrome 래퍼 (인터페이스 동일)
    scripts/chrome_atl.applescript          #     탭 찾기 + execute javascript + 폴링
  atlassian-browser-windows/               # Chrome DevTools Protocol
    SKILL.md
    scripts/atl_cdp.ps1                      #   권장 — 무설치 (윈도 내장 PowerShell)
    scripts/atl_cdp.py                       #   선택 대안 — 순수 stdlib Python (pip 불필요)
    scripts/atl_playwright.py                #   대안 — Playwright (pip), CDP attach
    scripts/launch-chrome.ps1               #   디버그 포트로 Chrome/Edge 실행

macOS — Safari / Chrome (osascript)

macOS의 osascript는 이미 실행 중인 Safari/Chrome에 붙어 JS를 실행합니다. 재실행도, 디버그 포트도, 별도 프로파일도 필요 없이 로그인된 실 세션을 그대로 씁니다.

브라우저스크립트방식
Safariatl_safari.shdo JavaScript
Chromeatl_chrome_mac.shexecute javascript

두 방식 모두 promise를 await할 수 없어, 결과를 window 전역에 저장하고 폴링합니다(자동 처리됨).

일회성 설정 후 읽기 테스트

Safari

  1. 개발자용 메뉴 표시: Safari ▸ 설정…(⌘,) ▸ 고급 ▸ "웹 개발자용 기능 보기" 체크
  2. Apple Events JS 허용: 메뉴 막대 개발자용 ▸ "Apple Events의 JavaScript 허용" 체크
  3. 자동화 권한 승인: 최초 실행 시 팝업에서 허용 (또는 시스템 설정 ▸ 개인정보 보호 및 보안 ▸ 자동화 ▸ 터미널 → Safari)
  4. Safari 탭에서 Atlassian 사이트에 로그인하고 탭을 열어 둠
  5. 실행: skills/atlassian-browser-macos/scripts/atl_safari.sh GET /rest/api/3/myself → "status":200 기대

Google Chrome — 토글 하나, 로그인된 실 Chrome 사용

  1. Apple Events JS 허용: 메뉴 막대 보기 ▸ 개발자용 ▸ "Apple Events의 JavaScript 허용" 체크
  2. 자동화 권한 승인 (시스템 설정 ▸ 개인정보 보호 및 보안 ▸ 자동화 ▸ 터미널 → Google Chrome)
  3. Chrome 탭에서 Atlassian 사이트에 로그인하고 탭을 열어 둠
  4. 실행: skills/atlassian-browser-macos/scripts/atl_chrome_mac.sh GET /rest/api/3/myself → "status":200 기대

토글을 켜지 않으면 모든 호출이 {"status":0,"ok":false,"error":"inject failed: ... Allow JavaScript from Apple Events ..."} 를 반환합니다. 상세: skills/atlassian-browser-macos/SKILL.md

Windows — Chrome DevTools Protocol

macOS와 달리 Windows에는 실행 중인 Chrome에 붙는 osascript 같은 브리지가 없습니다. 로그인된 탭에서 JS를 돌려 결과를 받는 유일한 방법은 디버그 포트의 CDP입니다. 다만 CDP 클라이언트를 윈도 내장 PowerShell로 작성했으므로 설치할 것이 없습니다 — 이것이 osascript에 대응하는 가벼운 기본 내장 답입니다. Python은 필수가 아닙니다.

클라이언트설치 부담선택 기준
atl_cdp.ps1 (PowerShell)없음 — 윈도 기본 내장✅ 권장
atl_cdp.py (Python)Python만, pip 불필요 (stdlib WebSocket)선택 — Python으로 다루고 싶을 때
atl_playwright.py (Playwright)pip install playwright선택 — 이미 Playwright를 표준으로 쓸 때

macOS 대비 유일하게 불가피한 단계는 Chrome을 한 번 디버그 포트 플래그로 실행하는 것입니다.

# 1) 디버그 포트로 Chrome/Edge 실행 (전용 프로파일)
powershell -ExecutionPolicy Bypass -File skills\atlassian-browser-windows\scripts\launch-chrome.ps1
# 2) 그 창에서 Atlassian 사이트에 로그인 (최초 1회)
# 3) 읽기 테스트
powershell -ExecutionPolicy Bypass -File skills\atlassian-browser-windows\scripts\atl_cdp.ps1 -Method GET -Path /rest/api/3/myself

재로그인조차 피하려면 Chrome을 완전히 종료한 뒤 기존 프로파일로 --remote-debugging-port=9222 --remote-allow-origins=*만 붙여 재실행하면 기존 SSO 쿠키가 그대로 쓰입니다. 상세: skills/atlassian-browser-windows/SKILL.md

사용 예시 (엔드포인트 선택)

호출은 METHOD + PATH + BODY만 고르면 됩니다. 전체 엔드포인트·페이로드는 references/atlassian-rest-cookbook.md 참고.

SH=skills/atlassian-browser-macos/scripts/atl_safari.sh   # 또는 atl_chrome_mac.sh

# 읽기
"$SH" GET  /rest/api/3/myself
# JQL 검색
"$SH" POST /rest/api/3/search/jql '{"jql":"project = ABC AND statusCategory != Done","maxResults":20}'
# 이슈 생성 (Cloud는 description에 ADF 사용)
"$SH" POST /rest/api/3/issue '{"fields":{"project":{"key":"ABC"},"issuetype":{"name":"Task"},"summary":"Hello"}}'
# Confluence 페이지 생성 (Cloud는 /wiki 하위)
"$SH" POST /wiki/rest/api/content '{"type":"page","title":"New","space":{"key":"DOCS"},"body":{"storage":{"value":"<p>hi</p>","representation":"storage"}}}'

모든 호출은 {"status":200,"ok":true,"data":{...}} JSON을 반환합니다.

Cloud vs Server / Data Center

  • Cloud (*.atlassian.net): Jira /rest/api/3, Confluence /wiki/rest/api
  • Server/DC (자체 호스팅): Jira /rest/api/2, Confluence /rest/api. 호스트 필터(ATL_HOST / -HostFilter)를 해당 호스트 URL의 일부로 지정.

개인정보 (Privacy)

이 스킬/플러그인은 개인정보를 수집·저장·전송하지 않습니다.

  • 모든 동작은 사용자의 로컬 브라우저 세션 안에서 실행됩니다(macOS는 osascript, Windows는 Chrome DevTools Protocol).
  • 네트워크 호출은 사용자 브라우저 → 사용자 자신의 Atlassian 인스턴스가 전부입니다 — 평소 브라우저가 하던 그대로이며, 이 프로젝트가 제3자 서버로 보내는 데이터는 없습니다.
  • API 토큰·비밀번호·자격증명을 다루거나 저장하지 않습니다(브라우저의 기존 세션 쿠키만 사용).
  • 분석·텔레메트리 없음, 백그라운드 수집 없음.

영어 버전: README.en.md#privacy

안전 수칙

읽기(GET, JQL/CQL)는 자유롭게 가능합니다. 쓰기(POST/PUT/DELETE — 생성·수정·삭제·댓글·전환)는 실제 Jira/Confluence 데이터를 바꿉니다. 대상을 명시하고 사용자 승인을 먼저 받으세요. 명시적 확인 없이 대량 삭제하지 마세요. 정식 MCP/API 경로가 가능하다면 그쪽을 우선 사용하세요.

제약

  • 대상 사이트에 로그인된 브라우저 탭이 열려 있어야 합니다.
  • macOS의 do JavaScript/execute javascript는 promise를 await할 수 없어 폴링으로 결과를 받습니다(자동 처리).
  • 비표준 리버스 프록시를 쓰는 자체 호스팅 인스턴스는 ATL_HOST와 base path 조정이 필요할 수 있습니다.

라이선스

MIT

Ver o original no GitHub

Bom para

Relacionados