使用 MCP 将 Gemini Cloud Assist 与第三方工具集成

借助 Model Context Protocol (MCP)，您可以将 Gemini Cloud Assist 和 App Design Center 的智能体功能直接集成到 Antigravity、Gemini CLI 和 Cursor 等第三方工具中。此集成可将云运营专业知识和架构帮助引入您现有的开发工作流程。如需了解详情，请参阅为 AI 应用配置 MCP。

Gemini Cloud Assist MCP 工具

Gemini Cloud Assist 是一种智能体，可通过一组 MCP 工具以“智能体即工具”模式访问。与提取数据或执行程序处理的工具不同，Gemini Cloud Assist 工具可公开 Gemini Cloud Assist 或特定工作流的所有 agentic 功能。由 MCP 工具调用触发的智能体会在内部向Google Cloud发出自己的工具调用。以下 MCP 工具已发布，可供智能体使用：

  • ask_cloud_assist：这是 Google Cloud帮助和 Gemini Cloud Assist 代理的主接口。您可以通过此工具访问 Gemini Cloud Assist 的所有功能，并且此工具涵盖了其他 MCP 工具的功能。
  • design_infra：此功能支持在 Google Cloud上设计和构建基础架构的工作流。它可与 App Design Center MCP 服务器工具搭配使用，以管理基础设施设计生命周期，例如运行和修正安全发现，或部署和修正问题。
  • investigate_issue：这支持Google Cloud中的问题排查工作流。它可以通过调查资源进行快速问题排查或更深入的问题排查。
  • invoke_operation：此功能支持在 Google Cloud中创建、更新和删除资源的工作流。只有在启用代理操作时，此工具才能正常运行。Gemini Cloud Assist 中的写入操作只能通过调用此工具来执行。
  • optimize_costs：这支持用于分析、跟踪和优化 Google Cloud 费用的工作流程。它会详细分析支出，并通过查找空闲或未充分利用的资源来发现提高成本效益的机会。

App Design Center MCP 工具

这些工具通常由 Gemini Cloud Assist 的 design_infra 工具编排，使用 App Design Center 管理基础架构应用生命周期，包括模板管理、安全合规性和补救以及部署。这些工具包括：

  • setup_adc：初始化 App Design Center 环境。 这是一次性设置步骤，必须先执行此步骤，然后才能使用其他 App Design Center 工具。
  • manage_application：管理应用的部署生命周期。 您可以使用此工具通过 App Design Center 部署已验证的设计，或检索现有部署的状态和详细信息。这是将设计转化为 Google Cloud上已部署的基础设施的最后一步。
  • manage_application_template：管理基础架构设计的“基础设施即代码”(IaC) 内容。使用此按钮可将设计另存为 App Design Center 模板、将设计导出为 Terraform 文件或更新设计。例如，您可以使用此工具通过修改组件设置和形参配置来更新设计。
  • assess_best_practices：在部署之前，对应用设计进行全面的安全性和配置审核。它会根据 Security Command Center 框架和相关控制措施验证设计，并返回一份包含可用于补救的可操作发现结果的报告。
  • list_application_templates：列出所有可用的应用设计。

不应将这些 MCP 工具视为稳定的 API，也不应通过程序化 API 客户端对其进行配置。此列表中的工具或其参数可能会随着时间的推移而重命名、重新定义、移除或添加，以适应 Gemini Cloud Assist 不断发展的功能。Gemini Cloud Assist 的功能将保持稳定，以便客户端代理能够始终如一地执行相同的任务，但代理通过这些工具与 Gemini Cloud Assist 进行互动和调用 Gemini Cloud Assist 的方式会随时间而变化。

准备工作

  1. 授予访问权限：如需使用 MCP，您需要获得包含 mcp.googleapis.com/tools.call 权限的 Identity and Access Management 角色，例如以下 Gemini Cloud Assist 角色之一：

    • roles/geminicloudassist.user
    • roles/geminicloudassist.editor
    • roles/geminicloudassist.admin

  2. 如果您尚未安装 gcloud CLI 及其Beta 版组件，请进行安装。

  3. 使用以下命令在项目中启用 MCP 服务：

    gcloud beta services mcp enable geminicloudassist.googleapis.com \
    --project=PROJECT_ID

    将 PROJECT_ID 替换为您的 Google Cloud 项目 ID。

  4. 运行以下命令，使用应用默认凭证进行身份验证：

    gcloud auth application-default login

