跳到主要内容

MCP 接入（外部 AI 客户端）

NexBrowser MCP Server 把本机桌面端的 OpenAPI 包装成 MCP 服务，让 Codex、Claude Code、Claude Desktop、Cursor 等支持 MCP 的 AI 客户端直接列出环境、打开窗口、操作页面。

它和 Nex Agent 的分工：Nex Agent 是客户端内置的 AI 工作区，模型与 Token 都在 NexBrowser 这一侧；MCP 接入则是把浏览器能力交给外部的 AI 客户端，模型、会话与计费都在那一侧。

它是适配器，不是独立浏览器

所有动作最终都由本机 NexBrowser 桌面端执行。桌面端没有运行、或没有开启 OpenAPI 时，全部工具都会连接失败。

前置条件​

  • NexBrowser 桌面端正在运行，且已登录并选好团队。
  • API MCP 页面已开启 NexBrowser OpenAPI。
  • 本机已安装 Node.js 18 及以上版本，推荐 20+。

第一步：开启 OpenAPI 并复制密钥​

  1. 启动 NexBrowser 桌面端。
  2. 打开 API MCP，开启 NexBrowser OpenAPI。
  3. 复制页面上的访问密钥，并记下服务地址，默认是 http://127.0.0.1:45536。

默认端口被占用时会自动向后顺延，实际地址以 API MCP 页面显示为准。密钥规则与请求头格式见服务与鉴权。

第二步：在 AI 客户端里添加 MCP 服务​

下面命令中的 <your-openapi-token> 替换成上一步复制的密钥。

Codex

codex mcp add nexbrowser \
  --env NEX_API_KEY=<your-openapi-token> \
  --env NEX_API_HOST=http://127.0.0.1:45536 \
  -- npx -y @nexbrowser/mcp@latest

Claude Code

claude mcp add nexbrowser \
  --env NEX_API_KEY=<your-openapi-token> \
  --env NEX_API_HOST=http://127.0.0.1:45536 \
  -- npx -y @nexbrowser/mcp@latest

其他 MCP 客户端（Claude Desktop、Cursor 等）写入各自的配置文件：

{
  "mcpServers": {
    "nexbrowser": {
      "command": "npx",
      "args": ["-y", "@nexbrowser/mcp@latest"],
      "env": {
        "NEX_API_HOST": "http://127.0.0.1:45536",
        "NEX_API_KEY": "<your-openapi-token>"
      }
    }
  }
}

改完配置后需要重启 MCP 客户端才会生效。

第三步（可选）：安装自动化技能​

技能包内置了一套浏览器自动化的用法说明，装上之后客户端更容易用对工具：

npx skills add https://github.com/nex-browser/nexbrowser-mcp --skill nexbrowser-automation

配置项​

变量必填默认值说明
NEX_API_KEY是—API MCP 页面生成的访问密钥
NEX_API_HOST否http://127.0.0.1:45536OpenAPI 服务地址
NEX_TIMEOUT否30000单次请求超时，单位毫秒
NEX_EXPOSE_CDP否关闭设为 1 时只返回原始 CDP 地址

四项都有对应的命令行参数 --api-key、--api-host、--timeout、--expose-cdp。密钥建议走环境变量，不要写在命令行里。

能做什么​

  • 环境管理：列出、打开、关闭窗口，查看窗口详情。
  • 分组整理：创建与删除分组、移动窗口。
  • 页面自动化：连接窗口、导航、点击、输入、上传文件、管理标签页。
  • 页面检查：快照、截图、取文本、读控制台消息与网络请求。
  • 会话隔离：每个 MCP 进程只持有自己创建的浏览器会话。

常用工具名：

nex_browser_list              nex_browser_open
nex_browser_close             nex_browser_connect
nex_browser_tab_list          nex_browser_snapshot
nex_browser_click             nex_browser_fill_form
nex_browser_take_screenshot   nex_browser_network_requests

完整工具清单通过 MCP 的 tools/list 获取。

其他安装方式​

不想每次都走 npx 可以全局安装：

npm install --global @nexbrowser/mcp
nexbrowser-mcp

常见问题​

现象处理办法
连接失败确认 NexBrowser 桌面端在运行，且 OpenAPI 已开启
提示未授权密钥可能已重置，重新复制并更新 NEX_API_KEY
提示接口不存在桌面端版本过旧，升级到带 API MCP 的版本，见版本更新
客户端里看不到工具重启或重新加载 MCP 客户端
端口不是 45536默认端口被占用会顺延，把 NEX_API_HOST 改成页面显示的地址

安全提示​

密钥与页面内容都是敏感数据
  • 没有远程需求时，让 OpenAPI 保持只监听本机回环地址。
  • 不要把密钥、或含密钥的配置文件提交到代码仓库。
  • 重置密钥后旧密钥立即失效，已配置的客户端都要同步更新。
  • 页面快照与正文会发送给外部模型服务商，其中可能包含账号等敏感信息。
  • 页面求值、代码执行、原始 CDP 这类能力按需开启，不用时关掉。

相关页面​