使用者可透過連結的應用程式,在適用的 Google 產品中存取各種內容和服務。
連結的應用程式有下列優點。
- 控管要向連結的應用程式平台提供哪些功能和服務:您可以精細控管整合範圍。
- 品牌歸因和探索:選取要與應用程式整合的 Google 介面後,品牌就會顯示在顯眼的位置。
- 提高參與度潛力:連結的應用程式可協助使用者在需要時存取您的服務,提高使用者參與度和滿意度。
整合選項
MCP 伺服器和 AppFunctions 是兩種主要的互補方式,可將應用程式的功能整合至適用的 Google 產品。
MCP 伺服器 (本開發人員指南所述):
- 這是我們建議的預設路徑,適用於基礎跨平台功能。
- MCP 伺服器可讓您在 Android、iOS 和網頁上擴充。如果您有現成的 Web API 或遠端 MCP 伺服器,可以使用我們的 MCP 伺服器規格加以運用。這是以最低成本 達到最大觸及率的方法
Android MCP (開發人員指南)
- AppFunctions 旨在打造更深入的 Android 內建體驗。AppFunctions 可與 Android 作業系統和系統 UI 介面深度整合,利用裝置端內容解析意圖。
- 需要情境資訊,且與應用程式目前狀態緊密整合的操作。
- 您可以透過 Jetpack 程式庫取得支援。
端對端程序
本指南概述建構、測試、註冊及部署遠端 Model Context Protocol (MCP) 伺服器的端對端程序,以便在適用的 Google 產品中整合服務。
階段 1:建構 - 開發遠端 MCP 伺服器
使用 Model Context Protocol 規格開發遠端 MCP 伺服器時,建議您建立結構化系統指令、明確的安全註解、清楚的結構定義定義,以及 UI 中繼資料繫結。
- 明確的伺服器指令:初始化 MCP 伺服器時,請定義明確的伺服器指令,說明您的網域和功能。AI 模型會根據這些伺服器指令,判斷何時要將工作委派給伺服器,因此強烈建議您提供明確的伺服器指令,以便在適用的 Google 產品中準確路由模型。
- 安全性和執行工具註解:為每項工具宣告明確的通訊協定註解,例如使用
readOnlyHint=True標示唯讀查詢作業,或使用destructiveHint=True標示狀態變更/破壞性動作。您也可以在 Google Connected Console 中,標示需要確認的操作。 - 強型別結構定義和語意 docstring:提供明確的引數類型和詳細的參數 docstring。清楚記錄預期的欄位值 (例如允許的類別過濾器或位置參數),盡可能提高模型工具呼叫的準確率。
- UI 資源中繼資料繫結 (選用):定義中繼資料註解 (例如
meta={"ui": {"resourceUri": "ui://..."}}),將工具輸出內容直接繫結至自訂 UI 資源。如有提供,這會指示用戶端在對話介面中,直接在安全的沙箱 iframe 內,轉譯豐富、具品牌特色的互動式 UI 小工具。
階段 2:驗證 - 使用 MCP Inspector 在本機測試
在遠端託管服務之前,請先在本機沙箱環境中驗證工具宣告和介面算繪。
- 本機伺服器初始化:在開發機器上,於本機執行遠端 MCP 伺服器。
- 檢查工具驗證:使用 MCP 檢查工具 (
npx @modelcontextprotocol/inspector) 連線至本機伺服器。 - 執行和 UI 驗證:叫用個別工具、檢查原始 JSON 輸入/輸出酬載,並確認自訂 UI 資源直接在網路瀏覽器中正常顯示。
階段 3:使用 Gemini 開發人員模式部署及測試
您必須將 MCP 伺服器部署至公開 HTTPS 端點,才能在 Gemini 開發人員模式中遠端測試。您可以在任何偏好的雲端服務供應商或基礎架構上託管。
- 公開 HTTPS 代管:將遠端 MCP 伺服器託管在公開 HTTPS 端點。如要託管於 Google Cloud,請使用 Google Cloud Run 部署,並使用
gcloud run deploy <server-name>。
下一步是在 Gemini 開發人員模式中驗證公開端點。
- 即時 Gemini 驗證:使用 Gemini 開發人員模式測試即時工具執行。使用內建的偵錯分頁 (包括事件記錄、工具結構定義、環境模擬 (日期、時間、位置) 和驗證設定),在要求最終核准和發布前,驗證模型回覆。
階段 4:註冊 - 使用 Google Connected Console 進行設定
驗證本機執行後,請提交存取權申請,並在 Google Connected Console 中註冊整合詳細資料。