使用連結應用程式的必要條件

開始前，請確認您具備以下項目：

  • 已部署的 MCP 伺服器，具有安全的 HTTPS 端點

    MCP 伺服器必須可透過 HTTPS 公開存取，並使用 Streamable HTTP 傳輸 (例如 https://api.yourdomain.com/v1/mcp)。

    如需實作詳情，請參閱連結的應用程式平台 MCP 伺服器開發人員指南。

  • 確保伺服器可接收 Google 的要求

    如果伺服器依來源 IP 限制外部存取，請將下列 IP 位址加入許可清單：

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    Google 的外送 IP 範圍可能會隨時間變更，因此建議您從 Google 發布的清單中讀取這些範圍，並定期重新整理許可清單：

  • 在 Google Connected Console 註冊開發人員帳戶

    登入後，請確認您在 Google Connected Console 中具備下列其中一項 Connected Apps 權限：

    • 查看連結的應用程式
    • 建立及管理連結的應用程式

    此外，帳戶擁有者或管理員也必須接受《連結的應用程式服務條款》。貴組織首次在 Google Connected Console 存取連結的應用程式時，帳戶擁有者或管理員必須登入並接受計畫協議，受邀的團隊成員才能繼續操作。

    如果您認為自己有權限，但無法建立連結的應用程式，請要求帳戶擁有者或管理員，在「使用者和權限」頁面，為您的使用者帳戶授予「查看連結的應用程式」或「建立及管理連結的應用程式」權限。

  • 可在 MCP 伺服器網域上託管 .well-known 驗證檔案

    如要驗證網域擁有權，您必須能夠直接在 https://<your-domain>/.well-known/google-connected-apps 提供 JSON 驗證權杖檔案 (使用 HTTP 200 OK，且不重新導向)。

  • 查看可用的連結應用程式類別

    連結應用程式的類別與特定功能相關聯，應用程式應支援這些功能，確保使用者享有優質體驗。連結應用程式的類別一經選取即無法變更。瞭解詳情。

  • 已部署的 MCP 伺服器，且具備有效的端點網址

    詳情請參閱連結的應用程式 MCP 伺服器開發人員指南。

  • 連結應用程式的公開中繼資料和品牌資產

    • 連結的應用程式名稱：連結的應用程式在 Google 產品中顯示的名稱，也是使用者用 @ 提及應用程式時使用的名稱。
    • 說明：簡短摘要 (不超過 30 個字)，說明連結的應用程式可為使用者提供哪些功能，例如「追蹤近期購物、查看運送狀態及檢視訂單記錄」。
    • 圖示：512 px × 512 px 的應用程式圖示，格式為 JPEG 或 PNG，檔案大小上限為 1 MB (1,024 KB)。
    • 功能：除了應用程式類別定義的預設功能外，連結的應用程式至少可執行 3 項高價值工作，例如「搜尋訂單記錄」或「查看即時配送狀態」。這些資訊會顯示給使用者，協助他們決定是否要連結。請勿在功能開頭使用數字。
    • 提示範例：至少 3 個查詢範例，協助使用者瞭解可以詢問哪些問題。至少有 2 則範例提示的開頭是連結應用程式的名稱。在至少 1 則提示中自然提及應用程式名稱 (即開頭不使用應用程式名稱)。請勿在範例提示詞開頭加入數字。
    • 服務條款網址：連結應用程式服務條款的公開網址。
    • 隱私權政策網址：連結應用程式隱私權政策的公開網址。
    • 網站網址 (選填)：連結應用程式的網站。