# 如何用 Codex 驱动美客浏览器：Merca MCP 配合 browser-use CLI 自动化入门

> 通过 Merca GS 的 MCP 接口将美客防关联浏览器接入 Codex，配合 browser-use CLI 实现多店铺网页自动化操作。附简洁自然的提示词与连通性排查指南。

Source: https://merca.getchrovia.com/zh/blog/codex-mcp-browser-use-automation

在跨境电商日常运营中，登录后台巡店、导出订单、监控在售商品状态、核对在库库存等操作往往高度重复。如果在普通浏览器里写自动化脚本，既容易因为缺少防关联指纹和固定代理节点而触发风控，又需要繁琐地维护 Cookie 和登录凭据。

美客浏览器（Merca GS）原生支持 **MCP（Model Context Protocol，模型上下文协议）**。借助该协议，你可以将美客浏览器作为受控工具接入 AI 编程智能体 **Codex**，再配合开源的网页操作工具 **browser-use CLI**，让 Codex 在拥有独立纯净环境、独立 IP 代理和防关联指纹的店铺浏览器内，自动化执行各种网页任务。

整个落地流程可以清晰划分为五步：从美客客户端复制 MCP 配置、由 Codex 写入配置并重启、安装 browser-use CLI 工具、验证端到端链路就绪，最后通过自然语言 Prompt 驱动自动化任务。

本文以 **Merca GS 客户端与 Codex 运行在同一台电脑（Localhost）** 的常见场景展开，文中的示例 Prompt 简洁自然，可直接复制使用。

## 整体架构：各组件如何分工协同？

在整套自动化工作流中，三个核心组件各司其职：

