용어집 항목

Chrome DevTools Protocol

Chromium 계열 브라우저의 원격 제어 인터페이스입니다. 로컬 디버깅 포트를 통해 프로그램이 탭을 검사하고 조작할 수 있습니다.

정의

Chrome DevTools Protocol(CDP)은 Chrome이 도구용으로 제공하는 인터페이스입니다. 내장 개발자 도구가 쓰는 바로 그 채널을 로컬 WebSocket으로 다른 프로그램에도 열어 줍니다. 이를 통해 프로그램은 탭을 열고, 페이지를 이동하고, DOM을 읽고, 입력을 보내고, 스크린샷을 찍을 수 있습니다.

Chrome 136부터 브라우저는 기본 사용자 데이터 디렉터리에 대해 기존 원격 디버깅 플래그를 무시합니다. 따라서 조작할 Chrome에는 inspect 페이지의 원격 디버깅 설정(Chrome 144 이상)이나, 자체 포트를 가진 전용 사용자 데이터 디렉터리가 필요합니다.

출처: Chrome DevTools Protocol · Chrome for Developers: Changes to remote debugging switches · chrome-devtools-mcp: configuration

예시

Chrome 144 이상을 쓰고 있습니다. chrome://inspect/#remote-debugging을 열어 원격 디버깅을 켜고 Chrome DevTools MCP를 --autoConnect로 시작합니다. Chrome이 연결을 허용할지 묻고, 사용하려는 창에서 승인하면 에이전트가 열려 있는 탭을 나열하고 조작할 수 있습니다.

격리된 환경을 원하거나 Chrome이 더 오래된 버전이라면, 자체 사용자 데이터 디렉터리를 가진 두 번째 Chrome을 9222 포트로 시작하고 MCP 서버가 http://127.0.0.1:9222를 가리키게 합니다. Chrome 136부터는 평소 쓰는 프로필에서 기존 플래그만으로는 더 이상 동작하지 않습니다. 두 명령은 아래에 있습니다.

# Mode A: Chrome 144+, remote debugging enabled on chrome://inspect/#remote-debugging
npx -y chrome-devtools-mcp@latest --autoConnect

# Mode B: dedicated profile on a loopback port
"<path to Chrome>" --remote-debugging-port=9222 --user-data-dir="$PWD/.browser/chrome" about:blank
npx -y chrome-devtools-mcp@latest --browserUrl=http://127.0.0.1:9222

디렉터리 출시에서 중요한 이유

CDP는 내가 로그인해 둔 브라우저를 에이전트가 조작할 수 있는 대상으로 바꿔 줍니다. 그래서 신중하게 다뤄야 합니다. 디버깅 포트는 로그인된 페이지를 포함해 브라우저 전체를 제어합니다. 포트를 루프백 주소에만 두고, 절대 터널링하지 않고, 작업 묶음이 끝나면 닫는 것은 선택적인 보안 강화가 아니라 설정의 일부입니다.

LaunchRepo가 다루는 방식

BROWSER-SETUP.md는 두 가지 모드를 제공합니다. A: Chrome 144 이상에서 chrome://inspect의 원격 디버깅을 켜고 Chrome DevTools MCP가 자동으로 연결하게 한 뒤, 사용할 창에서 연결 요청을 승인합니다. B: 자체 사용자 데이터 디렉터리를 가진 전용 Chrome을 127.0.0.1:9222에서 실행하고 MCP 서버가 그 URL을 가리키게 합니다. 두 모드를 동시에 쓰지 않고, 포트를 공개하지 않습니다. 프로세스가 실행 중이라는 것만으로는 접근으로 보지 않고, 보이는 탭이 실제로 움직여야 합니다.

더 알아보기

코딩 에이전트를 내 Chrome에 연결하기

두 연결 모드의 단계별 설명, 공개 페이지에서 하는 스모크 테스트, 작업 묶음이 끝난 뒤 디버깅 포트를 닫는 방법을 다룹니다.

저장소에서 이 용어를 직접 확인하세요

LaunchRepo는 디렉터리 플레이북 299개, 제품 정보 파일, 그리고 내 에이전트가 실행하는 제출 트래커로 이루어져 있습니다. €49.00를 한 번 결제하고, 내가 소유한 모든 제품에 쓰세요.

가격 보기