DEV Community

Cover image for OpenCode Browse란 무엇일까요?
Rihpig
Rihpig

Posted on Originally published at apidog.com

OpenCode Browse란 무엇일까요?

OpenCode Browse는 MCP 서버와 Chromium 확장 프로그램의 결합으로, 코딩 에이전트가 실제 브라우저를 사용할 수 있게 해줍니다. 즉, 여러분의 탭, 로그인 세션, 확장 프로그램을 그대로 사용할 수 있습니다. 에이전트는 백그라운드 탭 그룹에서 탭을 열고, 페이지를 읽고, 클릭하고, 입력하고, 스크린샷을 찍고, 탭을 녹화하며, 네트워크 트래픽을 캡처합니다. 로그인, 2FA 인증, 결제처럼 사람이 개입해야 하는 단계에서는 해당 탭을 여러분에게 다시 넘겨줍니다.

지금 Apidog를 사용해 보세요

Browse는 OpenCode를 만든 Anomaly 팀이 개발했으며, OpenCode뿐 아니라 모든 MCP 클라이언트에서 작동합니다. 버전 0.1.0은 2026년 11월 16일에 출시되었으며, 소스는 MIT 라이선스로 공개되어 있습니다.

아래에서는 이 도구의 구성 요소가 어떻게 맞물리는지, 설치 방법, 핸드오프와 허용 사이트 작동 방식, Playwright MCP 및 Chrome DevTools MCP와의 비교, 그리고 에이전트가 캡처한 트래픽을 Apidog CLI로 테스트된 API로 전환하는 방법을 다룹니다.

OpenCode Browse란?

OpenCode Browse는 작은 네이티브 MCP 서버(browse CLI)와 브라우저 확장 프로그램으로 구성되어 있으며, AI 코딩 에이전트가 여러분이 이미 사용 중인 브라우저에 통제된 방식으로 접근할 수 있게 해줍니다. 에이전트는 자체 그룹화된 탭에서 작업하고, 사람과 유사한 입력 방식으로 페이지를 조작하며, 로그인, 2FA, 결제 단계에서는 여러분을 기다립니다.

OpenCode Browse

항목 세부 정보
개발사 Anomaly (OpenCode 팀)
구성 요소 browse CLI 및 MCP 서버, Chrome 웹 스토어 확장 프로그램
지원 브라우저 Chrome, Edge, Brave, Arc, Helium, Vivaldi, Opera, Chromium
MCP 클라이언트 OpenCode, Claude Code, Cursor, Codex, Zed 등 30개 이상
라이선스 MIT
최신 릴리스 v0.1.0, 2026년 11월 16일
가격 제품 페이지에 가격 정보 없음

에이전트용 대부분의 브라우저 도구는 새로운 프로파일을 생성하기 때문에, 에이전트는 여러분이 로그인한 어떤 서비스도 볼 수 없습니다. Browse는 이를 뒤집습니다. 에이전트가 여러분 자신의 프로파일 안에서 작동하기 때문에, 로그인되어 있는 대시보드나 관리자 패널이 바로 그 자리에 있고 API 키를 넘겨줄 필요도 없습니다.

Browse의 작동 방식: MCP 서버, 릴레이, 확장 프로그램

Browse는 세 가지 구성 요소로 이루어져 있습니다.

Browse 아키텍처 다이어그램

  1. MCP 서버. 에이전트가 작은 stdio 프로세스인 browse mcp를 실행합니다.
  2. 릴레이. 필요할 때 127.0.0.1:19988(최대 19997까지 다음 사용 가능 포트)에서 시작되며, 에이전트 탭, 핸드오프, 녹화, 네트워크 캡처를 관리하고 사용하는 것이 없으면 종료됩니다.
  3. 확장 프로그램. WebSocket을 통해 릴레이에 연결되고 chrome.debugger를 통해 브라우저에서 명령을 실행합니다.

탭이 핵심 요소입니다. 에이전트가 탭 지정 없이 navigate를 호출하면, Browse가 백그라운드 탭을 열고 그 id를 반환하며, 이후 모든 호출에서 이 id를 전달합니다. 에이전트는 자신이 연 탭이나 여러분이 빌려준 탭만 조작할 수 있고, 10분간 사용하지 않는 탭은 자동으로 닫힙니다.

