Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

注册、测试和发布关联的应用

满足前提条件后，请按照以下步骤注册、配置、测试和发布关联的应用。

第 1 步：创建关联的应用

如需创建关联的应用，请执行以下操作：

登录 Google 一站式管理中心。
在首页上，选择创建应用。
在选择要创建的内容对话框中：
- 如果系统提示您接受《关联的应用服务条款》，请选择查看条款，查看并接受协议，然后选择创建。只有账号管理员才能接受协议。
- 否则，请在关联的应用卡片中选择创建。
在为关联的应用命名对话框中，输入关联的应用的名称。此名称将用于在各种 Google 产品中显示关联的应用，也是用户使用 @ 提及关联的应用时所用的名称。选择下一步。
在选择关联的应用类别对话框中，从选择类别菜单中选择应用的网域、类别或行业。

注意：关联的应用类别决定了基准功能要求，日后无法更改。如需在日后使用其他类别，您必须创建新的关联应用。
在选择连接类型对话框中，选择以下选项之一：
- MCP 服务器：连接 MCP 服务器，在网页端、Android 和 iOS 平台上为 Gemini 和 Google 搜索用户提供服务。
- Android MCP：将您的设备端功能开放给 Android 版 Gemini，以便它在您的应用中为用户触发操作和完成任务。
详细了解如何设置 Android MCP 关联应用。每个关联应用只能选择一种连接类型，且日后无法更改。
选择创建关联的应用。

系统会打开关联应用的管理概览页面（设置和测试关联的应用），您可以在其中配置应用详细信息、MCP 服务器连接和测试人员。

第 2 步：输入关联的应用的详细信息

如需提供有关关联应用的更多详细信息并配置其向用户显示的方式，请执行以下操作：

在关联应用的概览页面上，在应用详细信息行中，选择开始（如果您要更新现有详细信息，请选择管理）。
在应用详细信息页面顶部，验证关联的应用名称字段。您可以根据需要更新名称。此名称会在各种 Google 产品中向用户显示，并且会在用户使用 @ 提及您的应用时使用。
在公开详细信息部分的图标下，上传您的应用图标（JPG 或 PNG 格式，大小不超过 1 MB，尺寸为 512 像素 × 512 像素）。
填写以下字段：
- 说明：输入简明扼要的单句摘要（不超过 30 个字词），描述关联的应用的主要功能及用途。此文本会向用户显示，不会用作模型指令。
- 功能：输入关联的应用可以执行的至少三项高价值任务。选择添加功能以添加更多条目。请勿在能力开头添加数字。每个条目只能包含一项功能。如果您的类别包含预定义的功能，这些功能会显示在列表顶部，且无法修改。
- 示例提示：输入至少三个示例提示，帮助用户了解他们可以提出哪些问题。选择添加示例提示以添加条目。
  - 请确保至少有两个提示以 @<YourAppName> 开头（例如 @Order Tracker where is my last order?）。
  - 请在至少一个提示中自然地提及 <YourAppName>，而不要以应用名称（例如 Track my recent order on Order Tracker）开头。
  - 请勿添加带编号的前缀（1.、2.、3.），也不要用引号 ("...") 括起提示。
- 多语言本地化：如需提供说明、功能和示例提示的翻译，请在输入字段中将每个语言区域的文本用语言标记括起来。例如：
```
<en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>
```
  一站式管理中心会自动验证您的标签，并在每个字段下方显示检测到的语言区域（例如 Found translations for 2 languages: en-US, es-ES）。
- 服务条款网址：输入指向您的服务条款的有效 https:// 或 http:// 链接。
- 政策网址：输入指向您隐私权政策的有效 https:// 或 http:// 链接。
- 网站网址（可选）：输入指向您网站的链接，以便进行归因。
选择页面底部的保存，返回到概览页面。

第 3 步：输入 MCP 端点并验证域名所有权

在 Google 连接到您的 MCP 服务器或同步您的工具之前，您必须提供 MCP 服务器端点网址，并验证您拥有托管该服务器的网域。

如需输入 MCP 端点并验证域名所有权，请执行以下操作：

