Cline으로 LaunchRepo 사용하기: 제대로 작동하는 브라우저 설정

핵심 요약

• 명령 하나로 브라우저를 추가합니다: cline mcp add chrome-devtools --yes -- npx …(전체 명령은 아래 참고).
• Cline CLI 3.0.67은 모든 실행에서 ~/.cline/data/settings/cline_mcp_settings.json에서 MCP 서버를 읽었습니다. 문서에 나온 다른 두 경로는 오류 없이 무시되었습니다.
• 이후 Cline은 자체 파일 도구와 터미널 도구 외에 chrome-devtools__… 이름의 Chrome DevTools 도구 30개를 제공했습니다.
• 긴 페이지에는 설정이 하나 더 필요합니다. Cline은 8,000자를 넘는 모든 도구 결과의 가운데를 잘라 냈기 때문에, 한도를 올리기 전까지 긴 데모 페이지의 폼은 모델에 전달되지 않았습니다.
• CAPTCHA나 2FA 단계에서는 실행을 멈추고, 대화형 UI에서 cline --id로 세션을 재개하세요. 폼, 탭, 대화는 모든 실행에서 그대로 남아 있었습니다.

LaunchRepo는 워크스페이스의 파일을 읽고 쓰며 브라우저를 제어할 수 있는 코딩 에이전트라면 무엇이든 함께 작동합니다. Cline은 두 가지를 모두 할 수 있습니다. 이 페이지는 테스트한 설정을 기록한 것이며, 인증이나 파트너십이 아닙니다.

3단계 설정

Cline에는 Node.js와 원하는 모델 제공자가 필요합니다. 브라우저는 Chrome DevTools MCP가 담당하며, 다른 LaunchRepo 에이전트 페이지에서 쓰는 것과 같은 서버입니다.

1. CLI를 설치합니다: npm i -g cline을 실행한 다음 cline auth를 실행해 제공자를 선택하세요.
2. 아래 명령으로 브라우저 서버를 추가합니다. 그 아래에 보이는 설정 파일에 항목이 기록됩니다.
3. 실행에 사용할 Chrome에서 chrome://inspect/#remote-debugging을 열고 원격 디버깅을 켭니다(Chrome 144 이상). cline -i를 실행해 https://example.com을 열고 페이지 제목을 읽어 달라고 요청한 뒤, Chrome의 연결 확인 창을 승인하세요. 올바른 제목이 나오면 브라우저가 연결된 것입니다.

Chrome DevTools MCP 추가

cline mcp add chrome-devtools --yes -- npx -y chrome-devtools-mcp@1.10.1 --autoConnect --no-usage-statistics --no-performance-crux

항목이 기록되는 파일 ~/.cline/data/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "chrome-devtools": {
      "transport": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "chrome-devtools-mcp@1.10.1",
          "--autoConnect",
          "--no-usage-statistics",
          "--no-performance-crux"
        ]
      }
    }
  }
}

직접 작성하는 대안(같은 파일)

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@1.10.1",
        "--autoConnect",
        "--no-usage-statistics",
        "--no-performance-crux"
      ]
    }
  }
}

Cline 문서에 나온 평면 command/args 형식도 CLI가 기록하는 항목과 똑같이 로드되었습니다. --autoConnect는 평소 쓰는 Chrome에 연결합니다(Chrome 144 이상). 출시 작업 전용 Chrome을 따로 쓰려면 대신 --browser-url=http://127.0.0.1:9222를 사용하세요. 저희 테스트도 이 방법으로 임시 Chrome에 연결했습니다.

테스트한 내용

Cline CLI 3.0.67, Chrome DevTools MCP 1.10.1, Google Chrome 154.0.8037.92, macOS, Node 22 환경에서 2026년 10월 1일에 테스트했습니다. 모든 실행은 임시 홈 디렉터리와 임시 Chrome 프로필에서 진행했고, 위와 똑같이 cline auth와 cline mcp add로 설정했습니다.