为客户配置 MCP

客户端-代理配置取决于您使用的代理。以下部分提供了针对不同客户端配置 MCP 的说明。

如需启用完整的设计到部署工作流，您必须将客户端配置为同时连接到 Gemini Cloud Assist 和 App Design Center MCP 服务器，并包含相关的 SKILL.md 文件。以下代码段显示了合并后的配置。

Antigravity

如需将 Gemini Cloud Assist 和 App Design Center 远程 MCP 服务器添加到 Antigravity，请按照 Antigravity 编辑器：MCP 集成中的说明操作，或完成以下步骤：

  1. 安装扩展程序。

    在 Antigravity 中，打开扩展程序市场。 搜索 Gemini Cloud Assist 扩展程序，点击安装，然后点击刷新。

  2. 手动配置 MCP 服务器。

    打开管理 MCP 服务器 窗格，然后点击查看原始配置以修改 mcp_config.json 文件。添加或合并以下配置块。此设置使用您的应用默认凭据进行身份验证。

    {
  "mcpServers": {
    "gemini_cloud_assist": {
      "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
      "headers": {},
      "authProviderType": "google_credentials"
    },
    "application_design_center": {
      "serverUrl": "https://designcenter.googleapis.com/mcp",
      "headers": {},
      "authProviderType": "google_credentials"
    }
  }
}

  3. 验证您的设置。

    修改 mcp_config.json 和 SKILL.md 文件后，重启 Antigravity。在代理窗格中，运行以下斜杠命令来验证连接：

    • /skills list：验证本地技能是否已被发现。
    • /mcp list：验证 Gemini Cloud Assist 和 App Design Center MCP 服务器是否已连接。

ChatGPT

您必须拥有 ChatGPT Business 订阅，才能将 Google 和 Google Cloud MCP 服务器与 ChatGPT 搭配使用。

如需将 Gemini Cloud Assist 和 App Design Center 远程 MCP 服务器添加到 ChatGPT，请创建 OAuth 2.0 客户端 ID 和客户端密钥，然后将 MCP 服务器添加为 ChatGPT 中的插件：

  1. 创建 OAuth 2.0 客户端 ID 和客户端密钥：

    1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的 JavaScript 来源 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://chatgpt.com。

    5. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://chatgpt.com/connector_platform_oauth_redirect。

    6. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    7. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的位置。您只能复制一次。如果丢失，请删除该密钥并创建一个新密钥。

  2. 登录 ChatGPT，并开启开发者模式。

  3. 按照构建插件中的说明，为每个 MCP 服务器添加自定义连接器：

    • 对于 Gemini Cloud Assist，请将服务器网址设置为 https://geminicloudassist.googleapis.com/mcp。
    • 对于 App Design Center，请将服务器网址设置为 https://designcenter.googleapis.com/mcp。

  4. 在“OAuth”或高级设置下，输入您的 OAuth 客户端 ID 和客户端密钥。

  5. 完成登录提示，以在对话中启用 MCP 服务器。

Claude.ai

如需将 Gemini Cloud Assist 和 App Design Center 远程 MCP 服务器添加到 Claude.ai，请使用 OAuth 2.0 客户端 ID 和客户端密钥配置自定义连接器：

  1. 创建 OAuth 2.0 客户端 ID 和客户端密钥：

    1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的 JavaScript 来源 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://claude.ai。

    5. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://claude.ai/api/mcp/auth_callback。

    6. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    7. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的位置。您只能复制一次。如果丢失，请删除该密钥并创建一个新密钥。

  2. 按照说明为每个 MCP 服务器创建自定义连接器：

    • 对于 Gemini Cloud Assist，请将服务器网址设置为 https://geminicloudassist.googleapis.com/mcp。
    • 对于 App Design Center，请将服务器网址设置为 https://designcenter.googleapis.com/mcp。

  3. 在高级设置菜单中，输入您的 OAuth 客户端 ID 和客户端密钥。

  4. 完成登录提示，以在对话中启用 MCP 服务器。