在已关联应用的概览页面上，在 MCP 和工具设置卡片中，选择开始（如果您要更新现有详细信息，请选择管理）。系统随即会打开 MCP 设置流程的第 1 步（MCP 服务器端点）。
在已连接 MCP 服务器端点下，输入 MCP 服务器端点的完整 HTTPS 网址（例如 https://api.yourdomain.com/v1/mcp）。
在验证您的网域下，完成网域的验证令牌验证（如果您已在开发者账号中验证了该网域或其父网域，则该网域会自动显示为已验证）：
1. 在验证域名所有权卡片中，选择下载令牌。浏览器会下载一个名为 google-connected-apps.json 的文件，其结构如下：
```
{
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}
```
2. 在您的服务器上上传并托管此 JSON 内容，网址为 https://<your-domain>/.well-known/google-connected-apps。
  - 确保该端点可通过 HTTPS 公开访问，直接返回 HTTP 200 OK（不进行 HTTP 重定向），并在 verification_tokens 数组中包含您的令牌。
3. 返回 Google 一站式管理中心，然后选择验证网域。
4. 验证成功后，已使用质询令牌验证域名行会显示一个绿色对勾标记，并解锁其下方的访问凭据部分。

第 4 步：配置访问凭证

验证域名后，请配置 Google 如何向 MCP 服务器进行身份验证，并提取服务器的工具定义。

如需配置访问凭证，请执行以下操作：

在提供访问凭证部分（MCP 和工具设置页面的第 1 步），选择开始（或选择更新凭证以修改现有配置）。
在您的服务器是否需要授权？下，选择以下选项之一：
- 否：如果您的 MCP 服务器无需身份验证即可公开访问，请选择此选项，然后选择确认。
- 是：如果您的 MCP 服务器公开的任何工具需要授权，请选择此选项。然后，在选择 MCP 服务器使用的授权模型下，选择您的身份验证流程：
  - 机器对机器（OAuth 客户端凭证）：选择此选项可进行服务间身份验证 (RFC 6749)，即 Google 使用共享客户端 ID 和 Secret 直接与您的 MCP 服务器通信，而无需最终用户登录重定向：
    1. 输入客户端 ID（必填）和客户端密钥（可选）。
    2. 如果您的服务器未使用 /.well-known/oauth-authorization-server 通告授权端点（可选）和令牌端点（可选），请视需要输入这些信息。
    3. 选择注册客户端（或更新客户端）。
  - 用户委托（授权代码）：如果 MCP 服务器要求用户通过 Google 账号关联登录其个人账号并授权操作，请选择此选项：
    1. 将 Google 的 OAuth 重定向 URI 列入许可清单：在确保您已将提供的重定向 URI 列入许可清单横幅中，选择查看（或选择复制图标），以检查为关联的应用生成的具体应用专用重定向 URI。将这些 URI 添加到 OAuth 服务器的许可清单中，然后返回 Google 一站式管理中心。
    2. 在选择 Google 应如何向您的 OAuth 服务器进行身份验证下，选择 OAuth 客户端的注册方式：
      - 预注册：如果您在 OAuth 提供程序中生成静态客户端 ID 和客户端密钥（可选），请选择此选项。您还可以选择提供自定义授权端点（可选）和自定义令牌端点（可选）。
      - 客户端 ID 元数据或动态客户端注册（推荐）：如果您的服务器支持 OAuth 客户端 ID 元数据文档 (CIMD) 或动态客户端注册 (RFC 7591)，请选择此选项。Google 会先检查 CIMD，然后使用您的 .well-known 发现端点回退到 DCR。您还可以选择指定自定义授权和令牌端点。
    3. 在使用开发者凭证进行身份验证下，由于您已选择“用户委托”作为授权模型，因此您需要先登录服务器，然后 Google 才能提取工具。您可以选择以下选项之一：
      - 通过弹出式窗口进行身份验证（推荐）：在叠加对话框中触发身份验证流程。这是默认体验。
      - 通过重定向进行身份验证（备用）：在同一标签页或窗口中使用全屏重定向打开身份验证流程。如果对话框因显示限制或安全标头（例如 X-Frame-Options 或 Content-Security-Policy）而无法呈现，请使用此选项。
      我们建议您先尝试使用对话框进行身份验证。如果您无法使用对话框进行身份验证，请使用重定向方法。您的选择还决定了用户首次使用关联应用时的登录体验。
    4. 选择注册客户端（或更新客户端）。