AI 모델은 사용하지 않았습니다. 작은 로컬 대역이 Cline이 실제로 보낸 내용에서만 요소 ID를 읽어, 고정된 도구 호출로 Cline의 모델 요청에 응답했습니다. 덕분에 모든 실행이 동일하고 무료이며, Cline 자체가 제어하는 부분을 테스트할 수 있습니다. 어떤 설정이 로드되는지, 어떤 도구를 제공하는지, 모델이 무엇을 보는지, 승인, 세션, 재개입니다. 모델이 얼마나 잘 계획하는지는 테스트하지 않습니다.

설정 변형: 각 3회 실행. CAPTCHA 가이드의 데모 폼에서 인계 실행: 5회, 도구 결과 한도는 아래 설명대로 올렸습니다.

Cline이 로드한 설정 파일

같은 서버 항목을 서로 다른 파일과 형식으로 넣었습니다. "로드됨"은 Cline이 모델에 보낸 요청에 Chrome DevTools 도구가 나타났다는 뜻입니다.

인계 실행

Cline은 데모 폼을 열고 채운 뒤 대체 확인 화면에서 멈추고 실행을 끝냈습니다. 스크립트가 사람 역할을 맡아 같은 탭에서 확인을 완료했습니다. 그런 다음 대화형 UI에서 cline --id로 세션을 다시 열고 Cline에게 마무리를 요청했습니다. 에이전트 작업 중 CAPTCHA와 2FA: 통제된 인계 방법 →

실행 중 Cline이 찍은 스크린샷

문서와 실제 동작: 직접 겪은 차이

어느 것도 눈에 띄게 실패하지 않기 때문에 시간을 잡아먹습니다. 모두 매 실행에서 나타났습니다.

문서상 설정 경로는 세 개, 로드되는 것은 하나

MCP 페이지는 CLI용으로 ~/.cline/mcp.json을, CLI 레퍼런스와 도구 페이지는 프로젝트의 .cline/mcp.json을 안내합니다. CLI 3.0.67에서는 둘 다 로드되지 않았고, 설정 페이지에 나온 대로 ~/.cline/data/settings/cline_mcp_settings.json이 로드되었습니다.

파일이나 키가 틀리면 아무 반응이 없음

항목을 무시되는 파일에 두거나, VS Code 키 "servers" 아래에 넣거나, "disabled": true로 표시하면, Cline은 정상적으로 시작하고 코드 0으로 종료했으며 그저 브라우저 도구만 없었습니다. Chrome을 의심하기 전에 chrome-devtools__ 도구가 있는지부터 확인하세요.

긴 페이지는 가운데가 사라짐

Cline은 8,000자를 넘는 모든 도구 결과를 잘라 처음과 끝만 남겼습니다("...[truncated 37945 chars]..."). 긴 데모 페이지에서는 폼이 잘린 부분에 있어서 모델이 입력란을 하나도 보지 못했습니다. CLI 3.0.67은 문서화되지 않은 변수 CLINE_MESSAGE_BUILDER_MAX_TOOL_RESULT_CHARS를 읽으며, 120000으로 설정하자 페이지 전체가 전달되었습니다. 큰 결과는 매 턴마다 다시 전송되므로, 페이지에 필요한 만큼만 올리세요. 이 값은 Cline의 백그라운드 허브가 시작될 때만 반영됩니다. 처음 cline을 호출하기 전에 설정하거나, 먼저 cline doctor fix를 실행하세요. 저희 테스트에서는 나중에 설정한 값이 무시되었습니다.

재개에는 대화형 UI가 필요함

cline --id <session-id>는 터미널 UI에서 전체 대화를 다시 열었습니다. 그 밖의 환경에서는 CLI가 "interactive mode requires a TTY"라며 거부했고, --json을 붙이면 "JSON output mode requires a prompt argument or piped stdin"이 표시되었습니다.

질문 처리 방식은 모드마다 다름

