跳轉至

連接 Gemini Spark/自訂應用程式

Gemini 的 自訂連線應用程式 功能（之前稱為 Spark）允許符合條件的 Gemini 使用者連接遠端 MCP 伺服器。 LSM 可以提供 MCP 端點。這是到 unified web workspace、ChatGPT 和其他 MCP 客戶端的替代客戶端連接；它不會替換或部署 LSM 控制器。

Google 目前將自訂應用程式限制為年滿 18 歲的美國用戶、使用個人 Google 帳戶登入並保持活動啟用。該功能以英語提供。連接必須在 Gemini Web 應用程式上創建，儘管連接的應用程式稍後可以在行動裝置上使用。可用性和 UI 標籤可能會變更；請參閱 official Gemini custom apps instructions。

連接前

  • 啟動 LSM 運行時（例如使用 Docker Compose），並驗證其運作狀況。
  • 透過可公開存取的 HTTPS 公開其 MCP 端點並保持 OAuth 啟用。
  • 了解控制器的身份驗證詳細資訊並僅批准您需要的範圍。
  • 使用受限的工作空間或容器。雙子座可能會要求對文件、機器和終端機產生實際影響的操作。

在 Gemini 中輸入的端點是：

https://your-public-host.example.com/mcp

請勿輸入 Web UI (/ui)、LibreChat URL 或不含 /mcp 的網站來源。公共部署不應停用身份驗證來解決連線錯誤。

連接雙子座

  1. 在電腦上，開啟 Gemini 並使用符合條件的個人帳戶登入。
  2. 開啟 設定和幫助 → 連接的應用程式。根據目前介面，它可能位於個人智慧 → 連接的應用程式下。
  3. 在 自訂應用程式 下，選擇 新增自訂應用程式 或使用自訂應用程式 URL 欄位。
  4. 貼上 LSM HTTPS /mcp URL，然後選擇 下一步。
  5. 使用 LSM 控制器完成 OAuth 和同意流程。 LSM 支援 OAuth 發現和動態用戶端註冊。如果 Gemini 請求手動 OAuth 用戶端憑證，請在繼續之前檢查其進階選項和 LSM OAuth 設定。
  6. 在 Gemini 對話中，輸入 @ 並選擇連接的自訂應用程式以請求 LSM 工具。

首先：「使用連接的 LSM 應用程式檢查環境並列出工作區文件。請勿修改任何內容。」在嘗試寫入操作之前檢查工具結果和控制器審核。

限制和故障排除

  • 無自訂應用程式選項： 確認帳戶、地區、年齡、語言和保留活動資格。這是 Gemini 端的可用性限制，而不是 LSM 設定錯誤。
  • URL 被拒絕： 使用外部可存取的 HTTPS /mcp 端點；檢查 OAuth 發現和您的反向代理。
  • OAuth 失敗： 檢查 LSM 授權畫面、用戶端註冊、回呼 URL 和授予的範圍。請勿發布未經身份驗證的 MCP 端點。
  • 工具遺失或失敗： 用戶端 MCP 工具/架構支援可能有所不同。嘗試一個簡單的唯讀呼叫並檢查 LSM 審核和日誌；不保證與每個 Gemini 用戶端功能完全相容。
  • 斷開連接：當不再需要時，返回連接的應用程式以停用、取消連結或刪除 LSM。

Google 的 official guide 描述了最新的自訂應用程式流程和可用性。基於 CLI 的本地 Gemini 集成，請參閱 Gemini CLI's MCP documentation。 LSM ChatGPT connector tutorial 仍然獨立可用。