注意：如果您选择“用户委托”作为授权模型，则只有在我们提取工具时，系统才会要求您进行身份验证。如果您的开发者账号中的其他账号正在处理关联的应用，则需要先进行身份验证，然后才能重新同步工具。

第 5 步：提供测试账号详细信息（仅适用于用户委托授权）

如果您的关联应用需要进行身份验证，您必须提供预先填充了真实示例数据且停用了双重身份验证 (2FA) 的种子测试凭据，以及测试说明，并将其发送给您的 Google 代表。这样，Google 的审核和质量保证团队就可以验证工具执行情况，而不会被空沙盒、付费墙或 2FA 验证所阻碍。如果 Google 无法全面测试您的关联应用，该应用可能会在审核期间被拒。

第 6 步：同步工具

为了创建关联应用的每个版本，Google 会与您提供的端点同步，以获取可用工具并创建快照。这些是该版本中可供用户使用的工具。当关联的应用版本处于预览状态并可供测试人员使用时，您可以继续在服务器上进行更改，并重新同步工具以进行更新。这会为您的工具创建一个新快照

发布时，系统会使用工具的最新快照来创建关联应用的该版本。您将无法再更改工具、说明或服务器详细信息。如需更新工具或同步服务器中的任何修改，请创建新的关联应用版本。我们建议您为关联应用的每个版本创建一个新端点。

如需同步工具，请执行以下操作：

在同步工具部分中：
1. 选择同步工具。
2. 如果系统提示您登录，请使用有权列出您打算向用户公开的所有工具的开发者账号进行身份验证。您的账号无法访问的任何工具都不会同步。
3. 连接后，一站式管理中心会显示已同步的工具数量，以及重新同步工具按钮。
注意：如果一站式管理中心在同步卡片下方显示必须修复错误卡片或连接错误（例如缺少 /.well-known/ 发现文件、界面资源 MIME 类型不受支持或界面资源大小累计超出限制），请先解决相应问题，然后再继续。如需了解解决方案，请参阅排查注册问题。
选择页面底部的下一步，进入 MCP 和工具设置的第 2 步。

第 7 步：确定用户体验应用的方式和位置

在 MCP 和工具设置页面的工具部分中，配置基本参数，例如关联的应用在哪些地理位置可用、其语言以及您希望在哪些 Google 产品中提供该应用。

在可用性下，在在以下位置提供版本旁边，配置以下定位选项：
- 国家/地区：选择关联应用应面向的地理位置。
- 语言：选择关联应用支持的语言。
- 产品：选择要在哪些 Google 产品中提供关联的应用。
在可用性后面的工具部分中，查看从 MCP 服务器同步的工具。在工具列表中选择任意工具，即可在右侧的管理工具面板中配置其设置：
- 启用工具：切换启用工具开关，以在关联的应用中添加或排除该工具。停用的工具将无法在关联的应用中供用户互动。
- 其他背景信息：选择您的工具是否需要 Google 提供的情境信号才能运行：
  - 语言区域：根据用户的 Google 账号设置确定的语言区域。
  - 大致位置：用户或设备的大致物理位置，误差范围大于或等于 3 平方公里（例如，用户所在的城市）。
  - 精确位置：用户或设备的精确物理位置，误差不超过 50 米。
  注意：除非有明确的要求和目的，否则不应请求提供更多背景信息。如果工具请求的上下文超出所需范围，关联的应用可能无法通过审核。
- 用户确认：选择需要用户确认，以便在执行工具之前要求用户明确确认（如果工具的 MCP 注解指定了 destructiveHint: true，系统会自动预先选择此选项）。
如果您的 MCP 服务器提供界面资源，请切换到工具旁边的界面资源标签页，以检查服务器的界面资源（text/html、text/html;profile=mcp-app、text/javascript、text/css），验证哪些工具与每个资源相关联，并查看内容安全政策 (CSP) connectDomains 和 resourceDomains。