대화형 UI에서는 에이전트의 질문이 사람을 기다렸습니다. 무인 실행에서는 같은 질문이 1밀리초도 안 되어 첫 번째 선택지로 응답되었고, --auto-approve false에서는 모든 도구 호출이 질문 대신 승인 오류로 거부되었습니다.

도구 이름이 다름

도구 페이지에는 bash, search, fetch_web이 나와 있습니다. CLI 3.0.67이 제공한 것은 run_commands, search_codebase, fetch_web_content, read_files, editor, ask_question이었고, MCP 도구는 chrome-devtools__<tool> 형식이었습니다. 규칙과 프롬프트에는 이 이름을 사용하세요.

Cline에서 CAPTCHA와 2FA

폼이 CAPTCHA, 2FA 입력 화면, 패스키에 이르면 Cline은 멈추고 사용자가 할 한 가지 단계를 설명해야 합니다. 대화형 UI(cline -i)에서는 그 질문이 그대로 사용자를 기다립니다.

무인 실행(터미널 없이 cline "…" 또는 --json)에서는 그 질문에 자동으로 응답되므로 일시 정지가 되지 않습니다. 대신 인계 메모와 함께 실행이 끝나도록 하세요.

같은 탭에서 확인을 완료하세요. 그런 다음 대화형 UI에서 세션을 다시 엽니다: cline --id <session-id>(ID는 cline history --json에서 확인) 그리고 이렇게 말하세요: "확인을 완료했습니다. 폼을 다시 읽고 한 번만 제출하세요."

저희 실행에서 다시 연 세션에는 이전 단계가 모두 남아 있었고, Chrome DevTools MCP를 통해 같은 탭을 찾아 입력란이 그대로임을 확인한 뒤 한 번만 제출했습니다.

데모 폼으로 보는 인계 방식 →

출시 작업을 위한 안전한 설정

• 은행이나 관리자 계정이 없는, 출시 작업 전용 Chrome 프로필을 사용하세요.
• 저희 실행에서 대화형 UI는 "Auto-approve all enabled" 상태로 시작했습니다. Shift+Tab으로 비활성화할 수 있습니다. 플랫폼에 익숙해질 때까지는 꺼 두세요.
• Cline이 로그인된 Chrome에 연결되어 있을 때는 항상 YOLO 모드를 꺼 두세요.
• Chrome DevTools MCP가 사용 데이터나 페이지 URL을 보내지 않기를 원한다면 서버 인수에 --no-usage-statistics와 --no-performance-crux를 유지하세요.
• 브라우저 작업자는 한 번에 하나만. LaunchRepo가 기본값을 하나로 둔 것도 바로 이 때문입니다.

Cline에서 LaunchRepo 시작하기

LaunchRepo 비공개 워크스페이스에서 Cline을 열고 시작 프롬프트를 붙여 넣으세요. 이후 키트가 온보딩을 안내하고, Example Domain에서 Chrome 연결을 테스트하고, 실행 계획을 만듭니다.

• 시작 프롬프트는 최상의 결과를 위해 Claude Code 또는 Codex CLI를 권장합니다. Cline도 같은 키트로 작동합니다. 키트에 필요한 두 가지, 즉 워크스페이스의 파일 접근과 MCP를 통한 브라우저를 갖추고 있기 때문입니다.
• 에이전트는 AGENTS.md를 읽고, 로컬 대시보드를 시작하고, 모든 제출을 트래커에 기록합니다.
• CAPTCHA와 2FA 단계는 위에서 설명한 그대로 인계 형태로 사용자에게 돌아옵니다.

LaunchRepo 시작 프롬프트

Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone.

Read AGENTS.md, then follow "Start the dashboard for the owner". Create my private
workspace if I do not have one yet, start the dashboard, and give me the link.
Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of
asking again unless their scope is missing or conflicting. Actually test my visible
existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the
OS fallback if needed. Use one platform/browser worker by default. Build the normal
run only from suitable free-ready routes, keep research separate, and preserve any
draft that needs one exact human CAPTCHA/2FA action. Never claim browser control
bypasses or reduces those challenges.

