指纹浏览器 MCP：用 Claude 操作环境

开启 Local API 和 MCP

进入客户端「设置 → Local API」，先打开 Local API。下方的「MCP（AI 智能体）」默认启用，两者共用端口和密钥。默认接入地址是 http://127.0.0.1:54345/mcp，如果修改了端口，AI 助手的配置也要一起修改。

开启条件与 Local API 相同，需要套餐包含该功能，并使用所有者、管理员或具备相应权限的成员账号。服务只监听本机，AI 工具要从运行客户端的这台电脑连接。先确认客户端已登录、接口运行，再复制设置中的接入配置，避免拿旧端口或旧密钥排查连接。

在 Claude Code 中添加连接

在已安装 Claude Code 的本机终端执行下面的命令，把 KEY 换成设置中复制的密钥。如果已修改端口，同时替换地址中的端口。示例的服务名是 browser，它只用于在 AI 工具中识别这个连接，可以换成自己的名称。

添加完成后，先让 Claude 列出环境，确认名称和编号与客户端一致，再指定一个环境打开并读取页面。第一次连接建议先做查看和打开操作，把连接、权限与网页状态分别确认清楚。调整权限或新增插件后，需要在 Claude Code 中用 /mcp 重新连接，工具列表才会更新。

claude mcp add --transport http browser http://127.0.0.1:54345/mcp --header 'x-api-key: KEY'

在 Codex 中添加连接

打开本机 ~/.codex/config.toml，加入下面这段配置：KEY 换成实际密钥，地址使用设置页显示的 MCP 地址。已有同名连接时修改原来那段，不要重复添加。

保存后重新连接 MCP，让 Codex 列出当前账号可用的环境。客户端重新生成密钥后，所有引用旧密钥的 AI 工具都要更新；只修改客户端一侧，原连接会因鉴权失败而无法使用。若连接成功却没有预期工具，再检查对应权限档位和插件信任状态。

[mcp_servers.browser]
url = "http://127.0.0.1:54345/mcp"

[mcp_servers.browser.http_headers]
"x-api-key" = "KEY"

按任务调整 7 档权限

MCP 工具分为七档。关闭的档位不会出现在 AI 助手的工具列表中，调用也会被拒绝。查看档位始终开启，但不包含密码、两步验证密钥和 Cookie。管理员分配给成员的账号权限、套餐限制与环境占用规则仍然生效，连接 MCP 不会增加成员原本没有的权限。

这些档位只约束 MCP，不影响直接调用 Local API。通用透传允许助手通过一个工具调用任意 Local API 接口，开启后前面的 MCP 分类限制无法再限制这个入口。因此按任务开启需要的档位即可，需要临时读写敏感数据时，用完再关闭对应档位。

指定环境并操作网页

给助手的任务应写明环境编号、目标网站、要读取或填写的内容，以及完成后是否关闭环境。助手先打开环境，再用网页快照获得可操作元素的引用，然后执行点击或输入。网页跳转或重新绘制后，旧引用可能失效，需要重新获取快照再操作。

登录时可以让助手调用 fill_credentials 和 fill_totp，把环境中保存的账号密码与两步验证码直接填入页面，这些工具不返回凭证明文。遇到验证码、短信码或扫码步骤，使用人工接手工具处理。不要把保存了密码理解成能够自动完成网站的所有验证。

1. 先要求助手列出环境，再明确要操作的环境编号，避免只凭相似名称选择账号。
2. 让助手打开指定网页、读取标题和当前登录状态，再执行已经说明的业务步骤。
3. 结束后核对结果；需要换设备或交班时正常关闭环境，等待同步，具体见云同步。

把已安装插件交给 AI 调用

开启自动化档位并允许把插件列为独立工具后，团队中已启用、且已在本机确认信任的插件会成为 MCP 工具。插件声明的参数会转成工具参数，助手可以传入环境、文本或本机文件路径，调用结束后读取每个环境的状态、结果和错误。

插件信任确认需要由人在主控台完成，助手不能替你确认第三方代码。长流程超过等待时间时，插件可能仍在运行，助手应根据返回的运行编号继续查询，不能直接当作失败重跑。团队使用时可先按团队协作分配环境与插件可见范围，再安排调用。

查看调用记录并处理常见问题

设置页的最近调用记录可查看工具名称、目标环境和执行是否成功。工具被禁用时检查档位，环境未运行时先打开，页面引用失效时重新取快照。环境被另一台设备占用时，要等使用方关闭；窗口可以在后台运行，但不要最小化，以免个别页面停止绘制而使截图超时。

网页文字可能包含要求助手改变任务或导出数据的指令，应让助手只按你的任务操作。密钥保留在接入配置中，登录使用凭证填充工具。用于自动化的环境可以单独分组，并用只获授该分组的成员账号登录客户端，减少一次任务能够接触的环境范围。

常见问题