mcp-handler 现已支持 WebMCP
内容提要
mcp-handler 2.2.0 实验性支持 WebMCP 网页标准，网站只需添加一个 script 标签，即可将现有 MCP 工具暴露给浏览器内智能体。在 experimental_webMcp 中指定工具后，通过 /api/mcp?webmcp-script 加载脚本，工具调用会以已登录用户身份代理回 MCP 服务器，无需浏览器端 OAuth 流程。
延伸解读
WebMCP 的定位与实验性质
WebMCP 是一项尚在提议阶段的网页标准，目标是把工具暴露给浏览器内的智能体。mcp-handler 2.2.0 对此提供的是实验性支持，意味着接口和行为可能随标准演进调整，不适合直接用于对稳定性要求高的生产环境。开发者应关注后续版本变化，并做好兼容性预案。
接入方式与最小改动
接入只需两步：在 createMcpHandler 的配置中通过 experimental_webMcp.tools 指定要开放的工具名，然后在页面中添加一个指向 MCP 端点并带 ?webmcp-script 参数的 script 标签。脚本会自动把这些工具注册到页面，调用时再代理回 MCP 服务器。现有工具无需重写，改动集中在配置和页面引入。
认证模型带来的便利与边界
工具调用会以已登录用户身份代理回 MCP 服务器，因此依赖用户身份的认证工具可以直接工作，无需在浏览器端再走一遍 OAuth 流程。这简化了前端集成，但也意味着工具暴露范围必须谨慎控制：只有明确列入 experimental_webMcp.tools 的工具才会对页面内智能体可用，未列出的工具不会自动开放。
Q&A
mcp-handler 2.2.0 新增了什么功能？
mcp-handler 2.2.0 实验性支持 WebMCP，这是一个将工具暴露给浏览器内智能体的网页标准提案。
如何让网站上的 MCP 工具对浏览器内智能体可用？
在网站中添加一个 script 标签，指向 MCP 端点的 ?webmcp-script 参数，即可将现有 MCP 工具暴露给浏览器内智能体。
如何指定哪些 MCP 工具通过 WebMCP 暴露？
在 createMcpHandler 的配置中，将工具名称添加到 experimental_webMcp 对象的 tools 数组里，例如 tools: ["roll_dice"]。
WebMCP 脚本如何加载？
通过 <script src="/api/mcp?webmcp-script"></script> 从 MCP 端点加载脚本。
使用 WebMCP 时，工具调用如何认证？
工具调用会以已登录用户身份代理回 MCP 服务器，因此无需浏览器端 OAuth 流程即可使用需要认证的工具。
要开始使用 WebMCP 支持，需要做什么？
升级到 mcp-handler@2.2.0 并阅读文档即可开始使用。
