내장 브라우저 사용법

작성일: 2026-10-19 · 작성: 시스템 부관장자(맥미니 풀스택 프로그래머) · 대상: 전 세션

1. 개요

Claude 데스크톱 앱 안에 있는 브라우저 패널입니다. 사용자의 실제 Chrome과 분리된 별도 프로필을 쓰며, 로그인 상태는 이 프로필에 유지됩니다. 도구 이름은 mcp__Claude_Browser__* 입니다. (별도의 "aside-browser" 도구는 함대 어디에도 정의되어 있지 않습니다.) 사용자가 Chrome을 쓰라고 하면 Claude in Chrome(mcp__claude-in-chrome__*)을 씁니다. 둘을 혼동하지 말 것.

2. 열기와 탭

preview_start  url=https://...     → 새 탭을 열고 tabId 반환 (기존 탭 유지)
navigate       tabId, url          → 기존 탭에서 이동
tabs_context                       → 열린 탭과 패널 상태 확인

이후 도구 호출은 tabId로 대상 탭을 지정합니다. 생략하면 활성 탭이 대상입니다.

3. 읽기 (기본 방법)

get_page_text — 본문 텍스트. 기사·조례·공고 읽기에 가장 빠릅니다. 스크린샷보다 우선 사용.
read_page (filter=interactive) — 링크·버튼과 href 목록. 다음 이동 경로 확인용.
find — 텍스트로 요소 찾기. 결과의 ref_N을 computer·form_input에 넘길 수 있음.
computer action=screenshot — 레이아웃 자체가 중요할 때만.

검색 결과 목록에서 링크 클릭이 반응하지 않으면 링크의 href를 find로 찾아 navigate로 직접 이동하는 편이 확실합니다(오늘 Düsseldorf 조사에서 확인).

4. 스크립트 실행 (javascript_tool)

디버깅·조사 목적으로만 씁니다. 페이지의 링크·iframe 주소 추출 등에 사용했습니다. 페이지 기능을 바꾸는 용도로 쓰지 않습니다.

5. 사이트 접근 전 확인 (필수)

robots.txt는 실제 파일이 있는 호스트에서 별도 호출로 확인합니다. 예: https://{호스트}/robots.txt. 같은 호출에서 robots와 본 요청을 섞지 말 것.
User-agent: *의 Disallow: /는 일반 크롤러 전면 차단입니다. 대량 수집을 하려면 해당 규칙이 우리 수집기 UA를 막는지 확인해야 합니다.
검색 엔진이나 AI 크롤러 이름(Googlebot, ClaudeBot 등)으로 위장하지 않습니다. 허용 규칙이 있다고 해서 다른 봇 이름을 빌려 쓰는 것은 금지입니다.
사이트가 승인을 요구하면 승인을 기다리고, 거부되면 사용자에게 알린 뒤 다음 단계로 넘어갑니다. 재시도로 우회하지 않습니다.

6. 계정·로그인

패널에 이미 로그인된 계정은 사용자 것입니다. 로그아웃, 비밀번호 변경, 계정 설정 변경을 하지 않습니다.
로그인 단계가 필요하면 사용자가 패널에서 직접 입력합니다. 비밀번호를 Claude가 입력하지 않습니다.

7. 패널이 숨겨졌을 때

브라우저는 계속 동작하지만 사용자는 보지 못합니다. 사용자가 직접 조작해야 하는 단계가 있으면 먼저 패널을 여는 방법(Mac: Cmd+Shift+B)을 안내하고, 무엇을 했는지 대화에 적습니다.

8. 종료

사용자가 요청하지 않은 탭은 닫지 않습니다. Claude가 연 임시 탭은 작업 후 tabs_close로 정리합니다.

9. 자주 막히는 곳

navigation ... was denied or failed — 사이트 차단 또는 DNS 실패. 호스트명을 다시 확인하고, 실패가 계속되면 사용자에게 알림.
검색 결과가 비어 있음 — 공식 검색은 외부 DB(Ratsinfo 등)를 포함하지 않습니다. 해당 시스템으로 직접 가야 합니다.
본문이 잘림 — max_chars를 늘리거나 offset으로 이어 읽습니다.