---
name: opencurrent-playwright-mcp-browser
description: "Playwright MCP를 연결하면 에이전트가 브라우저를 직접 열어 화면을 보고 눌러 보므로, 고친 결과를 사람이 하나하나 열어 확인하는 수고가 줄어듭니다. 이럴 때 사용: 에이전트에 Playwright MCP 서버를 추가하고, 개발 서버 주소를 주어 화면을 열고 확인하게 합니다. 확인한 내용은 스크린샷과 함께 받아 사람이 마지막으로 봅니다. 명령과 설정 이름은 2026년 11월 21일에 Playwright MCP 공식 저장소로 확인했습니다. 도구: Playwright MCP, Claude Code, Codex CLI, Cursor."
metadata:
  source: "https://opencurrent.ai/w/playwright-mcp-browser"
  opencurrent-id: "playwright-mcp-browser"
  verification: "pending"
  exported-at: "2026-11-21T11:17:13.229Z"
---

# 브라우저로 화면 직접 확인시키기

Playwright MCP를 연결하면 에이전트가 브라우저를 직접 열어 화면을 보고 눌러 보므로, 고친 결과를 사람이 하나하나 열어 확인하는 수고가 줄어듭니다.

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/playwright-mcp-browser
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("playwright-mcp-browser")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

에이전트에 Playwright MCP 서버를 추가하고, 개발 서버 주소를 주어 화면을 열고 확인하게 합니다. 확인한 내용은 스크린샷과 함께 받아 사람이 마지막으로 봅니다. 명령과 설정 이름은 2026년 11월 21일에 Playwright MCP 공식 저장소로 확인했습니다.

## 준비물

- Node.js 20 이상
- 코딩 에이전트(Claude Code, Codex, Cursor 등)
- 로컬 개발 서버

## 단계

### 1. Claude Code에 추가 (명령 실행 · Claude Code)

Playwright MCP를 한 줄로 추가합니다. Node.js 20 이상이 필요합니다.

프롬프트:

```text
claude mcp add playwright npx @playwright/mcp@latest
```

기대 결과: 추가된 playwright 서버

확인 방법: /mcp에 playwright가 연결됨으로 보이는지 확인

### 2. Codex나 Cursor에 추가 (명령 실행 · Codex CLI)

Codex는 codex mcp add로, Cursor는 설정의 MCP에서 command 형식으로 npx @playwright/mcp@latest를 넣습니다.

프롬프트:

```text
codex mcp add playwright npx "@playwright/mcp@latest"
```

기대 결과: 추가된 playwright 서버

확인 방법: 도구 목록에 browser_로 시작하는 도구가 보이는지 확인

### 3. 화면 확인 맡기기 (AI에게 · Claude Code)

개발 서버를 띄운 뒤 주소와 확인할 것을 줍니다.

프롬프트:

```text
Playwright로 http://localhost:3000 을 열어 로그인 화면이 제대로 보이는지, 빈 칸으로 제출하면 오류 문구가 나오는지 확인하고 스크린샷을 찍어 알려 줘.
```

기대 결과: 확인 결과와 스크린샷

확인 방법: 받은 스크린샷이 실제 화면과 같은지 확인

### 4. 고치고 다시 확인 (AI에게 · Claude Code)

문제가 보이면 고치게 하고 같은 확인을 다시 돌립니다.

프롬프트:

```text
찾은 문제를 고치고, 같은 확인을 다시 해서 결과를 알려 줘.
```

기대 결과: 고친 뒤 확인 결과

확인 방법: 같은 흐름을 직접 한 번 눌러 확인

## 주의할 점

- 기본은 브라우저 창이 뜨는 방식. 창 없이 돌리려면 --headless
- 로그인된 실제 계정 화면을 열면 개인정보가 대화에 들어갈 수 있음. 테스트 계정으로
- 화면 확인이 잦으면 토큰을 많이 씀. Playwright CLI와 스킬 방식이 더 가벼울 수 있음

## 출처

- [Playwright MCP 저장소(Microsoft)](https://github.com/microsoft/playwright-mcp)
- [Claude Code 문서: MCP](https://code.claude.com/docs/en/mcp)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/playwright-mcp-browser 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
