連結的應用程式平台 MCP 伺服器開發人員指南

使用者可透過連結的應用程式,在適用的 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 開發人員模式中遠端測試。您可以在任何偏好的雲端服務供應商或基礎架構上託管。

下一步是在 Gemini 開發人員模式中驗證公開端點。

  • 即時 Gemini 驗證:使用 Gemini 開發人員模式測試即時工具執行。使用內建的偵錯分頁 (包括事件記錄、工具結構定義、環境模擬 (日期、時間、位置) 和驗證設定),在要求最終核准和發布前,驗證模型回覆。

階段 4:註冊 - 使用 Google Connected Console 進行設定

驗證本機執行後,請提交存取權申請,並在 Google Connected Console 中註冊整合詳細資料。

  • 存取權要求:請使用意願調查表申請存取權。
  • 管理中心設定和發布:在 Google Connected Console 中,定義應用程式詳細資料、設定驗證和端點、探索工具、管理預先發布版環境和測試人員,以及提交應用程式進行審查和發布。閱讀指南。