跳到主要内容

Browser

Browser 支持把 Anyy 连接到受管浏览器 MCP server，并通过 browser 工具集暴露 Anyy 管理的浏览器工具。

这是 MCP 集成路径，不是内置浏览器引擎。本地 CLI 会配置 MCP server block，验证发现到的工具，并在请求时激活工具集。

状态​

检查本地配置和运行时可见性：

anyy browser status
anyy browser status --json

Status 输出会报告受管浏览器 MCP server 是否已配置、是否启用、保存的 URL、允许了多少工具、gateway 是否可达，以及 browser 是否在运行时工具目录中可见。

Doctor​

当 status 信息不够时运行 doctor：

anyy browser doctor
anyy browser doctor --json

Doctor 会探测已配置的 MCP server，验证必需工具，拒绝 excluded managed tools，并检查运行时能否发现该 server。

必需的 discovered tools：

Tool
browser_navigate
browser_snapshot
browser_click
browser_type
browser_wait_for
browser_take_screenshot
browser_tabs
browser_close

连接​

本地 browser MCP node 的默认 URL：

http://localhost:8931/mcp

连接并激活：

anyy browser connect

远端 HTTPS MCP endpoint：

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

connect 可以使用本地默认 URL。enable 要求传入 --url。

连接期间，Anyy 会发现工具并只保留受管 allowlist。然后写入 mcp.client.servers.browser，并把 browser 加入默认工具集列表。

断开连接​

禁用受管 browser server，并移除默认工具集：

anyy browser disconnect
anyy browser disable

两个命令执行同一个 disable 操作。如果 gateway 支持 runtime config RPC，会通过 gateway 应用变更。否则 CLI 会写 config.yaml；重启 gateway 后运行时可见性才会变化。

配置​

受管配置形状：

mcp:
  client:
    enabled: true
    servers:
      browser:
        enabled: true
        display_name: Browser
        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

实际 include list 可以包含连接时发现的更宽受管 allowlist，包括 navigation、click、type、form fill、selection、check、uncheck、key press、wait、screenshots、tabs、close 和 dialog handling 工具。

Excluded managed tools 包括浏览器代码执行、文件上传、网络请求、console messages、route management、cookie/storage 访问和 PDF save。如果这些工具出现在 include list 中，doctor 会失败。

安全边界​

边界行为
Transport明文 HTTP MCP URL 必须是本地地址。远端 browser node 使用 HTTPS。
工具过滤Anyy 验证必需工具，并拒绝 excluded browser MCP tools。
工具集可见性Browser tools 只会在 server 启用且选择 browser 工具集时出现。Raw mcp-browser tools 只用于显式 MCP 诊断。
Secrets显示前会脱敏 URL 和 MCP status errors。
PolicyAnyy browser tools 拥有模型可见的风险、审批、超时和输出投影。只有显式选择 mcp-browser 做诊断时，raw MCP policy 才适用。

MCP 概念和字段级配置见 MCP 集成。