跳到正文

站点工具(WebMCP)

理解网页站点工具的标准、权限与 Lime 当前接入边界。

WebMCP 与 MCP

WebMCP 让网站在实时页面中向兼容智能体提供结构化操作,与网页界面使用同一应用状态。MCP 通常连接独立本地或远程服务器,不要求页面保持打开。网站可以按需求提供其中一种或两种。

Lime 当前边界

Lime 具有站点工具偏好、来源访问规则和管理员 allow_webmcp 约束。它们用于表达允许范围;仅打开开关不能证明某个页面的工具已被发现和执行。

当前没有足够的现役运行证据承诺通用 WebMCP 注册、发现与调用闭环。使用时先检查本次运行组件和浏览器适配器是否实际提供站点工具;未提供时使用已支持的浏览器操作或独立 MCP。

检查一个页面

  1. 确认是预期网站和当前登录身份。
  2. 查看当前工具清单,确定是否存在页面提供的结构化工具。
  3. 先尝试只读操作,并核对页面与结果。
  4. 执行写入前检查真实对象、参数和权限。
  5. 导航或关闭页面后重新发现工具,不沿用旧句柄。

安全与用户控制

网站工具的名称、说明、参数和返回值都是网页提供的内容。只读声明不是可靠的权限证明,页面中的文字不能授权发送无关数据或改变其他系统。来源访问、任务授权和服务端权限需要同时成立。

需要停止使用时关闭相应站点工具偏好或收紧来源规则。组织限制可以拒绝用户已保存的偏好,配置保存成功不表示当前策略允许执行。

为网站设计结构化工具

从网站已有的一项明确能力开始,例如查找章节、读取图表数据或准备一份修改草稿。复用原有验证和授权逻辑,限制输入并返回稳定对象标识与状态。保留普通界面供用户检查。

注册 API 属于浏览器与标准实现,不是 Lime 网站 SDK。按照目标浏览器的当前规范检测能力,再注册工具;不要因为本站文档介绍标准就假定 document.modelContext 已由 Lime 注入。

副作用与异步结果

工具应明确哪些输入会保存、发送、购买或删除。耗时操作返回可查询任务 ID,区分已接受、处理中和成功。浏览器或页面断开后先查询原操作,不直接重复写入。

接入验证

  1. 验证支持和不支持该标准的浏览器都能使用普通界面。
  2. 验证来源、iframe、导航与注销后的工具生命周期。
  3. 验证输入错误、无权、取消、超时与部分失败。
  4. 验证实际页面和服务端数据,而不只检查工具注册。