在 Google 一站式管理中心提交关联的应用以供审核之前，请使用 Gemini 应用开发者模式以交互方式测试 Model Context Protocol (MCP) 服务器、诊断架构或运行时错误，并对工具质量进行基准测试。
本指南包含以下任务：
- 在 Gemini 中启用 Gemini 应用开发者模式，创建自定义 MCP 应用，并验证初始工具发现。
- 调试失败的工具调用、同步更新后的架构，以及测试身份验证。
- 模拟用户环境上下文并配置客户端身份验证。
如需了解工作区布局和检查器标签页，请参阅 Gemini 应用开发者模式概览。
启用 Gemini 应用开发者模式
如果您在 Google 一站式管理中心内配置 MCP 服务器，则在启用 Gemini 应用开发者模式后，您注册的应用便已可用，您可以跳过第 2 步。如果您想在控制台中注册已部署的 HTTPS MCP 服务器端点之前直接在 Gemini 中对其进行测试，请按照以下两个步骤启用 Gemini 应用开发者模式，并将您的服务器作为自定义 MCP 应用进行连接。
第 1 步：启用 Gemini 应用开发者模式
- 在网络浏览器中打开 Gemini。
- 点击设置 > Gemini 应用开发者模式（或直接前往 gemini.google.com/devmode）。
（可选）第 2 步：创建并测试自定义 MCP 应用
如需在 Gemini 应用开发者模式下将 MCP 服务器关联为自定义应用，请执行以下操作：
- 在选择应用对话框中，点击 + 新建。
- 在连接到 MCP 服务器对话框中，在 MCP 服务器网址中输入服务器的公共 HTTPS 端点（确保网址以
https://开头，例如https://your-app-link.com/mcp）。 - 如果您的服务器需要预注册的 OAuth 凭据，请点击其他设置 > 显示更多，输入您的 OAuth 客户端 ID 和客户端密钥，然后点击下一步。
- 在安全和隐私确认对话框中，查看 Gemini 如何与您的自定义 MCP 服务器交互：
- 工具执行：Gemini 会执行 MCP 服务器的工具，以触发并运行可用函数来处理您的请求。
- 数据检索和共享：Gemini 会检索和管理 MCP 服务器端点提供的资源、架构和上下文，并可能会根据你的 Google 账号设置或在与其他关联的应用互动时，分享其有权访问的信息。
- 信任和断开连接：请确保你信任 MCP 服务器，并在继续操作之前查看其隐私权政策。您可以随时在“关联的应用”页面中解除与服务器的关联，也可以从您的 Google 账号关联中删除此服务器的链接。
- 选择我了解并接受关联此自定义应用所带来的安全和隐私风险。然后，点击关联。
- 在保存自定义应用对话框中，输入自定义应用的显示名称，验证服务器的工具是否显示在可用操作列表中，然后点击连接。
- 在 Gemini 应用开发者模式侧边栏中，选择工具架构标签页，查看关联应用中每个工具的相关信息，包括参数定义、安全标记（只读、破坏性、需要身份验证）、原始架构和回答结构。
- 在左侧对话窗格中，输入自然语言或
@mention提示（例如@MyApp show my profile），并监控事件日志标签页，了解工具的运行情况。
调试工具调用
当工具调用失败或生成意外参数时，您可以检查诊断遥测数据、更新后端 MCP 服务器，并热重载架构，而无需清除对话记录。
如需调试失败的工具调用，请执行以下操作：
- 在右侧窗格中，选择事件日志标签页。
- 点击遥测列表中的失败事件，展开其详细信息并检查
Tool call请求载荷和Tool result响应：- 连接和网络连接错误：检查出错提示和延迟时间，以验证您的端点是否可访问。
- 身份验证错误：如果事件返回
401或403，请在身份验证标签页中验证您的 OAuth 令牌状态或客户端凭证。 - 架构验证不匹配：如果服务器返回 MCP 无效参数错误 (
-32602)，请将Tool call中模型生成的 JSON 实参，与工具架构标签页中的参数类型、必需属性和格式说明进行比较。 - 服务器运行时异常：检查
Tool result中的 JSON-RPC 错误代码和消息，以诊断后端异常。
- 如需解决此问题，请更新 MCP 服务器实现，或优化工具和参数说明。如需了解如何编写清晰的工具架构和错误响应，请参阅 MCP 关联应用集成标准。
- 在工具架构标签页中，点击同步架构。Gemini 会从 MCP 服务器重新提取
tools/list，并更新有效的工具定义，同时保留当前对话串。 - 请重试您的查询。在事件日志标签页中，确认重放的工具调用返回
200 OK，并在对话预览中呈现预期回答。
模拟环境上下文和身份验证
您可以直接在检查器窗格中测试 MCP 工具如何响应不同的用户位置、时区、语言区域和身份验证方法。
替换环境上下文
如需为对日期、时间或语言区域敏感的工具模拟用户上下文，请执行以下操作：
- 在右侧窗格中，选择环境标签页。
- 在日期和时间下，选择模拟日期和模拟时间，以测试相对时间表达式（例如“明天早上”或“本周六下午”）。
- 在偏好设置下，选择语言以模拟用户语言区域（例如
en-US）。 - 在对话窗格中运行测试提示，以使用模拟上下文评估工具。
- 如需恢复默认环境设置，请点击重置。
配置客户端身份验证
如需配置或切换 Gemini 应用开发者模式会话期间使用的身份验证方法，请执行以下操作：
- 在右侧窗格中，选择身份验证标签页。
- 在客户端身份验证配置下，选择以下身份验证模式之一：
- 动态客户端注册：使用 OAuth 流程自动与授权服务器协商凭证。如需了解详情，请参阅 OAuth 2.1 实现指南。如果适用，请在添加自定义应用链接中输入您的端点。
- 手动客户端注册：让您能够手动提供预注册的客户端 ID 和客户端密钥。展开高级设置以配置其他流替换。
- 点击保存，然后等待已保存消息出现。然后，运行测试提示，验证经过身份验证的工具是否成功。