Browser Use
기존 Chrome 세션에 대한 브라우저 작업에 사용합니다.
설정 복구 세부 사항은 mcporter-config.md에 있습니다.
경로
- 현재 세션에서 Codex
Chrome또는Chrome [Internal]플러그인을 호출할 수 있으면, 해당 플러그인에 번들된 Chrome 제어 기술을 사용합니다. - 그렇지 않으면 아래 mcporter
chrome-devtools경로를 사용합니다.
디스크에 번들 또는 설치되어 있다고 해서 사용 가능한 것은 아닙니다. 플러그인이 활성 세션에서 호출 가능해야 합니다. 두 경로 모두 사용자의 기존 Chrome 프로필을 사용해야 합니다.
mcporter 폴백의 경우 다음 대상을 사용하세요:
mcporter call chrome-devtools.<tool>
로그인이 많이 필요한 사이트는 격리된 프로필에서 대부분 실패합니다. 새 세션은 캡차, 장치 확인, SSO/확장 프로그램 상태 누락을 유발하기 때문입니다. 로그인이 필요한 모든 웹사이트에 대해 기존 Chrome 프로필을 강력히 선호합니다.
사용자가 명시적으로 격리된/새 브라우저를 요청하지 않는 한, 브라우저 제어에 chrome-isolated, Playwright, Puppeteer, Codex 앱 내 브라우저, AppleScript, osascript, GUI 스크립팅 또는 macOS open을 절대 사용하지 마십시오.
스크린샷/라이브 UI 버그는 이 기존 Chrome 경로가 필요합니다. curl, 소스 검사, Worker 스모크 테스트 또는 로컬 Playwright는 보조 증빙 자료일 뿐입니다. 사용자가 렌더링된 브라우저 문제를 보여주거나 페이지가 로그인/프로필 상태에 의존할 수 있는 경우 동등한 것으로 취급하지 마십시오.
MCP 확인
mcporter list chrome-devtools --schema
mcporter call chrome-devtools.list_pages --args '{}' --output text
list_pages는 사용자의 실제 열린 탭을 표시해야 합니다. 빈/기본 격리된 Chrome을 표시하면 중단하고 재연결 실패를 알리십시오.
호출이 Chrome이 인증/연결/업데이트 프롬프트를 표시하는 동안 중단된 것처럼 보이면, 폴백하기 전에 연결 알림을 처리하십시오. 보이는 Chrome Allow 버튼을 누르려면 Peekaboo를 선호하고, 그렇지 않으면 사람이 처리할 때까지 기다리십시오. 첫 번째 출력이 느리다고 데몬을 다시 시작하거나 MCP 프로세스를 종료하지 마십시오.
테스트된 연결 프롬프트 복구:
PB="${PEEKABOO_BIN:-$HOME/bin/peekaboo}"
[ -x "$PB" ] || PB="$(command -v peekaboo)"
"$PB" permissions status --json
"$PB" see --app frontmost --path /tmp/chrome-attach.png --json --annotate
# UI에 Chrome "Allow remote debugging?"이 표시되면, 보이는 Allow 버튼만 클릭하십시오.
"$PB" click --coords <allow_x>,<allow_y> --json
mcporter call chrome-devtools.list_pages --args '{}' --output text
오래된 메모가 아닌 현재 Peekaboo 스냅샷의 좌표를 사용하십시오. 성공은 list_pages가 사용자의 실제 Chrome 탭을 반환함을 의미합니다.
연결 알림 규칙: 현재 스냅샷에 Chrome이 DevTools/MCP/브라우저 자동화 연결을 허용하라는 메시지가 명확히 표시되면, 보이는 Allow 버튼을 한 번 클릭한 다음 list_pages를 다시 실행하십시오. 버튼이 보이지 않거나 프롬프트가 모호하면 중단하고 물어보십시오. 조용히 Playwright/Puppeteer로 전환하지 마십시오.
list_pages가 DevToolsActivePort 오류로 실패하면, 사용자에게 Chrome 또는 DevTools 브리지를 다시 시작하도록 요청한 후 한 번 재시도하십시오:
mcporter daemon restart
mcporter call chrome-devtools.list_pages --args '{}' --output text
여전히 실패하면 중단하고 Chrome DevTools MCP를 사용할 수 없다고 알리십시오. AppleScript를 사용하지 마십시오.
시끄러운 복구 루프를 피하십시오. 반복된 MCP/브라우저 재시작은 재연결/로그인 프롬프트 및 알림을 트리거할 수 있습니다. 한 번 시도한 후 일시 중지하고 더 조용한 경로를 선택하십시오.
일반적인 흐름
# list_pages에서 페이지 ID 선택
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
# 페이지 검사
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
# 선택한 페이지 탐색
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
# 최신 스냅샷의 요소 uid 클릭
mcporter call chrome-devtools.click --args '{"uid":"1_38","includeSnapshot":true}' --output text
# 입력/채우기
mcporter call chrome-devtools.fill --args '{"uid":"1_13","value":"text","includeSnapshot":true}' --output text
# JS 실행, 출력에서 비밀 유지
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.title"}' --output json
작업 전에 take_snapshot을 사용하고 현재 uid 값만 사용하십시오. 시각적 레이아웃이 중요하지 않으면 take_screenshot을 피하십시오.
라이브 UI 증명
스크린샷 회귀, 배포된 대시보드 확인 또는 렌더링된 브라우저가 버그인 모든 경우:
mcporter call chrome-devtools.list_pages --args '{}' --output text
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.body.innerText"}' --output json
기존 로그인/프로필을 포함하는 탭 세트를 사용하십시오. 브라우저 자동화를 사용할 수 없으면, 격리된 브라우저 도구로 대체하는 대신 이를 검증 격차로 보고하십시오.
비밀 처리
페이지 DOM, 네트워크 로그 또는 입력에서 토큰/비밀번호를 절대 출력하지 마십시오. 토큰 확인의 경우 모양만 반환하십시오: 있음/없음, 길이, 상태 코드, 계정/조직 이름.