# 브라우저로 화면 직접 확인시키기
id: playwright-mcp-browser · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/playwright-mcp-browser
기준일: 2026-11-21 (여기서 고친 날)
도구: Playwright MCP, Claude Code, Codex CLI, Cursor
걸리는 시간: 약 15분
평가 점수: 32/100 (확인 없음 · 검수 대기)

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

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

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

단계:
1. [명령 실행 · Claude Code] Claude Code에 추가 — Playwright MCP를 한 줄로 추가합니다. Node.js 20 이상이 필요합니다.
   프롬프트:
   > claude mcp add playwright npx @playwright/mcp@latest
   기대 결과: 추가된 playwright 서버
   확인 방법: /mcp에 playwright가 연결됨으로 보이는지 확인
2. [명령 실행 · Codex CLI] Codex나 Cursor에 추가 — Codex는 codex mcp add로, Cursor는 설정의 MCP에서 command 형식으로 npx @playwright/mcp@latest를 넣습니다.
   프롬프트:
   > codex mcp add playwright npx "@playwright/mcp@latest"
   기대 결과: 추가된 playwright 서버
   확인 방법: 도구 목록에 browser_로 시작하는 도구가 보이는지 확인
3. [AI에게 · Claude Code] 화면 확인 맡기기 — 개발 서버를 띄운 뒤 주소와 확인할 것을 줍니다.
   프롬프트:
   > Playwright로 http://localhost:3000 을 열어 로그인 화면이 제대로 보이는지, 빈 칸으로 제출하면 오류 문구가 나오는지 확인하고 스크린샷을 찍어 알려 줘.
   기대 결과: 확인 결과와 스크린샷
   확인 방법: 받은 스크린샷이 실제 화면과 같은지 확인
4. [AI에게 · Claude Code] 고치고 다시 확인 — 문제가 보이면 고치게 하고 같은 확인을 다시 돌립니다.
   프롬프트:
   > 찾은 문제를 고치고, 같은 확인을 다시 해서 결과를 알려 줘.
   기대 결과: 고친 뒤 확인 결과
   확인 방법: 같은 흐름을 직접 한 번 눌러 확인

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

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