OpenCode는 일반 도구들(navigate, snapshot, click, fill, screenshot, network, recording 등)을 사용합니다. 다른 MCP 클라이언트는 execute, status, tabs를 사용하며, execute는 모든 도구를 호출할 수 있는 Playwright 스타일의 page 객체와 함께 샌드박스 처리된 JavaScript를 실행합니다. 각 도구는 CLI 명령이기도 합니다. 예를 들어 browse navigate https://example.com은 탭 id를 출력합니다.

OpenCode Browse 설치 방법

제품 페이지에서는 Chrome 확장 프로그램부터 시작하는 것을 권장하며, 이후 과정을 확장 프로그램이 안내해 줍니다. 터미널에서는 README에 다음과 같이 안내되어 있습니다:

# macOS and Linux
curl -fsSL https://opencode.ai/browse/install | bash

# Windows PowerShell
irm https://opencode.ai/browse/install.ps1 | iex

# npm or bun
npm install -g @opencode/browse && browse install
bun add -g @opencode/browse && browse install
Enter fullscreen mode Exit fullscreen mode

또는 에이전트에게 한 줄을 붙여넣을 수도 있습니다: "내 Chrome을 사용할 수 있도록 browse를 설정해 줘: curl -fsSL https://opencode.ai/browse/install | bash를 실행해." 그러면 Browse가 해당 에이전트에 맞게 스스로를 설정합니다.

browse install은 세 가지 작업을 수행합니다:

  1. browse 바이너리를 설치하고 PATH에 추가합니다.
  2. 선택 도구를 통해, 또는 browse install -a claude codex로 직접 에이전트에 MCP 서버를 추가합니다.
  3. 확장 프로그램을 페어링하며, 아직 어떤 브라우저에도 설치되어 있지 않으면 Chrome 웹 스토어 페이지를 엽니다.

실행 중인 에이전트를 재시작하여 서버를 로드한 다음, "news.ycombinator.com을 열고 상위 스토리를 알려줘"를 시도해 보세요. 설치 프로그램이 인식하지 못하는 클라이언트의 경우, browse install --agent none이 수동으로 붙여넣을 stdio 진입점을 출력합니다. 이 프로토콜이 처음이라면 Model Context Protocol 문서에서 클라이언트가 서버를 로드하는 방식을 설명해 줍니다.

핸드오프, 탭 빌려주기, 허용 사이트

이 세 가지 기능이 여러분이 유지하는 통제 수준을 결정합니다.

핸드오프. 에이전트가 로그인, 2FA 인증, 결제에 직면하면 handoff를 호출합니다. 페이지에는 해당 사이트의 오리진이 표시된 작은 카드가 나타나고 배지는 WAIT으로 바뀝니다. 여러분이 사람이 해야 할 부분을 처리한 다음 Continue를 클릭합니다. 실제 클릭만이 핸드오프를 완료할 수 있으므로 페이지가 이를 위조할 수 없습니다.

탭 빌려주기. 열려 있는 탭에서 Browse 툴바 버튼을 클릭하면 배지가 ON으로 표시되어 에이전트가 해당 탭을 사용할 수 있습니다. 다시 클릭하면 실행 도중이라도 탭을 되찾을 수 있습니다.

허용 사이트와 읽기 전용 탭. 에이전트는 allowedOrigins로 탭을 열어 탐색과 팝업을 지정한 사이트로 제한하거나, readOnly로 열어 클릭, 입력, 업로드, 탐색을 차단할 수 있습니다. README는 이것이 데이터 경계가 아닌 가드레일임을 분명히 하고 있습니다. 페이지가 스스로 보내는 요청은 필터링되지 않으며, eval은 읽기 전용 탭에서도 실행됩니다. 에이전트가 특정 페이지를 읽지 않기를 원한다면, Browse에서 열지 않으면 됩니다.