注意：适用于关联应用的 MCP 应用目前处于 Beta 版阶段，可能无法使用。如果检测到服务器上存在界面资源，系统可能会忽略这些资源。
选择页面底部的保存。

保存应用详细信息以及 MCP 和工具设置后，您添加的所有测试人员都可以自动预览您的配置，并且概览页面上的版本状态会更新为可供测试人员使用。

第 8 步：测试关联的应用

如需让测试人员能够使用您的关联应用，您必须在“管理测试人员”界面中添加测试人员。只有您添加到测试人员名单中的用户才能看到您未发布的关联应用并与之互动。您只能添加拥有 @gmail.com 账号的测试人员。

在关联应用的概览页面上，在测试您的应用卡片中，选择添加测试人员（如果您已添加一些测试人员，请选择管理测试人员）。
在管理测试人员界面上，选择现有邮箱名单，或选择创建邮箱名单，以添加有权测试集成的 Google 账号。如果您希望亲自测试应用，请务必添加自己的邮箱。
选择保存。

注意：添加测试人员后，最长可能需要 10 分钟，这些账号才能看到关联的应用。
Gemini 应用中的测试人员可以通过输入 @，后跟关联应用的名称，然后从菜单中选择该应用，来调用关联的应用。您也可以在 Gemini 中查看和关联应用，方法是前往左侧导航栏中的设置和帮助 → 关联的应用。
我们建议您全面测试集成：
- 试用所有示例提示。
- 测试显式 @<AppName> 调用和自然语言查询。
- 验证端到端身份验证流程、工具执行、用户确认提示以及所有界面资源。
注意：您还可以在 Gemini 应用开发者模式下调试关联的应用，在该模式下，您可以交互式测试 Model Context Protocol (MCP) 服务器、诊断架构或运行时错误，以及在 Google 一站式管理中心提交关联的应用以供审核之前，对工具质量进行基准测试。如需了解详情，请参阅 Gemini 应用开发者模式概览以及在 Gemini 应用开发者模式下测试、调试和评估。确保你已使用账号登录 Gemini。

如果您对测试结果感到满意，就可以将关联的应用提交给 Google 进行审核。

第 9 步：发起对关联应用的审核，并在获得批准后发布

在关联的应用可供所有用户使用之前，Google 会审核并测试您的集成。

若要将关联的应用送审，请执行以下操作：

在关联的应用的概览页面上，在页面右侧的版本卡片中，选择送审（在应用配置完成且处于预览状态且没有阻碍性问题后启用）。
在您的版本接受审核期间：
- 一站式管理中心会自动创建一个新的可编辑草稿版本，以便测试人员可以继续预览您的应用，您也可以准备未来的修改，而不会中断审核。
- 锁定对审核中版本的任何更改。
- 如需查看审核中版本的只读详细信息或取消审核，请选择审核中卡片上的“更多选项”(⋮) 按钮，然后选择查看应用详细信息或取消审核。
Google 完成审核后，您会收到通知，并且版本卡片会更新：
- 如果发现问题：版本卡片会显示发现问题。选择查看问题，检查具体的审核结果。在可修改的预览版本中更新配置或 MCP 服务器，与测试人员一起验证修复效果，然后再次选择送审。
- 如果获得批准：版本卡片会显示可以发布。准备好向用户发布关联的应用后，请选择发布。

恭喜！您的关联应用现已发布，并正在向您所选 Google 产品中的用户推出。

发布后和持续版本管理

发布后，发布版本下的底部卡片会显示已发布，以及关联应用的线上版本号、发布日期，以及目标国家/地区、语言和商品的数量。您可以随时选择已发布卡片上的“更多选项”(⋮) 菜单，然后选择查看应用详情，以检查正式版版本的只读配置。

在已发布版本仍处于正式版状态时，您可以使用左侧的修改和测试关联的应用面板（如果没有草稿，请选择创建新版本），在新版本 (Version <N+1>) 中独立配置、预览和测试更新，然后再将其送审和发布。