你照常使用 Chrome。连接好 MyChrome 后,回到原来的 AI 对话,告诉它要在哪个页面做什么。
开始前:检查环境
- Apple Silicon Mac,macOS 13 或更新版本。
-
Google Chrome 位于
/Applications/Google Chrome.app。 - 推荐 Node.js 24+,选择带 npm 的 Apple Silicon(arm64)版本。也支持 Node 20.19+、22.13+。
-
Git 和 Xcode Command Line Tools。缺少时运行
xcode-select --install,并完成系统安装窗口中的步骤。 - Codex、Claude Code 等本机 MCP 客户端及其模型访问权限。
1. 安装 MyChrome
选一个准备长期保留的目录,运行:
git clone https://github.com/shuaige121/mychrome-mcp.git
cd mychrome-mcp
bash scripts/setup.sh
安装程序检查环境、安装依赖、编译辅助程序,将 MyChrome App 安装到
~/Applications,然后检查权限。客户端配置和系统权限仍由你决定。如果提示已安装但权限尚不完整,先完成下一步。
安装后会打开 MyChrome,首次使用时显示入门引导。跳过或关闭后,可以通过顶部问号按钮或菜单中的入门引导重新打开。
App 和 MCP 客户端会引用这个源码目录,请保留其位置。当前版本通过源码安装,尚未发布到 npm。
仅检查现有目录,不安装或更改设置:
bash scripts/setup.sh --check
2. 授权并连接 AI 客户端
允许访问 Chrome
在 Chrome 中开启 View → Developer → Allow JavaScript from Apple Events。需要使用的每个 Chrome profile 都应开启。
打开 系统设置 → 隐私与安全性,为启动 MyChrome 的应用授权。它可能是 Terminal,也可能是桌面 AI 客户端,以诊断结果指出的应用为准。
| 权限 | 用途 |
|---|---|
| 自动化 → Google Chrome | 通过 Apple Events 读取和控制 Chrome |
| 辅助功能 | 真实鼠标与键盘输入 |
| 屏幕录制 | 截图和本机文字识别 |
| 输入监控 | 可选的个人操作节奏录制;浏览器基本操作不需要 |
如果系统要求重启应用,重启对应应用,再从实际启动 MCP server 的同一应用运行:
node src/index.js doctor
尚未出现自动化提示时,可用
node src/index.js doctor --ask 请求系统提示;--open
打开相关设置页。授权由你在系统界面中完成。
连接 AI 客户端
生成适合当前 Node 和源码目录的准确命令:
bash scripts/setup.sh --instructions
选择 Codex 或
Claude Code
部分,运行打印出的注册命令。如果已有名为
mychrome 的配置,先确认它指向哪里再替换。其他 stdio MCP
客户端使用打印出的 Node 绝对路径和 src/index.js 路径。
使用 Codex 时,还需把打印的 TOML 设置应用到
~/.codex/config.toml 中已有的 MyChrome 项,设置
startup_timeout_sec = 30 和
tool_timeout_sec = 900,不要建立同名重复项。较长的超时让排队与人工接手有时间完成。
如果客户端需要重启或新开会话才能加载 MyChrome,先完成这一步,再带着原任务上下文继续。如果已关闭 MyChrome,可通过 Spotlight 或 Finder 重新打开原生窗口。
| 客户端 | 浏览器工具 | MyChrome 窗口中的实时文字与直接回复 |
|---|---|---|
| Codex | 支持 | App 新建对话支持;外部已有对话需要支持的本机集成和已关联会话 |
| Claude Code | 支持 | App 新建对话支持;外部已有的 Claude Code 对话不能关联,请在原客户端继续 |
| 其他本机 stdio MCP 客户端 | 使用生成的绝对路径连接 | 未提供适配器 |
要在 MyChrome 中创建独立对话,点击新对话,选择已安装并登录的 Codex 或 Claude Code CLI,再选择可用模型、支持的思考强度和工作目录。 模型选项由本机 CLI 返回,第一条任务可以留空。
会话窗口没有文字,不一定表示浏览器工具未连接。App 新建对话和外部 Codex 会话关联方法见会话窗口指南。
3. 回到原对话,继续当前任务
在 Chrome 打开你本来要处理的页面,保留现有登录状态。回到已连接 MyChrome 的 AI 对话,说明目标标签页和你希望完成的事。你可以这样提出请求:
用 MyChrome 接着帮我处理当前 Chrome 页面。先读实际内容,按我们已经确定的目标继续;如果目标不清楚或需要我本人处理,再停下来告诉我。
例如:按你提供的资料更新自己的 LinkedIn 页面,查看 Facebook 上需要回复的消息,或把已经写好的文章发布到你明确指定的账号。涉及编辑或发布时,说明账号、内容和操作范围;AI 应在当前授权内继续,并读取页面核对结果。
遇到密码、验证码或网站验证时,由你接手处理。完成后在原对话明确说“继续”;AI 再读取当前页面,接着原来的任务。你也可以随时用双 Esc 接回控制。
按你的节奏操作
打开操作设置,选择跟随任务、逐字键盘输入或直接粘贴,并设置 0.5×–3× 操作速度。速度影响键盘和鼠标操作;中文等逐字模式不支持的文字请选择粘贴。
我的操作习惯(可选实验功能)可以录制 3 分钟个人输入节奏。样本足够的打字、指针等节奏统计用于后续输入,样本不足的部分沿用默认值。你可以关闭使用或删除样本;这项录制需要输入监控权限。
习惯采样仅保存本机统计摘要,不保存输入内容、原始键鼠事件或截图;它不会完整重放你的行为。
随时接回控制
- 立即停止: 在 0.8 秒内连按两次 Esc,取消当前 AI 并收回键鼠。AI 需要你的新指令才能再次接管。
- 暂停所有连接: 收回控制后,在 MyChrome 中打开暂停 AI 操作,阻止后续输入。
- 选择输入方式: 在操作设置中选择跟随任务、逐字键盘输入或直接粘贴,速度可调为 0.5×–3×。明确选择对下一次操作生效,优先于 AI 参数。中文等逐字模式不支持的文字请选择粘贴。
- 处理私密输入: 密码、验证码和网站验证由你接手,完成后再决定是否继续。
- 保存重复步骤: 在网站流程检查记录并保存连续片段。每次运行提供新参数、明确选择现有标签页。流程指南。
接管期间普通物理输入会被拦截,请用双 Esc,不要依赖点击停止按钮。停止不会撤销已发出的文字、点击或提交。
常见故障
| 遇到的问题 | 下一步 |
|---|---|
| Mac 或 Node 不受支持 | 对照上方要求更新环境。当前构建不支持 Intel Mac、Rosetta Node、Windows、Linux 或其他浏览器。 |
| 缺少 Command Line Tools | 完成 xcode-select --install 后重跑安装。 |
| 已勾选权限但仍失败 |
检查
doctor
指出的应用,按系统要求重启,再从实际启动应用运行诊断。
|
| 已有 MyChrome App 属于另一个源码目录 |
保留原安装;继续使用原目录,或通过
--app-path 指定新的绝对路径安装独立副本。
|
| MCP 找不到 Node | 重新生成连接说明,使用 Node 绝对路径;桌面应用的 PATH 可能不同。 |
| Codex 工具超时 |
在现有配置项设置
tool_timeout_sec = 900,新开客户端会话。
|
| 外部 Claude 工具正常,MyChrome 对话区为空 | 外部已有会话不能关联,请继续在 Claude Code 中对话;也可点击 新对话建立独立的 Claude Code 对话,在 MyChrome 中查看实时文字和回复。 |
| 中文被逐字模式拒绝 | 在操作设置选择直接粘贴,读取当前输入框后再重试。 |
| 页面改变或结果不确定 | 先读取当前页面,确认原操作是否已经生效。 |
| 登录、CAPTCHA 或访问验证 | 在网站允许的范围内自行处理,再决定是否继续;MyChrome 不绕过验证。 |
仍有问题见支持说明。提供去除私人信息的小型复现,不要上传账号截图或运行记录。