README에 명시된 기타 보호 조치:

  • 릴레이는 기본적으로 127.0.0.1에서만 수신하며, 여러분만 읽을 수 있는 토큰이 필요합니다.
  • 페어링 코드는 10분 이내에 한 번만 사용할 수 있으며, 브라우저마다 고유 키가 부여됩니다.
  • 네트워크 캡처는 인증 헤더, API 키, 쿠키 값, 비밀로 추정되는 이름의 필드를 마스킹합니다. 다만 평범한 이름의 비밀 정보는 그대로 노출될 수 있으므로, 공유 전에 캡처 내용을 검토하세요.
  • 쿠키 삭제, 브라우저 종료, 사이트 권한 변경은 거부됩니다.

OpenCode Browse vs Playwright MCP vs Chrome DevTools MCP

세 도구 모두 MCP를 통해 에이전트가 Chromium 브라우저를 조작할 수 있게 해줍니다. 다만 기본 전제가 서로 다릅니다.

OpenCode Browse Playwright MCP Chrome DevTools MCP
기본 브라우저 실행 중인 여러분의 브라우저와 프로파일 자체 영구 프로파일을 사용하는 브라우저를 새로 실행 도구가 필요할 때 시작하는 Chrome
여러분의 로그인 사용 예, 기본적으로 지원 예, --extension 및 Playwright Extension을 통해 예, 실행 중인 Chrome에 연결하여
사람에게 넘기기 내장 handoff 카드 README에 언급 없음 README에 언급 없음
네트워크 캡처 예, 자격 증명 마스킹 예, 요청 목록 및 세부 정보 예, 요청 분석
성능 추적 목록에 없는 도구 주요 목표가 아님 예, 인사이트 제공
라이선스 MIT Apache-2.0 Apache-2.0

출처: Playwright MCP README 및 Chrome DevTools MCP README, 2026년 11월 17일 확인.

용도에 따라 선택하세요:

  • 에이전트가 여러분의 로그인 세션이 필요하고, 로그인과 결제 단계에서 직접 개입하고 싶다면 Browse를 선택하세요.
  • 깨끗하거나 격리된 프로파일에서 반복 가능한 엔드투엔드 흐름이 필요하다면 Playwright MCP를 선택하세요. Playwright MCP 가이드를 참고하세요.
  • 성능, 콘솔 오류, 느린 요청을 분석해야 한다면 Chrome DevTools MCP를 선택하세요. Chrome DevTools MCP 연결 방법을 참고하세요.

이들은 별개의 서버이므로, 하나의 에이전트가 같은 세션에서 로그인된 관리자 패널에는 Browse를, 테스트 실행에는 Playwright MCP를 사용할 수 있습니다.

Apidog CLI로 캡처한 트래픽을 테스트된 API로 전환하기

많은 웹 앱이 공개된 명세 없이 내부 API를 호출합니다. 에이전트가 로그인된 브라우저에서 앱을 열고, Browse로 트래픽을 캡처한 다음, Apidog CLI에 넘겨주면 CLI가 이를 가져와 테스트합니다. 여러분은 프롬프트 하나만 작성하면 됩니다.

Apidog CLI 파이프라인 다이어그램

Browse의 변경 로그는 네트워크 캡처를 HAR 파일로 설명하고 있으며, Apidog CLI는 --format har로 HAR을 가져올 수 있습니다. 먼저 CLI를 한 번 설정하세요:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Enter fullscreen mode Exit fullscreen mode

또는 에이전트에게 이렇게 말하세요: "https://apidog.com/apidog-cli-installation-guide.md를 읽고 Apidog CLI를 설정해 줘." 이 가이드는 에이전트를 위해 작성된 것입니다.

그런 다음 에이전트에게 프롬프트 하나를 주세요:

Use browse to open https://app.example.com/orders in my browser and capture
its network traffic while you load the orders list and open one order.
Save the capture as a HAR file. Import it into Apidog project 123456,
then create a test case for GET /api/orders that asserts status 200 and
a non-empty items array, run it against environment 7890 and summarize failures.
Enter fullscreen mode Exit fullscreen mode

