Skip to content
配置指南

WebMCP管理 ​

WebMCP 管理位于配置页左侧导航中,用来编写自定义页面脚本。脚本按 @match 规则注入到匹配的网页,并在页面上注册 WebMCP 工具。这样不必改网站源码,AI 也能调用该站点上的业务能力。

承载这套能力的是内核插件「用户自定义 MCP 脚本」。它始终启用,功能管理里没有总开关。要停用某一条脚本,在本页关掉它自己的开关。

页面上方是说明,以及新建脚本、导入、导出。下方左侧是「已安装脚本」列表,右侧是编辑区。还没选中脚本时,右侧提示「选择脚本开始编辑」。

WebMCP 管理整页

WARNING

自定义脚本会在目标网页里执行,能读取和改动该页面。请只启用你理解并信任的脚本。脚本还受目标网站内容安全策略(CSP)约束:站点若禁止 unsafe-eval,相关工具无法运行。

脚本如何生效 ​

当脚本处于启用状态,且其 @match 规则命中当前页面网址时,会在该页面中通过 document.modelContext.registerTool 注册工具。扩展会把这些工具列进侧边栏「扩展」抽屉的页面工具里,AI 可以像调用其他工具一样调用它们。页面工具的查看方式见 扩展与 MCP。

保存、启用、停用或删除之后,页面都会提示「请刷新相关页面以生效」。已经打开的网页不会自动换上新脚本,需要刷新目标网页。

网站自己注册的 WebMCP 工具不在本页管理。本页只管理你写的、或导入的自定义脚本。为业务系统接入原生工具的方法见 WebMCP-SDK 快速开始。

新建与编辑 ​

  1. 点击新建脚本。若右侧已有未保存的修改,会先询问是否放弃。
  2. 右侧打开一份草稿,标题为脚本名称。默认名称是「我的页面工具」;已有同名脚本时会自动变成「我的页面工具 2」这样的编号。
  3. 改完后点击右上角保存。成功时提示「已保存,请刷新相关页面以生效」,脚本出现在左侧列表。

草稿在改动后,标题旁会显示「未保存」。此时若切换到其他脚本、新建脚本,或执行其他会离开当前草稿的操作,都会弹出「未保存修改」。继续编辑留在当前内容,放弃修改才切换走。

尚未保存的新建草稿点删除,确认框是「确定放弃新建该脚本吗?」,确认后草稿消失,不会留下脚本。

基本信息 ​

「基本信息」可以折叠。带 * 的项必填。

字段要求
脚本名称必填,且不能与其他脚本重名
脚本描述可选,用来说明这条脚本做什么
@match必填,决定注入哪些网页,见 匹配规则
启用开启并保存后,符合匹配规则的网页才会注入这条脚本

新建草稿默认是启用的,默认匹配规则是 *://example.com/*。保存前请改成你要操作的网站,否则脚本不会出现在那个网站上。

脚本基本信息与源码

源码 ​

源码区标题为「源码 · JavaScript」。新建时会填入一份示例:在匹配页面注册一个工具,返回当前页面标题,用来确认脚本已经注入。按自己的需求改 name、description 和 execute 即可。同一页面里工具的 name 不能重复。

源码不能为空。编辑器里也可以用保存快捷键保存。

最小形态如下:

javascript
document.modelContext.registerTool({
  name: 'read_page_title',
  description: '返回当前页面标题',
  execute: async function () {
    return { content: [{ type: 'text', text: document.title }] }
  }
})

完整的注册参数见模板注释里的 WebMCP 文章。

匹配规则 ​

@match 每行一条,同一行里用逗号隔开也可以。文本最多 1000 个字符。至少要有一条合法规则,保存时才会通过。

规则形如 协议://主机/路径,三段各自匹配。通配符 * 只在当前段内生效,不会跨段匹配路径。不支持在规则里写端口:http://localhost:3000/* 会被拒绝,应写成 *://localhost/*。

