Playwright
접근성 트리 기반으로 브라우저를 제어하는 Microsoft 공식 서버
한눈에 보기
공식 검증 2026년 8월 29일
- 프로토콜
- MCP · 로컬 stdio
- 인증
- API 키·토큰 또는 서비스 자격증명
- 비용
- 서버는 무료 공개, 연결 서비스 비용은 별도 확인
- 제공 상태
- 공개 제공
Use cases
이럴 때 이렇게 연결합니다
먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.
추천 구성 · Situation 01
선택자 변화 때문에 테스트가 자주 깨지고 실제 사용자 흐름을 재현하기 어려운 업무
- 어떤 어려움인가
- 접근성 트리로 웹 흐름을 시험하는 QA·개발팀이 자주 마주치는 문제입니다. 구체적으로는 '선택자 변화 때문에 테스트가 자주 깨지고 실제 사용자 흐름을 재현하기 어려운 업무' 상황입니다.
- 이렇게 해결합니다
- Playwright 단계에서는 허용한 도구와 권한 범위 안에서 필요한 작업만 호출합니다. 입력 범위는 '테스트 URL, 역할·이름 기반 동작, 기대 결과'입니다. 필요한 필드만 골라 '단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표' 형태로 정리합니다.
- 왜 연결하는가
- 처음에는 Playwright 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
- 마지막 확인
- 검토 대상은 '단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
- 01 · 입력작은 입력 범위테스트 URL, 역할·이름 기반 동작, 기대 결과업무 조건
- 02 · 현재 자료PlaywrightMCP 도구 호출: 입력 범위는 '테스트 URL, 역할·이름 기반 동작, 기대 결과'입니다. 필요한 필드만 골라 '단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표' 형태로 정리합니다.처리 결과
- 03 · 사람 확인담당자 검토검토 대상은 '단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.확인 완료
- 04 · 결과검토용 결과단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표
Result
이 흐름으로 남는 값
추천 구성 · Situation 02
단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표을 다음 업무로 이어야 할 때
- 어떤 어려움인가
- '선택자 변화 때문에 테스트가 자주 깨지고 실제 사용자 흐름을 재현하기 어려운 업무' 문제를 한 번 처리해도 결과를 다음 업무로 다시 옮기면 복사·누락·중복이 생깁니다.
- 이렇게 해결합니다
- Playwright 단계에서는 허용한 도구와 권한 범위 안에서 필요한 작업만 호출합니다. 입력 범위는 '테스트 URL, 역할·이름 기반 동작, 기대 결과'입니다. 필요한 필드만 골라 '단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표' 형태로 정리합니다. 다음 단계인 Skill: Webapp Testing에서는 '단계별 증거와 실패 위치가 있는 웹앱 검증 보고서' 형태로 업무 문맥을 보강합니다.
- 왜 연결하는가
- Playwright의 결과에는 원문 식별자와 처리 시각을 붙여 Skill: Webapp Testing로 전달합니다. 두 도구가 같은 판단을 반복하지 않도록 처리 역할과 보강 역할을 나눕니다.
- 마지막 확인
- 검토 대상은 '단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 이어서 검토 대상은 '단계별 증거와 실패 위치가 있는 웹앱 검증 보고서'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 두 단계 중 하나라도 근거가 비어 있으면 연결 결과를 미확정으로 남깁니다.
- 01 · 입력업무 입력테스트 URL, 역할·이름 기반 동작, 기대 결과정리된 입력
- 02 · 현재 자료Playwright단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표근거 포함 결과
- 업무 문맥 보강
- 04 · 결과연결 결과원문 근거와 두 단계의 처리 상태가 함께 남은 결과
Result
이 흐름으로 남는 값
추천 구성 · Situation 03
선택자 변화 때문에 테스트가 자주 깨지고 실제 사용자 흐름을 재현하기 어려운 업무를 반복 운영해야 할 때
- 어떤 어려움인가
- '선택자 변화 때문에 테스트가 자주 깨지고 실제 사용자 흐름을 재현하기 어려운 업무' 문제를 정기적으로 처리하려면 성공 경로뿐 아니라 권한 오류, 재실행, 승인 책임까지 정해야 합니다.
- 이렇게 해결합니다
- Playwright 단계에서는 허용한 도구와 권한 범위 안에서 필요한 작업만 호출합니다. 입력 범위는 '테스트 URL, 역할·이름 기반 동작, 기대 결과'입니다. 필요한 필드만 골라 '단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표' 형태로 정리합니다. 보강은 Skill: Webapp Testing, 전달과 후속 처리는 BrowserStack MCP로 분리합니다.
- 왜 연결하는가
- 같은 작업 ID가 Playwright → Skill: Webapp Testing → BrowserStack MCP 순서로 이어집니다. 마지막 반영 전에는 담당자가 대상과 근거를 확인하고 승인합니다.
- 마지막 확인
- 검토 대상은 '단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 실패한 단계만 다시 실행할 수 있도록 입력 버전·처리 시각·오류·승인자를 기록합니다.
- 업무 담당자01 · 입력반복 실행 입력테스트 URL, 역할·이름 기반 동작, 기대 결과과 작업 ID작업 요청
- 자동 처리02 · 현재 자료Playwright단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표1차 처리
- 외부 연결보강 데이터
- 외부 연결검토 요청
- 사람 확인05 · 사람 확인담당자 승인대상·근거·변경 내용을 확인한 뒤 마지막 반영을 승인승인·보류 기록
- 기록·알림06 · 결과기록·알림작업 ID, 처리 상태, 오류, 승인자를 저장하고 필요한 채널에 결과 전달추적 가능
Result
이 흐름으로 남는 값
연결
연결
npx @playwright/mcp@latest접근성 트리를 기반으로 브라우저를 제어하는 Microsoft 공식 서버입니다. 스크린샷 픽셀이나 시각 모델에 의존하지 않고 구조화된 접근성 스냅샷으로 페이지를 다루기 때문에 동작이 안정적이고 토큰 소모도 적습니다.
주요 기능
- 요소 조작: browser_click과 browser_hover, browser_fill_form
- 페이지 내부 확인: browser_console_messages와 browser_evaluate
- 상태 관리: 쿠키와 localStorage를 읽고 쓰는 도구로 로그인 상태를 만들거나 저장된 값을 검증
- browser_generate_locator: 선택자를 만들어 주므로 탐색 결과를 테스트 코드로 옮기기 쉬움
사용하려면 Playwright 브라우저 바이너리가 필요하고 npx로 바로 실행할 수 있으며, browser 옵션으로 Chrome과 Firefox, WebKit, Edge 중에서 고릅니다. headless 플래그로 CI 실행에 맞추고, isolated 플래그로 프로필을 디스크에 남기지 않는 격리 세션을 쓰며, storage-state로 미리 만든 로그인 상태를 주입할 수 있습니다. extension 옵션을 쓰면 이미 실행 중인 브라우저에 붙는 방식도 가능합니다.
E2E 테스트, 반복 웹 작업 자동화, 로그인 뒤 페이지 확인처럼 실제 브라우저 조작이 필요한 개발자에게 강력합니다.
댓글 0
아직 댓글이 없습니다. 첫 댓글을 남겨보세요.