캡처 후 에이전트는 다음과 같은 명령을 실행합니다:

apidog import --project 123456 --format har --file ./orders.har --overwrite-mode merge
apidog endpoint list --project 123456
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project 123456 --file case.json
apidog run --test-case <caseId> --project 123456 -e 7890 -r cli,json
Enter fullscreen mode Exit fullscreen mode

에이전트는 apidog cli-schema get으로 페이로드 구조를 읽고 작성 전에 검증하기 때문에, JSON 구조를 추측으로 만들어내지 않습니다. --overwrite-mode merge는 이미 있는 엔드포인트를 유지합니다.

테스트 케이스가 통과되면, 동일한 apidog run에 -r junit을 붙여 CI에 바로 넣을 수 있습니다. Apidog CLI CI/CD 가이드와 Claude Code에서의 Apidog CLI를 참고하세요. 직접 HAR을 내보냈다면 Apidog로 HAR 파일을 가져오는 방법을 참고하세요. Apidog의 무료 플랜은 최대 4명의 사용자까지 지원합니다.

시작 전에 알아둘 제한 사항

  • 아직 버전 0.1.0입니다. 저장소는 2026년 10월 말부터 시작되었으며, 기본적으로 업데이트가 자동 설치됩니다(browse update --mode notify로 알림만 받도록 변경 가능).
  • Chromium 전용. Firefox와 Safari는 지원되지 않습니다.
  • 보이는 디버깅 표시. 에이전트가 연결되어 있는 동안 브라우저에 "디버깅 시작됨" 바가 표시됩니다.
  • 여러분의 데이터는 에이전트가 보내는 곳으로 갑니다. Browse는 로컬에 머무르지만, 에이전트가 읽은 페이지 콘텐츠는 해당 모델 제공업체로 전송됩니다.

FAQ

OpenCode Browse는 무료인가요?

소스는 MIT 라이선스로 공개되어 있으며, 제품 페이지에는 가격이 표시되어 있지 않습니다. CLI는 스크립트나 패키지 관리자로, 확장 프로그램은 Chrome 웹 스토어에서 설치하면 됩니다.

Browse를 사용하려면 OpenCode가 필요한가요?

아니요. 설치 프로그램은 Claude Code, Codex, Cursor, Zed, VS Code, Gemini CLI 등 다양한 도구를 지원하며, 나머지는 browse install --agent none으로 수동 설정용 진입점을 출력합니다.

에이전트가 내 비밀번호를 볼 수 있나요?

fill 도구는 비밀번호와 일회용 코드 값을 숨기며, 로그인은 여러분이 직접 입력하는 핸드오프를 거치도록 설계되어 있습니다. 스크린샷과 페이지 텍스트는 그대로 반환되므로, 민감한 페이지는 에이전트 탭에서 열지 마세요.

에이전트가 다른 머신에서 실행될 때도 Browse를 사용할 수 있나요?

네. 에이전트가 실행되는 머신에서 browse install --remote를 실행하고 확장 프로그램을 해당 주소와 페어링하면 됩니다. Browse는 이 연결을 암호화하지 않으므로 Tailscale이나 WireGuard를 사용하세요.

Browse는 Playwright MCP와 어떻게 다른가요?

Browse는 기본적으로 여러분이 이미 사용 중인 브라우저와 프로파일을 조작하며 핸드오프가 내장되어 있습니다. Playwright MCP는 기본적으로 자체 브라우저를 실행하며, 확장 모드를 통해 여러분의 브라우저에 연결할 수도 있습니다.

Top comments (1)

Collapse
 
livinus_okoz_4661e8c7bb69 profile image
Livinus Okoz •

When Claude completes the OAuth consent, its backend immediately calls /mcp-server/http to execute tools/list. With high workflow counts, generating the full JSON tool schema can exceed Anthropic's 10–15 second connector timeout, which surfaces as the generic 'Authorization with n8n failed' error. Try restricting exposed MCP workflows to just 1 or 2 test flows in Settings to confirm if it connects instantly. Let me know what your container logs show on /mcp-oauth/token and I can help you isolate whether it's the token exchange or the tools payload.