1. **Codex（大脑调度）**：负责理解你的自然语言任务意图，将其拆解为执行步骤，并决定何时调度环境管理接口、何时调用网页操作命令。
2. **Merca MCP 服务（环境隔离管控）**：由美客浏览器桌面客户端提供。它负责向 Codex 暴露店铺列表、内核状态与启动/关闭接口。当需要执行任务时，它拉起目标店铺专用的浏览器进程，自动装载该店铺绑定的独享代理节点、隔离数据目录以及硬件指纹。
3. **browser-use CLI（页面交互执行）**：基于 CDP（Chrome 调试协议）的页面驱动工具。它直接挂载到 Merca 已拉起的店铺浏览器实例上，负责 DOM 读取、表单输入、点击交互与截图验证。[Browser Use 官方项目](https://browser-use.com/coding-agents)对这类命令行与 AI 协同模式做了完整支持。

**协同链路如下**：你提出业务需求 → Codex 通过 Merca MCP 识别店铺并拉起带调试端口的浏览器 → browser-use CLI 附着到对应调试端口 → AI 执行页面操作并将结果整理返回给你。

## 第一步：从美客客户端复制 MCP 配置

启动美客浏览器桌面客户端并登录账号，进入 **设置 → 自动化**（或通过主导航进入自动化服务页面）。开启 **启用服务** 开关后，在页面下方的 **MCP** 卡片区域，点击右上角的 **复制** 按钮。

开始接入前，请确保满足以下前置检查项：

- **套餐与权限**：当前登录账号在有效付费套餐期内，且对目标操作店铺拥有读取或启动权限。
- **环境状态**：浏览器内核组件已加载就绪，且待操作店铺已正确绑定可用节点。
- **只读开关**：MCP 设置中的 **只读模式** 须处于关闭状态（只读模式下仅允许查询数据，Merca 会禁用 launchStore 等写操作工具）。
- **开发者权限**：若当前客户端登录的是团队子成员账号，请在主控台确认该成员未开启“禁用开发者工具”限制；若刚刚修改了该设置，需要重启店铺浏览器生效。

如果在单台本地设备上开发与使用，保持默认的 127.0.0.1 监听即可，无需开启“允许局域网访问”。在后续自动化执行过程中，须保持美客桌面客户端处于开启并登录状态。

客户端界面的文本框中为了防止截屏泄密，默认以星号掩码展示密钥；但点击 **复制** 按钮写入剪贴板的内容包含了完整的有效 API Key。请勿将复制出的内容上传至公开代码仓库或论坛。

## 第二步：把配置发给 Codex，然后重启

打开 Codex 对话窗口，直接发送以下简要指令，并在末尾粘贴上一步剪贴板中的完整内容：

```text
把下面这段 Merca GS 的 MCP 配置接入到这台电脑的 Codex 里，保留我现有的其他配置。配置好后提醒我重启。
配置如下：
【在这里粘贴完整 MCP 配置】
```

美客客户端导出的是标准 Streamable HTTP JSON 配置，而 Codex 使用自己的 TOML 配置（通常在 ~/.codex/config.toml）。直接让 Codex 帮你转换写入即可。具体格式要求可参考 [OpenAI 官方 MCP 文档](https://developers.openai.com/codex/mcp)。

Codex 提示配置写入完成后，**彻底退出并重新打开 Codex**，新工具就会加载生效。

## 第三步：让 Codex 安装 browser-use CLI

重启 Codex 后，发一条简单直接的指令让它装好命令行工具：

```text
帮我安装最新版的 browser-use CLI 和配套的 Codex skill。装好后检查下版本告诉我。
```

Codex 会自动拉取最新的 browser-use 工具链及 skill 说明文件。完成后若提示需要重载会话，按提示刷新即可。

## 第四步：确认工具已经真正连通

正式让 AI 跑业务前，先发一条测试指令，让 Codex 确认能够正常调起店铺并且连上页面：

```text
测试一下 Merca MCP 和 browser-use CLI：
通过 Merca 工具启动“演示店铺”（记得开启调试端口），然后让 browser-use 连上去读取一下当前页面的网址和标题，看看是否一切就绪。
```

AI 足够聪明，它会自动调用 Merca 的 `launchStore` 传入 `--remote-debugging-port`，等待调试端口就绪后挂载 browser-use，最后向你反馈页面的 Title 和 URL。

在排查问题时，请注意区分两个端口：
- **美客服务端口**：默认为 `43210`，是 Codex 调用 Merca 控制店铺环境的通道。
- **浏览器调试端口**：例如 `9222`，是店铺浏览器进程开放的 CDP 端口，供 browser-use 进行页面控制。更多机制可参考[自动化 API 说明文档](https://merca.getchrovia.com/zh/docs/automation-api)。

## 第五步：用自然语言安排日常业务

连通检查通过后，日常运营就可以直接用大白话安排工作了，只要把**哪个店铺**、**做什么**以及**限制要求**交代清楚即可：

### 场景一：快速查看店铺后台状态

```text
在“演示店铺”里打开后台首页，帮我看看账户健康状况有没有异常提示。如果停留在登录页就提醒我，不要点其他按钮。
```

### 场景二：提取并整理待发货订单

```text
在“美国站店铺”里打开订单列表，把最近 7 天待发货的订单整理成表格给我，包含订单号、下单时间和商品名。只查询，不要点发货。
```

### 场景三：修改商品文案并暂停确认

```text
在“美国站店铺”里找到 SKU 为 DEMO-001 的商品并进入编辑页，把标题换成“【新标题】”。填好后告诉我修改前后的对比，先别点保存，等我确认。
```

无论是查数据还是填表单，AI 都能理解意图并自动在独立纯净的店铺环境下执行完毕。对于敏感操作，只要加上“保存前等我确认”之类的提示，就能做到安全可控。

## 常见问题与排查思路

- **看不到 Merca 工具**：确认配置写入后是否彻底重启了 Codex；检查美客客户端是否处于登录运行状态、本地自动化服务是否已开启。若重新生成了 API Key，需同步更新配置。
- **能列出店铺，但没有启动工具**：检查客户端设置中的 MCP **只读模式** 是否关闭。关闭后刷新工具列表或重启 Codex。
- **启动店铺失败**：检查账号套餐状态、店铺权限、内核就绪状态以及节点绑定；若遇到 IP 冲突提示，请在客户端[登录保护](https://merca.getchrovia.com/zh/docs/login-protection)记录中核对。
- **浏览器已打开，但无法操作网页**：确认启动时是否附带了调试端口且无端口冲突；确认当前操作的团队子账号未开启“禁用开发者工具”限制。

通过将 Merca GS 的多环境防关联调度与 browser-use CLI 的灵活操作相结合，跨境团队无需编写繁复的爬虫代码，就能在安全纯净的店铺环境中把日常巡店与填报工作交给 AI。