Claude Code

如需将 Gemini Cloud Assist 和 App Design Center 远程 MCP 服务器添加到 Claude Code，请使用 OAuth 2.0 客户端 ID 和客户端密钥配置自定义连接器：

  1. 安装 Claude Code。

  2. 创建 OAuth 2.0 客户端 ID 和客户端密钥：

    1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://claude.ai/api/mcp/auth_callback。

    5. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    6. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的位置。您只能复制一次。如果丢失，请删除该密钥并创建一个新密钥。

  3. 按照说明为每个 MCP 服务器创建自定义连接器：

    • 对于 Gemini Cloud Assist，请将服务器网址设置为 https://geminicloudassist.googleapis.com/mcp。
    • 对于 App Design Center，请将服务器网址设置为 https://designcenter.googleapis.com/mcp。

  4. 在高级设置菜单中，输入您的 OAuth 客户端 ID 和客户端密钥。

  5. 完成登录提示，以在对话中启用 MCP 服务器。

Claude Desktop

如需将 Gemini Cloud Assist 和 App Design Center 远程 MCP 服务器添加到 Claude Desktop，请使用 OAuth 2.0 客户端 ID 和客户端密钥配置自定义连接器：

  1. 安装 Claude Desktop。

  2. 创建 OAuth 2.0 客户端 ID 和客户端密钥：

    1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://claude.ai/api/mcp/auth_callback。

    5. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    6. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的位置。您只能复制一次。如果丢失，请删除该密钥并创建一个新密钥。

  3. 按照说明为每个 MCP 服务器创建自定义连接器：

    • 对于 Gemini Cloud Assist，请将服务器网址设置为 https://geminicloudassist.googleapis.com/mcp。
    • 对于 App Design Center，请将服务器网址设置为 https://designcenter.googleapis.com/mcp。

  4. 在高级设置菜单中，输入您的 OAuth 客户端 ID 和客户端密钥。

  5. 完成登录提示，以在对话中启用 MCP 服务器。

Codex

如需将 Gemini Cloud Assist 和 App Design Center 远程 MCP 服务器添加到 Codex Enterprise，请完成以下步骤：

  1. 在 Codex Enterprise 界面中，打开设置，选择 MCP 服务器，然后点击查看原始配置以打开 mcp_config.json 编辑器。

  2. 将以下配置块添加到 mcp_config.json 文件中或将其合并到该文件中。此设置使用您的应用默认凭据进行身份验证。

    {
  "mcpServers": {
    "gemini_cloud_assist": {
      "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
      "headers": {},
      "authProviderType": "google_credentials"
    },
    "application_design_center": {
      "serverUrl": "https://designcenter.googleapis.com/mcp",
      "headers": {},
      "authProviderType": "google_credentials"
    }
  }
}

光标

