pilot — 실제 Chrome에서 실행되는 AI 에이전트

Chrome 확장 프로그램을 설치하세요. AI 에이전트가 이미 사용 중인 브라우저의 탭을 사용하게 됩니다.

다른 모든 브라우저 도구는 새로운 익명 브라우저를 실행합니다. 에이전트는 로그아웃 상태로 시작하며, Cloudflare에 의해 차단되거나 인증이 필요한 페이지에 접근할 수 없습니다.

Pilot은 Chrome 확장 프로그램과 MCP 서버를 결합한 도구입니다. AI 에이전트를 사용자의 실제 브라우저에 연결하여 동일한 세션, 쿠키, 로그인 상태를 공유합니다. 에이전트는 사용자가 보는 것을 그대로 봅니다.

You: "Summarize my GitHub notifications"

→ New tab opens in YOUR Chrome
→ Already logged into GitHub
→ Agent reads, summarizes, done

헤드리스 브라우저를 사용하지 않습니다. 쿠키 해킹도, 재인증도, 봇 탐지도 없습니다.

작동 방식

AI Agent → MCP Server → WebSocket → Chrome Extension → Tab in your browser
         (stdio)       (localhost)

1. Pilot이 MCP 서버로 실행 — Claude Code, Cursor 또는 모든 MCP 클라이언트가 stdio를 통해 연결됩니다.

2. Chrome 확장 프로그램이 연결 — localhost의 WebSocket을 통해 연결됩니다.

3. 에이전트가 실제 Chrome의 전용 탭을 사용 — 모든 세션이 그대로 유지됩니다.

4. 여러 에이전트가 별도의 탭 사용 — 색상으로 구분되어 쉽게 식별할 수 있습니다.

빠른 시작

1. MCP 서버 추가

{
  "mcpServers": {
    "pilot": {
      "command": "npx",
      "args": ["-y", "pilot-mcp"]
    }
  }
}

2. Chrome 확장 프로그램 설치

npx pilot-mcp --install-extension

Chrome의 확장 프로그램 페이지가 열립니다. **압축해제된 확장 프로그램을 로드(Load unpacked)**를 클릭하고 터미널에 표시된 경로를 선택하세요.

3. 사용하기

"내 GitHub 알림으로 이동해서 요약해줘"

Chrome에 탭이 열리며, 이미 사용자로 로그인된 상태입니다.

효율적인 스냅샷

다른 도구들은 페이지당 50,000자 이상의 데이터를 컨텍스트 창에 덤프합니다. Pilot은 이를 간결하게 유지합니다:

Other tools:   navigate(58K) → navigate(58K) → answer        = 116K chars
Pilot:         navigate(2K)  → navigate(2K)  → snapshot(9K)  =  13K chars

snapshot_diff는 작업 간에 변경된 내용만 보여주므로 중복된 재읽기가 발생하지 않습니다.

컨텍스트가 줄어들면 응답 속도가 빨라지고, API 호출 비용이 절감되며, 환각 현상이 줄어듭니다.

Pilot vs @playwright/mcp

3가지 프로필에 걸친 61개의 도구

대부분의 LLM은 30개 이상의 도구를 사용하면 성능이 저하됩니다. 필요한 도구만 로드하세요:

{
  "mcpServers": {
    "pilot": {
      "command": "npx",
      "args": ["-y", "pilot-mcp"],
      "env": { "PILOT_PROFILE": "standard" }
    }
  }
}

기본값: standard. 전체 도구 참조 →

헤드 모드 폴백

확장 프로그램이 연결되지 않은 경우, Pilot은 자동으로 가시적인 Chromium 창을 엽니다.

실제 브라우저에서 쿠키 가져오기: pilot_import_cookies({ browser: "chrome", domains: [".github.com"] })

macOS Keychain / Linux libsecret을 통해 Chrome, Arc, Brave, Edge, Comet을 지원합니다. CAPTCHA의 경우: pilot_handoff → 사용자가 개입 → pilot_resume.

요구 사항: npx playwright install chromium

요구 사항

• Node.js >= 18

• Chrome + Pilot 확장 프로그램 (권장)

• macOS 또는 Linux

• 폴백 전용: npx playwright install chromium

보안

• 확장 프로그램은 localhost(127.0.0.1)에서만 통신합니다.

• 출력 경로 유효성 검사를 통해 PILOT_OUTPUT_DIR 외부로의 쓰기를 방지합니다.

• 모든 파일 작업에 경로 탐색(Path traversal) 보호 기능이 적용됩니다.

• PILOT_PROFILE을 통해 노출되는 도구를 제어할 수 있습니다 (core / standard / full).

크레딧

핵심 아키텍처(참조 기반 요소 선택, 스냅샷 차이 분석, 주석이 달린 스크린샷)는 Garry Tan의 **gstack**에서 포팅되었습니다. Playwright와 MCP SDK를 기반으로 구축되었습니다.

Pilot이 유용하다면 저장소에 별을 눌러주세요 — 다른 사람들이 찾는 데 도움이 됩니다.