WebMCP：WorldMonitor 浏览器工具

​

选择正确的接口

​

可用性

​

生产 Origin Trial

• https://www.worldmonitor.app

• https://tech.worldmonitor.app
• https://finance.worldmonitor.app
• https://commodity.worldmonitor.app
• https://happy.worldmonitor.app
• https://energy.worldmonitor.app

​

本地开发

1. 打开 chrome://flags/#enable-webmcp-testing。
2. 将 WebMCP for testing 设为 Enabled。
3. 完全重新启动 Chrome。
4. 本地启动 WorldMonitor。打开 /dashboard 检查含三十一个工具的仪表板；不要使用 /embed。若要检查含两个工具的静态首页，请先运行 npm run build:pro，再打开 /pro/welcome.html。本地 Vite 的 / 会加载仪表板 SPA，只有生产环境才把 / 重写到欢迎页。
5. 在 DevTools 中确认特性检测：

Boolean(document.modelContext?.registerTool)

​

ChatGPT 桌面应用内置浏览器

1. 更新 ChatGPT 桌面应用，并选择当前支持站点工具的模型和工作区。
2. 在内置浏览器中打开 https://www.worldmonitor.app/。测试仪表板清单时请使用 /dashboard。
3. 在浏览器地址栏中选择 Site tools，再选择 Available site tools。首页列出两个命令式工具，仪表板列出三十一个。
4. 保持该页面打开，并要求 ChatGPT Work 或 Codex 使用 WorldMonitor 工具。
5. 如果没有显示工具，请在内置浏览器中重新加载页面，再次检查 Available site tools。

​

宿主支持与取消

​

工具清单

​

首页工具

​

仪表板命令式工具

​

声明式采购工具

​

常见浏览器智能体流程

​

结果、拒绝与错误

​

面板布局与任务预设的拒绝原因

​

人工控制与 UI 行为

• 命令式工具在启动时同步注册，但会等待所需 UI 或地图渲染器。销毁应用会中止待处理工作并注销工具；同文档重新初始化不会产生重复注册。
• 动作经过与人工控件相同的 UI、agent-bus、面板和地图路径，不调用具有额外权限的后端捷径。
• 每次调用时都会评估认证、订阅权益、仪表板变体、面板挂载状态、图层策略和渲染器就绪状态。登录时发现的工具不能在退出或降级后保留访问权。
• 成功变更保持可见：面板打开、搜索界面出现、地图状态变化、仪表板标签页变化，声明式采购表单显示激活/等待状态。
• 被拒绝、无效、跳过、不可用和过期操作返回受限结果或安全错误，不会静默绕过锁定，也不会虚构结果。
• 用户可以继续操作页面；已有的重置、关闭、导航和取消控件始终具有最终控制权。

​

安全与隐私

• 生产仪表板响应包含 Origin-Agent-Cluster: ?1，且 Permissions-Policy 包含 tools=(self)。
• WorldMonitor 不通过 fromOrigins、exposedTo 或 iframe 的 allow="tools" 委派向其他源开放 WebMCP。
• /embed 和 /embed.html 明确发送 tools=()。即使父页面拥有 WebMCP，嵌入的 WorldMonitor 面板也不得暴露任何工具。
• WebMCP 复用用户现有浏览器会话，不通过工具参数接受新的 API 密钥，也不会弱化面板和数据权益。
• get_access_context 只报告账户状态、产品档位、能力标志和限额，绝不包含姓名、电子邮件、账户 ID、令牌或会话详情。open_sign_in 只打开现有 Clerk 对话框，永不接受凭据。
• 仪表板搜索结果按不可信内容处理，并在选择前重新验证。
• 仪表板运行遥测严格受限：webmcp-registered 记录 toolCount、pageSurface 和 API 类别；webmcp-registration-failed 记录工具及稳定原因；webmcp-tool-invoked 记录工具、结果和终态原因。仪表板搜索还可以记录查询长度、结果数及允许列表内的结果类型类别。这些 WebMCP 专用自定义属性不得包含参数、搜索文本、结果键、返回内容、URL、招标内容或用户身份。事件仍使用 WorldMonitor 常规的 Umami 页面与会话外层信息，其中包含页面上下文，并可能与已登录的仪表板身份关联；受限路径只会省略自动内容归因属性，不会移除常规分析会话元数据。

​

使用浏览器 API 调试

const modelContext = document.modelContext;
const tools = await modelContext.getTools();
console.table(tools.map(({ name, description }) => ({ name, description })));

const tool = tools.find(({ name }) => name === 'search_dashboard');
const schema = JSON.parse(tool.inputSchema);
console.log(schema);

const result = await modelContext.executeTool(
  tool,
  JSON.stringify({ query: 'Hormuz', scope: 'all', limit: 5 }),
);
console.log(result);

const controller = new AbortController();
const pending = modelContext.executeTool(
  tool,
  JSON.stringify({ query: 'shipping disruption' }),
  { signal: controller.signal },
);
controller.abort();
try {
  await pending;
  throw new Error('Expected the aborted execution to reject.');
} catch (error) {
  if (error?.name !== 'AbortError') throw error;
  console.log('Execution cancelled with AbortError.');
}

​

故障排除

​

维护与发布本契约

​

反馈与官方参考

• Chrome WebMCP 概述
• 命令式 API
• 声明式 API
• WebMCP 与 MCP 的比较
• 最佳实践
• 安全指南
• 评估指南
• Chrome 149 Origin Trial 公告
• Chrome DevTools 149 WebMCP 检查器
• OpenAI：站点工具