Handlus

원격 MCP · 크롬 확장 · 여러 브라우저

클로드코드가내 크롬을 직접 씁니다

확장 하나 깔고 주소 하나 등록하면 됩니다. 작업용, 개인용 크롬을 이름으로 골라 시킵니다.

어떻게 동작하나요
~/project · claude

클로드코드 사용 예시. 터미널에 Handlus 등록 명령을 넣고 브라우저에서 허용하면 연결됩니다. 그다음 「작업용 크롬에서 네이버 열고 제목 읽어」라고 하면 작업용 크롬에서 네이버를 열고 제목 「NAVER」를 읽어 옵니다.

크롬에서 할 일은 거의 다, 도구 28개

  • get_windows_and_tabs
  • chrome_navigate
  • chrome_switch_tab
  • chrome_close_tabs
  • chrome_read_page
  • chrome_get_web_content
  • chrome_screenshot
  • chrome_console
  • chrome_click_element
  • chrome_fill_or_select
  • chrome_keyboard
  • chrome_computer
  • chrome_javascript
  • chrome_handle_dialog
  • chrome_request_element_selection
  • chrome_upload_file
  • chrome_handle_download
  • chrome_gif_recorder
  • chrome_network_request
  • chrome_network_capture
  • chrome_history
  • chrome_bookmark_search
  • chrome_bookmark_add
  • chrome_bookmark_delete
  • performance_start_trace
  • performance_stop_trace
  • performance_analyze_insight
  • chrome_request_user_consent

이름으로 고르고, 결과는 그대로

크롬 확장이 하던 일을 그대로 원격에서 합니다. 클로드코드는 어느 크롬을 쓸지만 정하면 됩니다.

  • 여러 크롬을 이름으로

    작업용, 개인용처럼 이름을 붙여 두고 골라 시킵니다. 프로필의 구글 계정까지 보여 줘서 헷갈리지 않습니다.

    chrome_list_browsers

    • 작업용work@gmail.com연결됨
    • 개인용me@gmail.com연결됨
    • 거실맥계정 없음2시간 전

  • 결과는 바이트 그대로

    스크린샷과 페이지 내용은 중계만 거쳐 그대로 클로드코드에 닿습니다.

    크롬에서

    screenshot.png

    클로드코드에

    screenshot.png

    바이트 단위로 같음

    중계 서버는 결과를 고치거나 저장하지 않고 그대로 넘깁니다.

  • 주소만으로 연결

    클로드코드에 주소를 등록하고, 브라우저에서 허용만 누르면 됩니다.

    Handlus 로그인

    Claude Code 가 Handlus 에 접근하려고 합니다

    거부허용

    토큰을 복사하지 않습니다. 끊기는 대시보드에서.

  • 녹화한 작업은 도구가 됩니다

    확장 사이드패널에서 녹화한 작업이 flow.* 도구로 따로 나타납니다.

    사이드패널에서 녹화한 작업

    • flow.weekly_report7단계
    • flow.order_check4단계
    • flow.form_fill5단계

  • 대화상자·업로드·다운로드까지

    경고창 닫기, 파일 올리기, 받은 파일 확인처럼 막히기 쉬운 일도 도구로 합니다.

    • 경고창chrome_handle_dialog
    • 올리기chrome_upload_file
    • 받기chrome_handle_download
    • 사람 확인chrome_request_user_consent

  • 업데이트는 한 줄

    새 버전이 나오면 알려 줍니다. 명령 한 줄이면 확장이 스스로 다시 불러옵니다.

    $ curl -fsSL https://handlus.com/update.sh | sh

    ✓ 확장 파일을 새 버전으로 바꿨습니다

    ✓ 확장이 스스로 다시 불러옵니다

    v0.1.1

확장 하나, 주소 하나. 클로드코드는 내 크롬을 사람처럼 씁니다.

설정은 세 단계

처음 한 번만 하면 됩니다. 크롬을 더 붙일 때는 그 크롬에 같은 확장을 깔고 「구글로 연결」만 누르면 됩니다.

  1. 01

    확장 설치

    구글로 로그인하고 zip 을 받아 크롬에 올립니다.

    • zip 받아 풀기
    • chrome://extensions 에서 개발자 모드 켜기
    • 「압축해제된 확장 프로그램 로드」

  2. 02

    구글로 연결

    설치하면 열리는 화면에서 「구글로 연결」을 누릅니다.

    • 구글 계정으로 로그인
    • 작업용, 개인용처럼 이름 정하기
    • 키 없이도 「연결 완료」

  3. 03

    에이전트 연결

    같은 화면에 나오는 명령 한 줄을 에이전트에 넣습니다.

    • 클로드코드 · Codex 명령 붙여넣기
    • 브라우저에서 「허용」 한 번
    • 키를 복사할 일 없음

무엇이 서버를 지나가나

중계 서버는 길만 이어 줍니다. 무엇이 지나가고 무엇이 남는지 그대로 적었습니다.

  • 지나가지만 저장하지 않습니다

    페이지 내용, 스크린샷, 도구에 넣은 값과 결과. 클로드코드와 크롬 사이를 그대로 오갑니다.

  • 저장하는 것

    구글 이메일·이름, 토큰의 해시, 연결 키, 브라우저 이름·확장 버전·프로필 계정·마지막 접속.

  • 호출 기록은 한 줄

    사용자 ID · 기기 ID · 도구 이름 · 걸린 시간 · 성공 여부. 도구에 넣은 값과 결과는 남기지 않습니다.

  • 토큰은 해시로만

    클로드코드 로그인 토큰은 1시간, 새로고침 토큰은 30일. 대시보드에서 언제든 연결을 끊을 수 있습니다.

  • 고른 크롬에만

    두 대 이상 켜져 있으면 짐작으로 고르지 않고 어느 크롬인지 물어봅니다.

  • 내 계정으로만 붙는 확장

    대시보드에서 받은 확장에는 내 계정 서명이 들어 있어, 남의 키나 남의 계정으로는 연결되지 않습니다. 연결은 구글 로그인으로 하고, 해제는 대시보드에서 바로 합니다.

자주 묻는 질문

설치부터 보안까지, 시작하기 전에 많이 묻는 것들입니다.

내 크롬을 클로드코드에 연결하세요

구글로 로그인하면 확장 받기부터 에이전트 연결까지 그림으로 차례대로 안내합니다.