Gemini 应用开发者模式概览

Gemini 应用开发者模式是一个基于 Web 的交互式调试和评估工作区，您可以在其中检查实时工具执行情况、验证架构并模拟用户上下文，然后再提交关联的应用以供审核。

您可以通过以下两种方式将 Model Context Protocol (MCP) 服务器连接到开发者模式，具体取决于您的工作流：

  • 通过 Google 一站式管理中心：如果您在 Google 一站式管理中心内配置 MCP 服务器，则可以在启动开发者模式时，让系统预先选择您已注册的应用。
  • 作为自定义 MCP 应用：如果您想在控制台中注册已部署的 HTTPS MCP 服务器端点之前对其进行原型设计或调试，可以直接在 Gemini 中将服务器作为自定义 MCP 应用进行连接。

Gemini 应用开发者模式可帮助您完成以下任务：

  • 实时检查实时 JSON-RPC 请求和响应载荷、HTTP 状态代码以及执行延迟时间。
  • 验证 Gemini 如何解析 MCP 工具架构、参数限制和安全注解。
  • 模拟用户环境属性（例如日期、时间和语言），并测试客户端身份验证流程。

如需在 Gemini Web 应用中进入 Gemini 应用开发者模式，请执行以下操作：

  1. 在网络浏览器中打开 Gemini 应用。
  2. 点击设置 > Gemini 应用开发者模式（或直接前往 gemini.google.com/devmode）。
  3. 在选择应用对话框中，选择已注册的关联应用（如果尚未预先选择），或点击 + 新建，将 HTTPS MCP 服务器端点作为自定义 MCP 应用进行关联。如需查看完整的设置说明，请参阅启用 Gemini 应用开发者模式。

分屏工作区

在 Gemini 应用中启用 Gemini 应用开发者模式并选择自定义 MCP 应用后，Gemini 会打开一个绑定到服务器端点的分窗格工作区。顶部标题栏会显示活跃应用的名称，并允许您在已连接的自定义应用之间切换。您可以随时通过设置 > Gemini 应用开发者模式重新打开 Gemini 应用开发者模式侧边栏。

Gemini 应用开发者模式的分屏界面，左侧显示 Gemini 对话，右侧显示事件日志检查器，其中展开的 get_summit_info 事件显示 200 OK、执行延迟时间以及格式化的请求和响应 JSON 载荷。
图 1. Gemini 应用开发者模式的分屏工作区，其中显示了 Gemini 对话预览和事件日志检查器。

Gemini 对话预览

左侧窗格模拟 Gemini 客户端体验，以便您测试最终用户如何与关联的应用互动。

检查器和遥测标签页

右侧窗格提供了四个诊断和配置标签页，用于检查和测试 MCP 服务器：

  • 事件日志：按时间顺序显示提示、界面互动、出站 Tool call 请求和入站 Tool result 响应的遥测流。每个事件都会显示 HTTP 状态代码、执行延迟时间（以毫秒为单位）和载荷大小（以千字节为单位）的标记。您可以展开事件，以显示完整的提示文本以及格式化的 JSON-RPC 请求和响应载荷。您可以使用清除和导出来管理会话遥测。
  • 工具架构：列出服务器指令以及服务器的 tools/list 端点返回的所有操作。您可以使用过滤工具过滤工具，查看安全和身份验证标记（只读、破坏性、需要身份验证），并展开任何工具以检查其参数类型、必填字段、说明、原始架构 JSON 和示例响应结构。您还可以点击同步架构，从 MCP 服务器重新提取 tools/list，而无需重置对话记录。
  • 环境：提供模拟上下文控件，用于测试依赖于上下文的工具行为，而无需修改本地机器。您可以替换日期和时间（模拟日期和模拟时间）以及偏好设置（语言），也可以点击重置以恢复默认值。
  • 身份验证：在动态客户端注册下，配置 Gemini 如何与 MCP 服务器建立客户端和用户凭证。
“工具架构”标签页，显示安全徽章、参数限制和响应预览。
图 2. 工具架构标签页，其中显示了安全标志、参数限制和响应预览。

安全注释和工具链

Gemini 会评估您的 MCP 工具注解和活跃对话上下文，以确定何时在执行工具之前提示用户进行确认。在 Gemini 应用开发者模式下进行测试时，您可以验证工具是否声明了适当的 readOnlyHint 和 destructiveHint 注解，并在预期时调用确认卡片。

其他资源