关联的应用可帮助用户在适用的 Google 产品中，通过各种途径访问内容和服务。
关联的应用具有以下优势。
- 控制向 Connected Apps Platform 提供哪些功能和服务：您可以精细控制集成范围。
- 品牌归因和发现：当您选择与应用集成的 Google 平台时，您的品牌会放在醒目的位置。
- 提高互动潜力：关联的应用可帮助用户在需要时访问您的服务以执行操作，从而提高用户互动度和满意度。
集成选项
MCP 服务器和 AppFunctions 是将应用功能集成到适用的 Google 产品中的两种主要互补方式。
MCP 服务器（本开发者指南中介绍的内容）：
- 这是我们建议的基础跨平台功能默认路径。
- MCP 服务器可让您在 Android、iOS 和 Web 平台上进行扩展。如果您有现有的 Web API 或远程 MCP 服务器，则可以利用我们的 MCP 服务器规范来使用它们。这是您以最低开销实现最大覆盖面的途径。
Android MCP（开发者指南）
- AppFunctions 旨在打造更深层次的内置 Android 体验。AppFunctions 可以利用设备端内容，通过与 Android OS 和系统界面深度集成来解析 intent。
- 需要上下文并与应用的当前状态紧密集成的操作。
- 可通过 Jetpack 库获得支持。
端到端流程
本指南概述了构建、测试、注册和部署远程 Model Context Protocol (MCP) 服务器的端到端流程，以便在适用的 Google 产品中集成您的服务。
第 1 阶段：构建 - 开发远程 MCP 服务器
使用模型上下文协议规范开发远程 MCP 服务器时，我们建议您建立结构化系统指令、明确的安全注释、清晰的架构定义和界面元数据绑定。
- 明确的服务器指令：初始化 MCP 服务器时，请定义明确的服务器指令，描述您的领域和功能。由于 AI 模型依赖这些服务器指令来识别何时将任务委托给您的服务器，因此我们强烈建议您提供清晰的服务器指令，以便在适用的 Google 产品中实现准确的模型路由。
- 安全和执行工具注解：为每个工具声明明确的协议注解，例如使用
readOnlyHint=True标记只读查询操作，或使用destructiveHint=True标记状态更改/破坏性操作。您还可以在 Google 一站式管理中心内标记需要确认的操作。 - 强类型架构和语义文档字符串：提供明确的参数类型和详细的参数文档字符串。清楚地记录预期字段值（例如允许的类别过滤条件或位置参数），以优化模型工具调用准确率。
- 界面资源元数据绑定（可选）：通过定义元数据注解（例如
meta={"ui": {"resourceUri": "ui://..."}}），将工具输出直接绑定到自定义界面资源。如果提供，这会指示客户端直接在对话界面中，在安全的沙盒化 iframe 中呈现丰富的品牌化互动式界面 widget。
第 2 阶段：验证 - 使用 MCP Inspector 在本地进行测试
在远程托管服务之前，请在本地沙盒环境中验证工具声明和界面呈现。
- 本地服务器初始化：在开发机器上本地运行远程 MCP 服务器。
- 检查器工具验证：使用 MCP 检查器工具 (
npx @modelcontextprotocol/inspector) 连接到本地服务器。 - 执行和界面验证：调用各个工具，检查原始 JSON 输入/输出载荷，并确认自定义界面资源是否直接在网络浏览器中按预期呈现。
第 3 阶段：使用 Gemini 开发者模式进行部署和测试
您需要将 MCP 服务器部署到公共 HTTPS 端点，以便在 Gemini 开发者模式下远程测试。您可以将其托管在您喜欢的任何云服务提供商或基础架构上。
- 公开 HTTPS 托管：在公开 HTTPS 端点上托管远程 MCP 服务器。如需在 Google Cloud 上托管，请使用
gcloud run deploy <server-name>通过 Google Cloud Run 进行部署。
下一步是在 Gemini 开发者模式中验证您的公共端点。
- 实时 Gemini 验证：使用 Gemini 开发者模式测试实时工具执行。使用内置的调试标签页（包括事件日志、工具架构、环境模拟 [日期、时间、位置] 和身份验证设置）验证模型回答，然后再请求最终批准和发布。
第 4 阶段：注册 - 使用 Google 一站式管理中心进行配置
验证本地执行后，请在 Google 一站式管理中心内提交访问权限申请并注册集成详细信息。