使用 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 或特定工作流程的代理功能。MCP 工具呼叫所叫用的代理會在內部發出自己的工具呼叫至Google Cloud。下列 MCP 工具會發布供代理使用：

  • ask_cloud_assist：這是主要介面，可提供輔助和 Gemini Cloud Assist 代理程式。 Google Cloud透過這項工具，您可以使用 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 互動及叫用工具的方式，會隨著時間而改變。

事前準備

  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 使用 Google 和 Google Cloud MCP 伺服器，必須訂閱 ChatGPT Business。

如要將 Gemini Cloud Assist 和 App Design Center 遠端 MCP 伺服器新增至 ChatGPT，請建立 OAuth 2.0 用戶端 ID 和用戶端密鑰，然後在 ChatGPT 中將 MCP 伺服器新增為外掛程式：

  1. 建立 OAuth 2.0 用戶端 ID 和用戶端密鑰：

    1. 在 Google Cloud 控制台中，依序前往「Google Auth Platform」>「Clients」>「Create client」。

      前往「建立用戶端」

      如果沒有選取專案，系統會提示您建立專案。

    2. 在「應用程式類型」清單中，選取「網頁應用程式」。

    3. 在「Name」(名稱) 欄位中，輸入應用程式的名稱。

    4. 在「已授權的 JavaScript 來源」部分，按一下「+ 新增 URI」，然後在「URI」欄位中輸入 https://chatgpt.com。

    5. 在「已授權的重新導向 URI」部分，點按「+ 新增 URI」，然後在「URI」欄位中輸入 https://chatgpt.com/connector_platform_oauth_redirect。

    6. 點選「建立」。已建立用戶端。

      「已建立 OAuth 2.0 用戶端」對話方塊隨即開啟。

    7. 在「Client secrets」部分，複製「Client secret」並儲存在安全的位置。你只能複製一次。如果遺失，請刪除密鑰並建立新的密鑰。

  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」>「Clients」>「Create client」。

      前往「建立用戶端」

      如果沒有選取專案，系統會提示您建立專案。

    2. 在「應用程式類型」清單中，選取「網頁應用程式」。

    3. 在「Name」(名稱) 欄位中，輸入應用程式的名稱。

    4. 在「已授權的 JavaScript 來源」部分，按一下「+ 新增 URI」，然後在「URI」欄位中輸入 https://claude.ai。

    5. 在「已授權的重新導向 URI」部分，點按「+ 新增 URI」，然後在「URI」欄位中輸入 https://claude.ai/api/mcp/auth_callback。

    6. 點選「建立」。已建立用戶端。

      「已建立 OAuth 2.0 用戶端」對話方塊隨即開啟。

    7. 在「Client secrets」部分，複製「Client secret」並儲存在安全的位置。你只能複製一次。如果遺失，請刪除密鑰並建立新的密鑰。

  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」>「Clients」>「Create client」。

      前往「建立用戶端」

      如果沒有選取專案，系統會提示您建立專案。

    2. 在「應用程式類型」清單中，選取「網頁應用程式」。

    3. 在「Name」(名稱) 欄位中，輸入應用程式的名稱。

    4. 在「已授權的重新導向 URI」部分，點按「+ 新增 URI」，然後在「URI」欄位中輸入 https://claude.ai/api/mcp/auth_callback。

    5. 點選「建立」。已建立用戶端。

      「已建立 OAuth 2.0 用戶端」對話方塊隨即開啟。

    6. 在「Client secrets」部分，複製「Client secret」並儲存在安全的位置。你只能複製一次。如果遺失，請刪除密鑰並建立新的密鑰。

  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」>「Clients」>「Create client」。

      前往「建立用戶端」

      如果沒有選取專案，系統會提示您建立專案。

    2. 在「應用程式類型」清單中，選取「網頁應用程式」。

    3. 在「Name」(名稱) 欄位中，輸入應用程式的名稱。

    4. 在「已授權的重新導向 URI」部分，點按「+ 新增 URI」，然後在「URI」欄位中輸入 https://claude.ai/api/mcp/auth_callback。

    5. 點選「建立」。已建立用戶端。

      「已建立 OAuth 2.0 用戶端」對話方塊隨即開啟。

    6. 在「Client secrets」部分，複製「Client secret」並儲存在安全的位置。你只能複製一次。如果遺失，請刪除密鑰並建立新的密鑰。

  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"
    }
  }
}

Cursor

如要將 Gemini Cloud Assist 和 App Design Center 遠端 MCP 伺服器新增至 Cursor，請建立 OAuth 2.0 用戶端 ID 和用戶端密鑰，然後使用靜態 OAuth 設定 MCP 伺服器。Cursor 會根據您是透過網頁或電腦應用程式存取 Cursor，使用不同的重新導向 URI：

  1. 建立 OAuth 2.0 用戶端 ID 和用戶端密鑰：

    網頁或 Cursor 代理程式

    1. 在 Google Cloud 控制台中，依序前往「Google Auth Platform」>「Clients」>「Create client」。

      前往「建立用戶端」

      如果沒有選取專案，系統會提示您建立專案。

    2. 在「應用程式類型」清單中，選取「網頁應用程式」。

    3. 在「Name」(名稱) 欄位中，輸入應用程式的名稱。

    4. 在「已授權的重新導向 URI」部分，點按「+ 新增 URI」，然後在「URI」欄位中輸入 https://www.cursor.com/agents/mcp/oauth/callback。

    5. 點選「建立」。已建立用戶端。

      「已建立 OAuth 2.0 用戶端」對話方塊隨即開啟。

    6. 在「Client secrets」部分，複製「Client secret」並儲存在安全的位置。你只能複製一次。如果遺失，請刪除密鑰並建立新的密鑰。

    電腦

    1. 在 Google Cloud 控制台中，依序前往「Google Auth Platform」>「Clients」>「Create client」。

      前往「建立用戶端」

      如果沒有選取專案，系統會提示您建立專案。

    2. 在「應用程式類型」清單中，選取「網頁應用程式」。

    3. 在「Name」(名稱) 欄位中，輸入應用程式的名稱。

    4. 在「已授權的重新導向 URI」部分，點按「+ 新增 URI」，然後在「URI」欄位中輸入 http://localhost:8787/callback。

    5. 點選「建立」。已建立用戶端。

      「已建立 OAuth 2.0 用戶端」對話方塊隨即開啟。

    6. 在「Client secrets」部分，複製「Client secret」並儲存在安全的位置。你只能複製一次。如果遺失，請刪除密鑰並建立新的密鑰。

  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」>「Clients」>「Create client」。

      前往「建立用戶端」

      如果沒有選取專案，系統會提示您建立專案。

    2. 在「應用程式類型」清單中，選取「網頁應用程式」。

    3. 在「Name」(名稱) 欄位中，輸入應用程式的名稱。

    4. 在「已授權的重新導向 URI」部分，點按「+ 新增 URI」，然後在「URI」欄位中輸入 https://vertexaisearch.cloud.google.com/oauth-redirect。

    5. 點選「建立」。已建立用戶端。

      「已建立 OAuth 2.0 用戶端」對話方塊隨即開啟。

    6. 在「Client secrets」部分，複製「Client secret」並儲存在安全的位置。你只能複製一次。如果遺失，請刪除密鑰並建立新的密鑰。

  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 工具會使用代理技能來指示代理程式。這項技能會引導服務專員執行下列工作：

  • 將多項工具串聯成工作流程。
  • 處理相關的本機資訊 (例如 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 檔案。這個檔案會指引代理人如何適當使用工具。

後續步驟