如需将 Gemini Cloud Assist 和 App Design Center 远程 MCP 服务器添加到 Cursor，请创建 OAuth 2.0 客户端 ID 和客户端密钥，然后使用静态 OAuth 配置 MCP 服务器。Cursor 使用不同的重定向 URI，具体取决于您是通过网页还是桌面应用访问 Cursor：

  1. 创建 OAuth 2.0 客户端 ID 和客户端密钥：

    Web 或 Cursor 智能体

    1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://www.cursor.com/agents/mcp/oauth/callback。

    5. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    6. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的位置。您只能复制一次。如果丢失，请删除该密钥并创建一个新密钥。

    桌面设备

    1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 http://localhost:8787/callback。

    5. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    6. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的位置。您只能复制一次。如果丢失，请删除该密钥并创建一个新密钥。

  2. 按照说明使用静态 OAuth 配置 MCP 服务器，然后将以下配置块添加到 Cursor MCP 配置中或将其合并到其中：

    {
  "mcpServers": {
    "gemini_cloud_assist": {
      "url": "https://geminicloudassist.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

  3. 在您的环境中设置 OAUTH_CLIENT_ID 和 OAUTH_CLIENT_SECRET 环境变量。

  4. 在 Chat 中使用 MCP 服务器。

Gemini CLI

使用扩展程序进行配置

使用以下命令将 MCP 服务器安装为 Gemini CLI 扩展程序：

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

手动配置

  1. 配置 MCP 服务器设置。

    打开 Gemini CLI 用户范围设置文件 (~/.gemini/settings.json) 或工作区范围设置文件 (.gemini/settings.json)。如果该文件不存在，请创建它。在 mcpServers 键下添加或合并以下配置块。确保文件采用有效的 JSON 格式。此配置会自动使用您的应用默认凭据。

    {
  "mcpServers": {
    "gemini_cloud_assist": {
      "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      },
      "timeout": 600000
    },
    "application_design_center": {
      "httpUrl": "https://designcenter.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      },
      "timeout": 600000
    }
  }
}

  2. 创建并填充技能文件。

    在以下某个目录中创建一个 SKILL.md 文件。将本文档的技能参考部分中您所选技能的 Markdown 内容复制并粘贴到该文件中。

    • 工作区范围： .gemini/skills/SKILL_NAME/
    • 用户范围： ~/.gemini/skills/SKILL_NAME/

    将 SKILL_NAME 替换为技能的目录名称。

    以下是一个目录结构示例：

    .gemini/
└── skills/
    ├── design-and-deploy/
    │   └── SKILL.md
    └── google-gemini-cloud-assist/
        └── SKILL.md

  3. 验证您的技能。

    修改 settings.json 和 SKILL.md 文件后，重启 Gemini CLI，然后运行以下命令来验证设置：

    • /skills list：验证本地技能是否已被发现。
    • /mcp list：验证 Gemini Cloud Assist 和 App Design Center MCP 服务器是否已连接。

Gemini Enterprise

如需在 Gemini Enterprise 中注册 Gemini Cloud Assist 和 App Design Center 远程 MCP 服务器，管理员必须完成以下步骤：

  1. 使用 Gemini Enterprise 重定向 URI 创建 OAuth 2.0 客户端 ID 和客户端密钥：

    1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://vertexaisearch.cloud.google.com/oauth-redirect。

    5. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    6. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的位置。您只能复制一次。如果丢失，请删除该密钥并创建一个新密钥。

  2. 在 Google Cloud 控制台中，依次前往 Gemini Enterprise > 数据存储区，然后点击创建数据存储区。如需了解详情，请参阅设置自定义 MCP 服务器数据存储区。

  3. 选择自定义 MCP 服务器作为数据源。

  4. 为每个端点配置自定义 MCP 服务器数据存储区：

    • 对于 Gemini Cloud Assist，请输入 https://geminicloudassist.googleapis.com/mcp。
    • 对于 App Design Center，输入 https://designcenter.googleapis.com/mcp。

  5. 输入 OAuth 客户端 ID 和客户端密钥，然后保存数据存储区。这些工具将可供 Gemini Enterprise 智能体使用。

Gemini Cloud Assist 技能

Gemini Cloud Assist 和 App Design Center MCP 工具使用智能体 skill 来指示智能体。该技能可引导代理执行以下任务：

  • 将多个工具串联成一个工作流。
  • 处理相关的本地信息（例如 Terraform 部署代码），以便根据本地上下文进行推理。
  • 当您直接引用技能时，响应明确的调用。

使用 Antigravity 或 Gemini CLI 等交互式代理时，您可以将 Gemini Cloud Assist MCP 工具与其他代理和工作流集成。由于这些工具提供广泛的功能，可能与您现有的专用工具重叠，因此请使用以下策略针对您的特定环境和使用情形进行优化：

  1. 自定义技能定义：更新 SKILL.md 文件，以指定您希望调用 Gemini Cloud Assist 的意图和应用场景。这样可确保仅在需要智能体提供广泛的云专业知识的任务中触发智能体。
  2. 明确调用技能：许多交互式代理允许您控制技能的触发时间。如果您的代理支持，您可以配置技能，使其需要使用斜杠命令 (/) 或提及 (@) 手动调用。借助此方法，您可以精确选择何时使用 Gemini Cloud Assist，而不是其他专用工具。

Gemini Cloud Assist 技能参考

我们建议在配置了 Gemini Cloud Assist MCP 工具的任何代理上使用以下 SKILL.md 文件。此文件会指导智能体如何正确使用工具。

后续步骤