把你的编程智能体连接到你的 Chrome

更新于 2026年9月23日

推荐配置：为了在 LaunchRepo 上获得最佳效果，我们强烈建议始终在终端中使用 Claude Code CLI 或 Codex CLI，而不是 Claude 或 Codex 桌面应用。这是我们推荐的工作方式，并不保证会带来不同的权限或不间断的执行。

请通过 Chrome 远程调试使用 Chrome DevTools MCP，并准备好当前的 Node.js LTS 版本、npm 和 Google Chrome。本地仪表盘负责保存你的记录；Chrome 由你的智能体控制。先从一个 worker 开始，并在整轮运行期间保持它的 MCP 连接不断开。不要使用浏览器扩展类的传输方式，也不要使用其他浏览器控制集成。

选择你的配置方式

Chrome 144 及以上：自动连接在 Windows、macOS 和 Linux 上都可用。
macOS：请检查终端权限。
无法自动连接，或需要单独的 worker：使用专用个人资料，分别参见 macOS、Windows 或 Linux。
提交之前：完成连接测试。

检查 node --version、npm --version 和 chrome://version。在 Windows 上，请使用原生 Windows 版的 Node/npm 和 Chrome；WSL 需要另行配置连接。

连接现有的 Chrome

在 Chrome 144 及以上版本中，打开 chrome://inspect/#remote-debugging 并启用远程调试。如果找不到这个开关，请使用下文中允许使用的专用个人资料。
在智能体的 MCP 设置中注册 Chrome DevTools MCP。下面这个通用 JSON 示例适用于 macOS/Linux；你的智能体可能使用不同的配置格式：

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

在 Windows 上，请使用 "command": "cmd" 和以下参数：

["/c", "npx", "-y", "chrome-devtools-mcp@latest", "--autoConnect", "--no-usage-statistics", "--no-performance-crux"]

触发一个无害的浏览器操作，并在目标窗口中批准 Chrome 的连接提示。然后完成下面的测试。

第一次调用时会下载这个包。配置完成后，请固定一个经过测试的版本。参见官方的配置说明和客户端配置。

专用个人资料：选择你的操作系统

请在你的私有工作区中运行，不要放在共享或同步文件夹里。让 Git 忽略这个个人资料目录：里面保存着登录状态。所需账号请由你自己登录。Chrome 136 及以上版本要求这些调试参数必须搭配非默认个人资料使用。

macOS

mkdir -p .browser/chrome
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --remote-debugging-address=127.0.0.1 \
  --remote-debugging-port=9222 \
  --user-data-dir="$PWD/.browser/chrome" about:blank

Windows PowerShell

