使用关联应用的前提条件

在开始之前，请确保您拥有以下各项：

  • 已部署的 MCP 服务器，具有安全的 HTTPS 端点

    您的 MCP 服务器必须可通过 HTTPS 使用可流式传输的 HTTP 传输（例如 https://api.yourdomain.com/v1/mcp）公开访问。

    如需了解实现详情，请参阅《Connected Apps Platform MCP 服务器开发者指南》。

  • 确保您的服务器可以接收来自 Google 的请求

    如果您的服务器按来源 IP 限制外部访问，请将以下 IP 地址列入许可清单：

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    Google 的出站 IP 范围可能会随时间而变化，因此我们建议您从 Google 发布的列表中读取这些范围，并定期刷新许可清单：

  • 在 Google 一站式管理中心内拥有已注册的开发者账号

    登录后，请确保您在 Google 一站式管理中心内拥有以下“关联的应用”权限之一：

    • 查看关联的应用
    • 创建和管理关联的应用

    此外，账号所有者或管理员还必须接受《关联的应用服务条款》。贵组织首次在 Google 一站式管理中心内访问关联的应用时，账号所有者或管理员必须先登录并接受计划协议，然后受邀团队成员才能继续操作。

    如果您认为自己有权访问，但无法创建关联的应用，请让账号所有者或管理员在用户和权限页面上向您的用户账号授予“查看关联的应用”或“创建和管理关联的应用”权限。

  • 能够在 MCP 服务器网域中托管 .well-known 验证文件

    如需验证网域所有权，您必须能够直接在 https://<your-domain>/.well-known/google-connected-apps（使用 HTTP 200 OK 且不进行重定向）提供 JSON 质询令牌文件。

  • 查看可用的关联应用类别

    关联的应用所属的类别与其应支持的特定功能相关联，以确保提供优质的用户体验。为关联的应用选择类别后，便无法更改。 了解详情。

  • 已部署的 MCP 服务器，且具有有效的端点网址

    如需了解详情，请参阅关联的应用 MCP 服务器开发者指南。

  • 关联的应用的公开元数据和品牌资产

    • 关联的应用名称：关联的应用在各种 Google 产品中向用户显示的名称，也是用户使用 @ 提及您的应用时所用的名称。
    • 说明：用一句话简明扼要地总结（不超过 30 个字词）关联的应用可以为用户做什么，例如“跟踪您最近的购买交易、查看配送状态以及查看您的订单记录”。
    • 图标：JPEG 或 PNG 格式的 512 像素 × 512 像素应用图标，文件大小上限为 1 MB (1,024 KB)。
    • 能力：除了关联的应用所属类别定义的默认能力外，该应用还可以执行至少 3 项高价值任务，例如“搜索订单记录”或“查看实时配送状态”。这些功能将展示给用户，帮助其决定是否关联。请勿在能力开头添加数字。
    • 示例提示：至少 3 个示例查询，帮助用户了解可以询问哪些问题。请在至少 2 个示例提示中以关联应用的名称开头。在至少 1 个提示中自然地提及应用名称（即不以应用名称开头）。请勿在示例提示词开头添加数字。
    • 服务条款网址：关联应用的服务条款的公开网址。
    • 隐私权政策网址：关联应用的隐私权政策的可公开访问网址。
    • 网站网址（可选）：关联应用的网站。