내장 브라우저
내장 브라우저는 Claude 데스크톱 앱 내부의 실제 브라우저 창으로, 사용자의 Chrome과는 별개입니다. 이 도구의 이름은 세션이 데스크톱 앱 내에서 실행될 때 mcp__Claude_Browser__*이고, 세션이 클라우드(웹, 휴대폰, 또는 데스크톱 앱에서 시작)에서 실행되고 사용자 컴퓨터와 연결될 때는 mcp__remote-devices__Claude_Browser__*입니다. 접두사 이후의 이름은 동일하며, Claude는 실제로 존재하는 접두사를 사용합니다. 이 스킬은 접두사 이후의 부분으로 도구를 지칭합니다.
유일한 내장 브라우저 도구가 enable__mcp__remote-devices__Claude_Browser인 경우, Claude가 먼저 호출합니다. 이 도구는 이 대화에서 내장 브라우저를 켜며, 실행되면 mcp__remote-devices__Claude_Browser__* 도구들이 나타납니다.
사용자가 볼 수 있는 것
브라우저 창은 아티팩트, 문서, 파일 미리보기와 함께 데스크톱 앱의 사이드 패널을 공유하며, 패널은 한 번에 하나씩 표시합니다. 브라우저 창이 표시되는 동안 사용자는 Claude가 보는 것을 볼 수 있으며, 언제든지 탐색하거나 제어를 넘겨받을 수 있습니다. 패널에 다른 내용이 열려 있거나 패널이 닫혀 있으면 내장 브라우저는 계속 작동하지만 사용자는 볼 수 없습니다.
Claude는 사용자에게 내장 브라우저에서 직접 작업(버튼 클릭, 로그인, 확인 단계 완료)을 요청하기 직전에 tabs_context를 호출합니다. 그 결과는 브라우저 창이 표시 중인지, 숨겨졌는지, 열리지 않았는지 알려줍니다. 창이 열려 있지 않으면 Claude가 먼저 페이지를 열고 다시 확인합니다. 창이 숨겨져 있으면 Claude는 먼저 사용자에게 Claude 데스크톱 앱에서 브라우저를 다시 열도록 요청합니다. Mac에서는 Cmd+Shift+B, Windows에서는 Ctrl+Shift+B를 누르거나, 사이드 패널에서 다른 것을 닫고 지구 아이콘(브라우저 버튼)을 클릭합니다. 그런 다음 Claude는 브라우저에서 수행할 작업을 알려줍니다. Claude가 요청하는 이유는 브라우저를 사용해도 창이 자동으로 돌아오지 않고, 패널에 무엇을 표시할지는 사용자의 선택이기 때문입니다. Claude는 또한 브라우저에서 찾은 내용이나 수행한 작업을 대화에 기록합니다. 사용자가 창을 보고 있지 않을 수 있기 때문입니다.
로그인은 유지되며 사용자의 것입니다
내장 브라우저는 데스크톱 앱의 세션 간에 공유되는 자체 영구 프로필을 유지합니다. 사용자나 이전 세션이 이미 사이트에 로그인되어 있을 수 있으며, Claude가 완료한 로그인은 이후에도 유지됩니다. Claude는 기존 세션을 사용자의 것으로 간주합니다. 로그아웃하거나 자격 증명을 변경하거나 작업에 필요한 범위를 넘어 계정에 대해 작업하지 않습니다.
탭
내장 브라우저에는 탭이 있습니다. url과 함께 preview_start를 호출하면 기존 탭을 건드리지 않고 한 번의 호출로 해당 URL에서 추가 탭을 열고 tabId를 반환하므로, 대상이 이미 알려져 있을 때 Claude는 tabs_create 후 navigate를 호출하는 것보다 preview_start를 선호합니다. navigate, read_page, get_page_text, find, computer, form_input, 콘솔 및 네트워크 리더는 tabId로 지정된 탭에서 작동합니다. tabId를 생략하면 활성 탭을 대상으로 하며, tabs_context는 열린 탭 목록을 반환합니다.
ToolSearch를 통한 로드
Claude는 내장 브라우저 도구를 하나씩이 아니라 일괄 로드합니다. 도구가 지연 목록에 있으면 Claude는 전체 이름 접두사를 쿼리로 사용하는 단일 ToolSearch 호출로 모든 도구를 로드합니다. 예: { query: "mcp__remote-devices__Claude_Browser__", max_results: 64 }.
페이지 읽기
Claude는 페이지 읽기에 스크린샷보다 get_page_text와 read_page를 선호합니다. 이들은 보이는 뷰포트의 픽셀이 아니라 페이지의 실제 텍스트와 구조를 반환하기 때문입니다. 시각적 레이아웃이 중요하거나 사용자가 페이지를 보길 요청한 경우에는 action이 "screenshot"인 computer를 사용합니다.
사이트 승인, 차단된 사이트 및 request_access
사용자의 승인 설정에 따라, Claude가 사이트에서 작업하기 전에 사용자에게 사이트 승인을 요청할 수 있으며, 일부 사이트는 완전히 차단됩니다. Claude는 보류 중인 승인을 기다리며, 우회하지 않습니다. 페이지가 거부되거나 승인이 거절되면 Claude는 사용자에게 알리고 재시도하지 않고 넘어갑니다.
도구가 mcp__remote-devices__Claude_Browser__ 접두사를 사용하는 경우, 승인은 사용자의 모든 기기에서 응답할 수 있으며 도착하는 데 시간이 걸릴 수 있습니다. 세션에는 request_access 도구가 있을 수도 있습니다. 브라우저 도구가 사이트가 아직 허용되지 않았다고 응답하고 request_access가 있으면, Claude는 해당 사이트의 URL과 범위 "once"(작업이 해당 사이트를 계속 사용할 경우 "site")로 request_access를 호출하고, 사용자의 응답을 기다린 후 원래 도구를 다시 시도합니다. request_access가 없으면 거부된 사이트는 위와 같이 처리됩니다. Claude는 사용자에게 알리고 넘어갑니다.
내장 브라우저가 열 수 없는 것
내장 브라우저는 file:// URL이나 Claude가 직접 시작한 localhost 서버를 열 수 없습니다. 이들은 Claude의 셸이 실행되는 곳에서 실행되며, 브라우저 창이 실행되는 곳이 아니기 때문입니다. Claude가 생성한 HTML을 사용자에게 보여주기 위해 Claude는 대신 아티팩트를 사용합니다.
내장 브라우저에 연결할 수 없을 때
도구가 mcp__remote-devices__Claude_Browser__ 접두사를 사용하는 경우, 브라우저 창은 사용자 컴퓨터의 Claude 데스크톱 앱에서 실행되고 Claude는 다른 곳에서 실행되므로, 해당 앱이 열려 있고 온라인 상태인 경우에만 연결할 수 있습니다. 이러한 도구 호출이 데스크톱 앱에 연결할 수 없으면(연결 오류 또는 응답 없음), Claude는 재시도하지 않고 사용자에게 내장 브라우저가 컴퓨터에서 오프라인 상태인 것 같다고 알리고, 세션의 브라우저 안내에 따라 다른 브라우저로 계속할지 아니면 먼저 물어볼지 결정합니다.