$launchrepoChrome = @(
  "$env:ProgramFiles\Google\Chrome\Application\chrome.exe",
  "${env:ProgramFiles(x86)}\Google\Chrome\Application\chrome.exe",
  "$env:LOCALAPPDATA\Google\Chrome\Application\chrome.exe"
) | Where-Object { Test-Path $_ } | Select-Object -First 1
if (-not $launchrepoChrome) { throw 'Locate Google Chrome first' }
New-Item -ItemType Directory -Force '.browser/chrome' | Out-Null
$launchrepoProfile = (Resolve-Path '.browser/chrome').Path
Start-Process -FilePath $launchrepoChrome -ArgumentList "--remote-debugging-address=127.0.0.1 --remote-debugging-port=9222 --user-data-dir=`"$launchrepoProfile`" about:blank"

Linux

launchrepo_chrome=$(command -v google-chrome || command -v google-chrome-stable)
if [ -z "$launchrepo_chrome" ]; then
  echo "Install or locate Google Chrome first."
else
  mkdir -p .browser/chrome
  "$launchrepo_chrome" \
    --remote-debugging-address=127.0.0.1 \
    --remote-debugging-port=9222 \
    --user-data-dir="$PWD/.browser/chrome" about:blank
fi

保持启动用的终端处于打开状态。把 MCP 参数中的 --autoConnect 换成 --browserUrl=http://127.0.0.1:9222；两者切勿同时使用。端口只在本机使用，绝不要通过隧道公开出去。检查监听状态：macOS 上用 lsof -nP -iTCP:9222 -sTCP:LISTEN，Linux 上用 ss -ltnp 'sport = :9222'，Windows 上用 Get-NetTCPConnection -State Listen -LocalPort 9222 | Select-Object LocalAddress, OwningProcess。只有回环地址才是可接受的。如果端口被其他程序占用，请换一个未被使用的端口，并同时更新两处配置。绝不要结束无关的浏览器进程，也不要删除正在使用的个人资料锁文件。

macOS 权限

先确认是哪个应用在启动 MCP：终端、iTerm，还是你的编辑器或智能体应用。如果 macOS 拒绝访问受保护的 Chrome 文件：

打开 系统设置 → 隐私与安全性 → 完全磁盘访问权限。
点 + 添加实际启动 MCP 的那个宿主应用，完成身份验证并启用它。
完全退出并重新打开该应用，重新连接，再做一次测试。

这是一项权限检查，并不是 CDP 的通用要求。如果连接已经正常，就不要额外授予更大的权限。仅使用 CDP 的连接通常不需要辅助功能、自动化或屏幕录制权限。Chrome 的连接批准是另一回事，重启后可能需要再次批准。

测试连接

让你的智能体在新标签页中打开 https://example.com，读取它的页面标题和主标题，并指出是哪个标签页。盯着那个窗口看。MCP 进程在运行，本身什么也证明不了。接下来，登录目标目录站，确认实际登录的是哪个身份；OAuth 显示成功并不代表已经登录。在约定的权限范围内检查你的邮箱。

然后让智能体在同一个标签页中读取 navigator.webdriver。它必须是 false。如果是 true，说明你的 MCP 配置缺少 --autoConnect（专用配置文件则为 --browserUrl），Chrome DevTools MCP 自己启动了一个自动化 Chrome。此时 Cloudflare Turnstile 等机器人检测会一直停在“验证中”，永远不会出现你能完成的验证。修正配置、重启智能体会话，然后重新测试。切勿用隐身（stealth）参数或脚本掩盖这个标志。

在 onboarding.json 或 SESSION.md 中只保存通过/未通过的结果和不含敏感信息的备注。不要复制 cookie、认证链接或浏览器会话记录。CAPTCHA 和两步验证请由你自己完成。点击提交后如果超时，请先去平台上确认状态，再决定是否重试。如果移动的是错误的窗口，请立即停止并检查连接。不经过这项测试，这些说明无法保证适用于你具体的操作系统与智能体组合。

两个 worker 与窗口清理

运行规划器默认从 10 个提交开始，最多 2 个 worker。每个 worker 都需要各自独立的平台分配、Chrome 个人资料、端口和 MCP 连接。例如，.browser/worker-1 使用 9222，.browser/worker-2 使用 9223。每个 worker 都要单独测试。如果宿主环境无法把各个 worker 路由到不同的连接上，就只用一个。

每个提交都使用一个专属窗口。确认之后，先保存它的证据和结果，然后只关闭这个窗口以及它自己打开的登录/验证标签页。个人窗口、共享收件箱、仪表盘、未保存的表单和需要人工处理的交接都要保持打开。如果 MCP 无法关闭该窗口，就关闭它自己打开的标签页，并记下还需要所有者手动清理的部分。保留个人资料；如果关闭最后一个窗口导致 MCP 断开，请重新连接。下一步请参见引导指南。

这些指南介绍的工具包

LaunchRepo 是一个由你自己的编程智能体运行的私有仓库：299 份目录站操作手册、工作区脚本、追踪器和本地仪表盘。一次付费，发布你打造的每一款产品。

查看价格