UCP 与 MCP 实施指南 + 技术清单

到目前为止,你已经读过关于 UCP、MCP 和 GEO 的内容。本指南是这段旅程中最偏技术的部分:一步步教你如何在真实的商店网站上实施这些标准——从构建第一个文件到最终测试。

前置条件

拥有域名根目录的访问权限,以便在 /.well-known/ 路径下上传文件
一个能够返回 JSON 端点的后端(任何语言均可:PHP、Node.js、Python 等)
有效的 HTTPS 访问(大多数智能体不接受普通的 HTTP 连接)

第一步:构建 ucp.json 文件

最快的方式是使用免费的 UCP 生成器:输入你的企业信息、业务类型和所需能力,即可生成一份完整、可直接使用的文件。如果你更愿意手动编写,请务必按照 UCP 指南文章,完整填写 protocol、merchant_name 和 capabilities 字段。

第二步:发布到正确的路径

该文件必须能在 https://yoursite.com/.well-known/ucp 这个确切地址访问,并且其 Content-Type 头必须设置为 application/json。许多服务器默认会阻止对 .well-known 文件夹的访问——请务必在你的 Web 服务器配置中检查这一点。

第三步:实现端点

对于你在 UCP 文件中声明的每一项能力(例如 search_offers 或 initiate_checkout),都需要在后端构建一个真实的端点,准确返回所定义的响应结构。一个重要提示:响应必须始终是有效的、结构化的 JSON——绝不能是 HTML 或自由文本。

第四步:搭建一个简单的 MCP 服务器

如果你希望智能体能够受控地访问你的内部数据(例如实时仓库库存),请按照 MCP 指南构建一个带有明确工具的独立服务器。建议将该服务器与网站的公共 API 分开,以便拥有清晰的安全边界。

第五步:测试与验证

运行 curl -i https://yoursite.com/.well-known/ucp,检查是否返回 200 响应和有效的 JSON
在在线验证工具中检查 JSON 输出
使用 Postman 分别测试每个能力端点
测量端点的响应时间——智能体通常有较短的超时限制
确保在出错时返回带有明确消息的 JSON 响应,而不是 HTML 错误页面

不应忘记的安全提示

切勿将敏感的支付信息直接放在 UCP 响应中;应使用标准的支付网关
对于敏感端点(如支付),必须要求身份验证和请求签名
在所有公共端点上应用速率限制(Rate Limiting)
记录并监控异常请求或高流量情况

一个未经测试的端点,比根本没有这个端点更糟糕——因为你会失去智能体的信任,而这种信任一旦失去就很难挽回。

最终实施清单

ucp.json 文件已发布在 /.well-known/ucp,且 Content-Type 正确
所有已声明的能力都拥有真实且已激活的端点
响应始终是有效的 JSON,即使在出错时也是如此
HTTPS 已启用,证书有效
如有需要,已搭建了具有有限、受控访问权限的 MCP 服务器
已完成并记录了使用 curl/Postman 的最终测试

常见问题

完成这些步骤需要多长时间?

构建并发布 UCP 文件通常不到十分钟。完整实现各端点所需的时间,则根据商店的复杂程度,从几个小时到几个工作日不等。

我需要同时实现所有能力吗?

不需要。建议先从 search_offers 和 get_product_details 开始,再逐步添加支付等更高级的能力。

UCP 与 MCP 分步实施指南 + 完整技术清单