规则生效范围
*://example.com/*example.com 的 http 与 https,任意路径
https://example.com/docs/*仅 https,且路径以 /docs/ 开头
*://*.example.com/*example.com 本身及其子域名
*://*/*所有 http、https 网站

一条脚本写了多条规则时,命中任意一条就会注入。左侧卡片只显示第一条规则;鼠标停在规则上,可以看到全部规则。没有规则时卡片显示「(未设置匹配规则)」。

启用与停用 ​

有两个开关,作用不同:

  • 左侧卡片上的开关点下去立即保存。开启提示「已启用,请刷新相关页面以生效」,关闭提示「已停用,请刷新相关页面以生效」。
  • 基本信息里的「启用」属于当前草稿,要点右上角保存才会写入。正在编辑该脚本时,切换左侧开关状态会同步更新当前草稿,不会因此变成「未保存」。

停用的脚本名称会变淡,刷新页面后不再注入。已经在当前页面里注册过的工具,要刷新后才会消失。

启用后,扩展抽屉中出现该页面注册的工具

删除 ​

打开一条已保存的脚本,点击右上角删除,确认框为「确定删除脚本「名称」吗?」。确认后脚本从列表移除,并提示刷新相关页面。取消则保持原样。

导入与导出 ​

导入、导出都在浏览器本地完成,脚本不会上传到服务器。文件是 JSON。

导出 ​

点击导出。没有已保存的脚本时,提示「暂无脚本可导出」。有未保存的修改时,仍会下载已保存的内容,并提示「导出的内容不包含未保存修改」。

下载文件名为 webmcp-scripts-<日期>.json,例如 webmcp-scripts-2026-10-30.json。文件是一个脚本数组,每条包含脚本编号(id)、名称、描述、@match 和源码。启用状态不在导出文件里。导入时用 id 判断是不是同一条脚本。

导入 ​

  1. 点击导入,选择 .json 文件。其他扩展名会提示「请选择 .json 备份文件」。
  2. 文件可以是脚本数组,也可以是带 scripts 数组的对象。
  3. 导入完成后,左侧列表出现新脚本。

新导入的脚本一律是停用的。核对名称、匹配规则和源码后,再打开开关并刷新目标网页。

导入时的其他处理:

情况结果
名称与已有脚本相同自动加上「 2」「 3」等编号后导入
文件里的脚本编号与本地已有脚本相同作为一条新脚本导入,不覆盖原来的那条
缺少名称或源码,或 @match 不合法跳过这一条
再次导入同一份备份再增加一批停用脚本,不替换已有脚本

成功提示会写明导入条数,以及跳过、编号冲突、名称自动编号的数量。JSON 无法解析,或内容既不是数组也不含 scripts 时,导入失败并给出原因。

常见问题 ​

  • 保存了,对话里仍找不到这个工具:刷新目标网页。确认脚本已启用,且当前网址能命中 @match。然后在侧边栏「扩展」抽屉中查看该页面的工具。
  • 左侧开关已经打开,页面还是旧行为:启用和保存都要刷新目标网页后才注入。编辑区里改的「启用」还需要先点保存。
  • 只有部分网页能用:检查 @match。规则不写端口;localhost:5173 这类地址应写成 *://localhost/*。*.example.com 才包含子域名,单独的 example.com 不包含。
  • 导入后的脚本默认均为停用状态:这是预期行为。核对无误后再逐条启用。
  • 导出文件里没有刚改的源码:导出只含已保存内容。先保存,再导出。
  • 工具未执行,且浏览器控制台出现与 CSP(内容安全策略)相关的报错:该网站禁止了 unsafe-eval,自定义脚本无法在该站运行。
  • 想关掉全部自定义脚本:本页没有总开关。把列表里每条脚本的开关关掉,并刷新已打开的网页。

相关链接 ​

  • 扩展与 MCP:页面工具在对话抽屉中的位置,以及网页自带的 WebMCP 工具。
  • 内置功能:用户自定义 MCP 脚本为何始终启用。
  • 快速入门:不改网站源码时,用本页为站点补充工具。