자료실
개발도구MCP 서버official

Playwright

접근성 트리 기반으로 브라우저를 제어하는 Microsoft 공식 서버

자료 등록 2026년 4월 1일

한눈에 보기

공식 검증 2026년 8월 29일

프로토콜
MCP · 로컬 stdio
인증
API 키·토큰 또는 서비스 자격증명
비용
서버는 무료 공개, 연결 서비스 비용은 별도 확인
제공 상태
공개 제공
공식 빠른 시작GitHub · https://github.com/microsoft/playwright-mcp

Use cases

이럴 때 이렇게 연결합니다

먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.

추천 구성 · Situation 01

선택자 변화 때문에 테스트가 자주 깨지고 실제 사용자 흐름을 재현하기 어려운 업무

어떤 어려움인가
접근성 트리로 웹 흐름을 시험하는 QA·개발팀이 자주 마주치는 문제입니다. 구체적으로는 '선택자 변화 때문에 테스트가 자주 깨지고 실제 사용자 흐름을 재현하기 어려운 업무' 상황입니다.
이렇게 해결합니다
Playwright 단계에서는 허용한 도구와 권한 범위 안에서 필요한 작업만 호출합니다. 입력 범위는 '테스트 URL, 역할·이름 기반 동작, 기대 결과'입니다. 필요한 필드만 골라 '단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표' 형태로 정리합니다.
왜 연결하는가
처음에는 Playwright 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
마지막 확인
검토 대상은 '단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
Sequence입력부터 검토 결과까지
  1. 01 · 입력작은 입력 범위테스트 URL, 역할·이름 기반 동작, 기대 결과
    업무 조건
  2. 02 · 현재 자료PlaywrightMCP 도구 호출: 입력 범위는 '테스트 URL, 역할·이름 기반 동작, 기대 결과'입니다. 필요한 필드만 골라 '단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표' 형태로 정리합니다.
    처리 결과
  3. 03 · 사람 확인담당자 검토검토 대상은 '단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.
    확인 완료
  4. 04 · 결과검토용 결과단계별 화면 상태와 실패 위치가 기록된 브라우저 테스트표

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

아직 댓글이 없습니다. 첫 댓글을 남겨보세요.

문의하기