跳到主要内容

Browser 集成

Browser integration 把 Anyy 连接到 managed browser MCP server。Anyy 通过稳定的 browser toolset 暴露托管浏览器工具,raw mcp-browser backend tools 只用于显式 MCP 诊断。

这个页面讲 integration wiring。面向用户的行为见 Browser

连接

本地 browser MCP endpoint:

anyy browser connect

默认本地 URL:

http://localhost:8931/mcp

远程 HTTPS endpoint:

anyy browser enable --url https://browser-node.example.com/mcp

connect 可以使用本地默认值;enable 必须显式传 URL。

写入的配置

Anyy 会写入名为 browser 的 managed MCP server:

mcp:
client:
enabled: true
servers:
browser:
enabled: true
transport: http
url: http://localhost:8931/mcp
call_timeout_ms: 180000
tools:
include:
- browser_navigate
- browser_snapshot
- browser_click
- browser_type
- browser_wait_for
- browser_take_screenshot
- browser_tabs
- browser_close

toolsets:
default:
- browser

如果 server 暴露了其他允许的 browser tools,实际 include list 可以更宽;Anyy 仍会验证必需工具,并拒绝被排除的 managed browser tools。

Doctor 检查

快速查看:

anyy browser status

Browser tool 不出现或 endpoint 变更时:

anyy browser doctor

Doctor 会检查保存的 URL、managed include list、可用时执行 discovery,并报告运行中的 gateway 是否能看到 browser

断开

anyy browser disconnect

或:

anyy browser disable

两者都会 disable managed browser server,并从默认 toolset 移除 browser toolset。如果 gateway 不可达,CLI 只会写本地 config;重启 resident gateway 后 runtime 才会变化。

安全注意事项

  • Plain HTTP browser MCP URL 必须是本地地址。
  • 远程 browser node 使用 HTTPS。
  • 只有 server enabled 且选中 browser 时,browser tools 才可见。
  • Browser setup 默认不激活 raw mcp-browser backend tools。
  • Managed MCP server 的 transport call timeout 是高于 browser phase budgets 的安全 ceiling。