• 코딩 에이전트를 내 Chrome에 연결하기 →
• Claude Code로 디렉터리에 SaaS 출시하기 →
• Playwright MCP vs Chrome DevTools MCP: 같은 폼으로 직접 테스트 →
• MCP 서버 →

이번 테스트에서 다루지 않은 것

• VS Code와 JetBrains 확장, 그리고 Cline Desktop. 위의 확장 설정 단계는 Cline 문서를 따른 것입니다.
• 실제 AI 모델. 대역을 써서 모델 품질은 결과에서 제외했습니다. 실제 모델은 잘못된 요소를 고를 수도 있습니다.
• 평소 쓰는 Chrome 프로필에 --autoConnect로 연결. 저희는 --browser-url로 임시 Chrome을 사용했습니다.
• Windows와 Linux, 원격 MCP 서버, Cline 계정과 유료 요금제.

출처

위의 모든 인용문은 2026년 10월 1일에 확인한 아래 페이지에서 원문 그대로 옮겼습니다. 테스트한 동작은 이 페이지에서 설명한 저희의 직접 실행 결과입니다.

자주 묻는 질문

Cline은 MCP 서버 설정을 어디에 저장하나요?

저희가 테스트한 Cline CLI 3.0.67에서는 ~/.cline/data/settings/cline_mcp_settings.json만 읽혔습니다(또는 --config로 넘긴 디렉터리 아래의 같은 경로). ~/.cline/mcp.json과 프로젝트의 .cline/mcp.json은 오류 없이 무시되었습니다.

Cline에 Chrome DevTools MCP를 어떻게 추가하나요?

cline mcp add chrome-devtools --yes -- npx -y chrome-devtools-mcp@1.10.1 --autoConnect --no-usage-statistics --no-performance-crux를 실행하세요. 항목이 자동으로 기록됩니다. IDE 확장에서는 MCP Servers → Configure에서 mcpServers 아래에 같은 항목을 추가하세요.

Cline에 MCP 도구가 보이지 않는 이유는 무엇인가요?

대부분은 항목이 Cline이 읽지 않는 파일에 있거나, "mcpServers" 대신 "servers"를 쓰거나, "disabled": true가 설정된 경우입니다. Cline은 이 중 어느 것도 경고하지 않습니다. Chrome DevTools 서버가 로드되면 chrome-devtools__… 이름의 도구로 나타납니다.

페이지에 분명히 있는 폼 입력란을 Cline이 찾지 못하는 이유는 무엇인가요?

긴 페이지에서는 스냅샷이 Cline의 도구 결과 한도인 8,000자를 넘을 수 있고, 그러면 모델이 보기 전에 페이지 가운데가 잘립니다. 저희 테스트에서는 CLINE_MESSAGE_BUILDER_MAX_TOOL_RESULT_CHARS(문서화되지 않았으며 CLI 3.0.67이 읽는 변수)를 올리자 폼 전체가 보였습니다. 실행 중인 허브는 시작할 때의 값을 그대로 유지하므로, 처음 cline을 호출하기 전에 설정하거나 먼저 cline doctor fix를 실행하세요.

Cline이 CAPTCHA나 2FA를 대신 처리할 수 있나요?

아니요, 그리고 시도해서도 안 됩니다. Cline은 폼을 준비하고 멈춥니다. 사용자가 같은 탭에서 확인을 완료한 뒤, 대화형 UI에서 cline --id로 세션을 다시 엽니다. 저희 실행에서는 매번 폼과 세션이 일시 정지 후에도 그대로 남아 있었습니다.

LaunchRepo는 Cline을 공식 지원하나요?

LaunchRepo는 파일과 브라우저에 접근할 수 있는 코딩 에이전트를 지원합니다. Cline은 둘 다 갖추고 있으며, 이 페이지는 테스트한 설정을 기록합니다. 인증이나 파트너십은 아니며, 시작 프롬프트는 여전히 최상의 결과를 위해 Claude Code 또는 Codex CLI를 권장합니다.