設定 Google Chat MCP 伺服器

Chat 提供遠端 Model Context Protocol (MCP) 伺服器,可讓 AI 代理安全地與 Chat 資料互動。設定 Chat MCP 伺服器後,Google Antigravity 和 Claude 等 AI 應用程式就能在 Chat 中執行動作。

Chat MCP 伺服器提供標準化方式,讓 AI 代理執行下列操作:

  • 讀取資料:列出及搜尋對話,以及讀取訊息。
  • 採取行動:傳送訊息、更新已讀狀態,以及管理聊天室通知設定。
  • 遵循安全性:沿用與使用者相同的權限和資料治理控制項。

必要條件

設定 Chat MCP 伺服器

如要使用 Chat MCP 伺服器,請設定 Google Cloud 雲端專案,並建立 AI 代理 OAuth 2.0 用戶端,然後設定 AI 應用程式連線至該用戶端:

  • 個人用途:如果您要為自己的 Google 帳戶連結 AI 應用程式,請使用個人用途快速設定,在單一頁面中設定專案、啟用 API 和 MCP 服務,以及建立 OAuth 用戶端。
  • 多位使用者或自訂設定:如果有多位使用者會透過您的 OAuth 用戶端登入,或您只想啟用特定 API、MCP 服務和 OAuth 範圍,請從「啟用 API」開始。

快速設定個人用途

在 Google Cloud 控制台中使用個人模式新手上路,建立僅適用於您 Google 帳戶的 OAuth 2.0 用戶端,且不需要應用程式驗證或個別的 OAuth 同意畫面設定:

  1. 在 Google Cloud 控制台中開啟「Personal mode onboarding」(個人模式新手上路)。這個按鈕會預先選取 Google Antigravity 和 Claude 需要的「網頁應用程式」用戶端:

    設定個人模式

    如果 MCP 用戶端使用電腦版或行動版 OAuth 流程,而非網頁重新導向 URI,請開啟電腦版應用程式、Android 或 iOS 用戶端的個人模式設定,或變更頁面上的「Application type」(應用程式類型)。

  2. 在「Select Project」(選取專案) 中,選取現有的個人模式專案,或按一下「Create a new project」(建立新專案)。如果系統提示,請填寫專案建立表單。

  3. 設定 OAuth 用戶端詳細資料:

    • 輸入用戶端名稱。
    • 如果「應用程式類型」是「網頁應用程式」,請在「已授權的重新導向 URI」中,點按「+ 新增 URI」,然後新增 MCP 用戶端的回呼 URI:
      • Antigravity:https://antigravity.google/oauth-callback
      • Claude:https://claude.ai/api/mcp/auth_callback
    • 確認已選取「讓 AI 輔助代理使用這個用戶端」。
  4. 詳閱《Google API 服務使用者資料政策》,選取「我同意《Google API 服務:使用者資料政策》」,然後點選「繼續」。

    控制台會在專案中啟用核心 Google Workspace API 和 MCP 服務,並建立 OAuth 用戶端。

  5. 複製用戶端 ID 和用戶端密鑰,然後將用戶端連至 MCP 伺服器。由於您已有 OAuth 用戶端 ID 和密鑰,因此可以略過步驟 1。

如要執行寫入作業 (例如傳送訊息),請一併完成「設定 Chat 擴充應用程式」一節。

啟用 API

如果您使用個人用途快速設定,請略過這個步驟。

如要使用 Chat MCP 伺服器,請在 Google Cloud 雲端專案中啟用下列 API:

  • Google Chat API

CLI

gcloud services enable chat.googleapis.com --project=PROJECT_ID

將 PROJECT_ID 替換為 Google Cloud 專案 ID。

控制台

在 Google Cloud 控制台中啟用 API:

啟用 API

啟用 MCP 服務

如果您使用個人用途快速設定,請略過這個步驟。

如要啟用 Chat 的 MCP 元件,請在 Google Cloud 專案中啟用下列服務:

  • Chat MCP API

CLI

gcloud services enable chatmcp.googleapis.com --project=PROJECT_ID

將 PROJECT_ID 替換為 Google Cloud 專案 ID。

控制台

在 Google Cloud 控制台中啟用 MCP 服務:

啟用 MCP 服務

設定 Chat 應用程式

如要使用 Chat MCP 伺服器執行唯讀作業 (例如搜尋對話),請啟用 API 並建立 OAuth 用戶端。不需設定 Chat 擴充應用程式。

如要執行傳送訊息等寫入作業,請在 Google Cloud 雲端專案中設定 Chat 應用程式。

  1. 在 Google Cloud 控制台中搜尋「Google Chat API」,然後依序點選「Google Chat API」>「Manage」(管理) >「Configuration」(設定)。

    前往 Google Chat API

  2. 設定 Chat 應用程式:

    1. 在「App name」欄位中輸入 Chat MCP。
    2. 在「Avatar URL」(顯示圖片網址) 欄位中,輸入 https://developers.google.com/chat/images/quickstart-app-avatar.png。
    3. 在「Description」(說明) 中輸入 Chat MCP server。
    4. 在「Functionality」(功能) 下方,關閉「Enable interactive features」(啟用互動功能),即可停用互動功能。
    5. 在「記錄」下方,選取「將錯誤記錄至 Logging」。
  3. 按一下「儲存」。

如要進一步瞭解如何建構 Chat 應用程式,請參閱「選擇 Chat 應用程式架構」。

如果您使用個人用途快速設定,請略過這個步驟。

Chat MCP 伺服器使用 OAuth 2.0 進行驗證和授權。您必須先設定 OAuth 同意畫面,才能建立 OAuth 用戶端 ID。

  1. 在 Google Cloud 控制台中,依序前往「Google Auth Platform」>「Branding」(品牌)。

    前往「品牌宣傳」

  2. 如果您已設定 Google Auth Platform,可以在「Branding」(品牌)、「Audience」(目標對象) 和「Data Access」(資料存取權) 中,調整下列 OAuth 同意畫面設定。如果看到「Google Auth Platform not configured yet」(尚未設定 Google 驗證平台) 訊息,請按一下「Get Started」(開始使用):

    1. 在「App Information」(應用程式資訊) 的「App name」(應用程式名稱) 中,輸入 Chat MCP Server。
    2. 在「User support email」(使用者支援電子郵件) 中,選取您的電子郵件地址或適當的 Google 群組。
    3. 點選 [下一步]。
    4. 在「Audience」(目標對象) 下方,選取「Internal」(內部)。如果無法選取「Internal」(內部),請選取「External」(外部)。
    5. 點選 [下一步]。
    6. 在「Contact Information」(聯絡資訊) 下方,輸入可接收專案異動通知的電子郵件地址。
    7. 點選 [下一步]。
    8. 在「Finish」(完成) 部分,請詳閱《Google API 服務使用者資料政策》,然後選取「我同意《Google API 服務:使用者資料政策》」。
    9. 按一下「繼續」。
    10. 點選「建立」。
    11. 如果使用者類型選取「外部」,請新增測試使用者:
      1. 按一下「目標對象」。
      2. 在「測試使用者」下方,按一下「新增使用者」。
      3. 輸入您的電子郵件地址和任何其他授權測試使用者,然後按一下「Save」(儲存)。
  3. 依序按一下「資料存取權」>「新增或移除範圍」。系統會顯示面板,列出 Google Cloud 專案中啟用的各個 API 範圍。

    1. 在「Manually add scopes」(手動新增範圍) 下方,貼上 Chat MCP 伺服器的範圍:

      • https://www.googleapis.com/auth/chat.spaces.readonly
      • https://www.googleapis.com/auth/chat.memberships.readonly
      • https://www.googleapis.com/auth/chat.messages.readonly
      • https://www.googleapis.com/auth/chat.messages.create
      • https://www.googleapis.com/auth/chat.users.readstate
      • https://www.googleapis.com/auth/chat.users.spacesettings
    2. 按一下「新增至表格」。

    3. 按一下「更新」。

    4. 選取應用程式所需的範圍後,在「Data Access」(資料存取權) 頁面中按一下「Save」(儲存)。

設定 AI 應用程式

如要將 Chat 遠端 MCP 伺服器新增至 AI 應用程式,請按照應用程式的操作說明進行。

呼叫 Chat MCP 伺服器的使用者委派 OAuth 2.0 用戶端 ID,必須在「Google Auth Platform」>「用戶端」中選取「將這個用戶端用於 AI 輔助代理」。如要更新現有的 OAuth 2.0 用戶端 ID,請依序前往「Google Auth Platform」>「Clients」選取這項設定,詳情請參閱「管理 OAuth 用戶端」。如果無法變更現有用戶端的這項設定,或用戶端也支援非代理功能,請為 AI 代理建立新的 OAuth 2.0 用戶端 ID。如要瞭解遭拒的要求、具有全網域委派權限的服務帳戶,或 Google Apps Script,請參閱「疑難排解」。

Antigravity

如要將 Chat 遠端 MCP 伺服器新增至 Antigravity,請將伺服器設定新增至 mcp_config.json 檔案。這些操作說明適用於 Antigravity 2.0、Antigravity IDE 和 Antigravity CLI。

  1. 建立 OAuth 2.0 用戶端 ID 和密鑰。如果您已在個人用途快速設定中建立,請跳至下一個步驟:

    1. 在 Google Cloud 控制台,依序前往「Google Auth Platform」>「用戶端」>「建立用戶端」。

      前往「Create Client」(建立用戶端)

    2. 將應用程式類型設為「Web application」(網頁應用程式)。

    3. 輸入名稱。

    4. 在「Authorized redirect URIs」(已授權的重新導向 URI) 區段中,按一下「+ Add URI」(新增 URI),然後在「URIs」(URI) 欄位中新增 https://antigravity.google/oauth-callback。

    5. 選取「讓 AI 輔助代理使用這個用戶端」。

    6. 按一下「建立」,然後複製「用戶端 ID」和「用戶端密鑰」。

  2. 開啟或建立設定檔 ~/.gemini/config/mcp_config.json。

  3. 將 mcpServers 設定新增至 mcp_config.json:

    {
      "mcpServers": {
        "chat": {
          "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        }
      }
    }
    

    更改下列內容:

    • OAUTH_CLIENT_ID:您建立的用戶端 ID。
    • OAUTH_CLIENT_SECRET:您建立的用戶端密鑰。
  4. 現省 mcp_config.json。

  5. 驗證 MCP 伺服器。您可以使用 GUI 設定或 CLI 進行驗證:

    • Antigravity IDE 或 GUI (Antigravity 2.0):

      1. 開啟設定畫面 (例如點選左下方的「設定」,或開啟「Antigravity User Settings」)。
      2. 前往「自訂」。
      3. 在「已安裝的 MCP 伺服器」下方,點按「重新整理」。
      4. 在清單中找到 chat,按一下「Authenticate」(驗證),登入 Google 帳戶,複製授權碼,然後將授權碼貼到輸入對話方塊中,再按一下「Submit」(提交)。
    • Antigravity CLI:

      1. 啟動 Antigravity CLI:

        agy
        
      2. 執行下列指令,開啟互動式 MCP 管理面板:

        /mcp
        
      3. 使用方向鍵選取 chat,移至「Authenticate」(驗證) 動作,然後按下 Enter 鍵。在瀏覽器中完成登入流程,複製授權碼,貼到終端機提示中,然後按下 Enter 鍵。

  6. 確認伺服器已正確設定並運作:

    • Antigravity IDE 或 GUI:依序前往「Customizations」>「Installed MCP Servers」,伺服器旁會顯示「Sign out」按鈕。
    • Antigravity CLI:開啟 /mcp 面板,查看已設定的 MCP 伺服器。在互動式 TUI 面板中,已驗證和驗證過的伺服器名稱旁會顯示「Authed」。在資訊主頁檢視畫面中,您可以選取任何伺服器,檢查其狀態並列出所有可用工具。

遠端 MCP 伺服器已可在 Antigravity 中使用。

Claude

如要搭配 Claude.ai 或 Claude Desktop 使用 Chat 遠端 MCP 伺服器,您必須訂閱 Claude Enterprise、Pro、Max 或 Team 方案。

如要將 Chat 遠端 MCP 伺服器新增至 Claude,請使用 OAuth 用戶端 ID 和密鑰設定自訂連接器。

  1. 建立 OAuth 2.0 用戶端 ID 和密鑰。如果您已在個人用途快速設定中建立,請跳至下一個步驟:

    1. 在 Google Cloud 控制台,依序前往「Google Auth Platform」>「用戶端」>「建立用戶端」。

      前往「Create Client」(建立用戶端)

    2. 將應用程式類型設為「Web application」(網頁應用程式)。

    3. 輸入名稱。

    4. 在「Authorized redirect URIs」(已授權的重新導向 URI) 區段中,按一下「+ Add URI」(新增 URI),然後在「URIs」(URI) 欄位中新增 https://claude.ai/api/mcp/auth_callback。

    5. 選取「讓 AI 輔助代理使用這個用戶端」。

    6. 按一下「建立」,然後複製「用戶端 ID」和「用戶端密鑰」。

  2. 在 Claude 中設定 MCP 伺服器:

    1. 在 Claude.ai 或 Claude Desktop 中,依序前往「Settings」>「Connectors」或「Admin settings」>「Connectors」。
    2. 按一下「新增自訂連接器」。
    3. 輸入 Chat 產品的連線詳細資料:
      • 伺服器名稱:Chat。
      • 遠端 MCP 伺服器網址: https://chatmcp.googleapis.com/mcp/v1
    4. 在「Advanced settings」(進階設定) 中,輸入「OAuth client ID」(OAuth 用戶端 ID) 和「OAuth client secret」(OAuth 用戶端密鑰)。
    5. 按一下 [新增]。

其他

許多 AI 應用程式都能連線至遠端 MCP 伺服器。您通常需要輸入伺服器的詳細資料,例如名稱、端點、傳輸通訊協定和驗證方式。如果是 Chat 遠端 MCP 伺服器,請輸入下列內容:

  • 伺服器名稱:chat

  • 伺服器網址:https://chatmcp.googleapis.com/mcp/v1

  • 傳輸:可串流 HTTP

  • 驗證:Chat 遠端 MCP 伺服器使用 OAuth 2.0。建立 OAuth 2.0 用戶端時,請選取「讓 AI 輔助代理使用這個用戶端」。如果是單一使用者個人設定,您可以使用個人用途快速設定,建立網頁、電腦、Android 或 iOS 用戶端。詳情請參閱「瞭解驗證與授權」。

    如要避免網頁應用程式 OAuth 用戶端每小時提示登入,請設定 MCP 用戶端,使用 access_type=offline 或 offline_access 範圍要求離線存取權。詳情請參閱「每小時重複出現登入提示」。

如要進一步瞭解如何連結不同類型的 AI 應用程式,請參閱「在 AI 應用程式中設定 MCP」。

測試 Chat MCP 伺服器

設定 AI 應用程式後,您可以執行一些測試提示,驗證連線是否正常。

試著向 AI 應用程式提出下列問題:

  • 「『Project X』聊天室的最後一則訊息是什麼?」

    用戶端會使用 search_conversations 尋找聊天室,然後使用 list_messages 擷取訊息。

如果工具執行成功,且您收到相關回覆,表示 Chat MCP 伺服器設定正確。

疑難排解

請參閱下列各節,解決 Chat MCP 伺服器常見的驗證和連線問題。

查看 OAuth 記錄事件

如果連線至 MCP 伺服器時發生問題,請檢查 OAuth 記錄中是否有錯誤。請 Google Workspace 管理員在安全調查工具中查看 OAuth 記錄事件。

使用者委派 OAuth 用戶端遭拒的要求

如果對 MCP 伺服器提出的要求遭拒,請確認 3-legged OAuth 流程的使用者委派 OAuth 2.0 用戶端 ID,已在「Google Auth Platform」>「用戶端」中選取「將這個用戶端用於 AI 輔助代理」:

  • 現有用戶端支援這項設定:在現有 OAuth 用戶端上,選取「讓 AI 輔助代理使用這個用戶端」。
  • 無法更新現有用戶端:建立新的 OAuth 用戶端,並選取「Use this client for an AI-powered agent」(將這個用戶端用於 AI 代理),然後更新應用程式,改用這個用戶端。
  • 現有用戶端也支援非代理功能:為 AI 代理建立獨立的 OAuth 用戶端,並保留現有用戶端用於非代理功能。

如需操作說明,請參閱「設定 AI 應用程式」和「管理 OAuth 用戶端」。

具備全網域委派功能的服務帳戶

如果應用程式使用具備全網域委派權限的服務帳戶進行雙足式 OAuth,則無法選取「Use this client for an AI-powered agent」,因為服務帳戶並非在「Google Auth Platform」>「Clients」中管理:

  • 存取控管:如果這些服務帳戶向 MCP 伺服器提出要求,不會因缺少代理設定而遭拒。而是由 Google Workspace 管理員控管的全網域委派設定管理。如要進一步瞭解管理員設定,請參閱「使用全網域委派功能控管 API 存取權」。
  • 敏感動作:Google Workspace MCP 伺服器仍會傳回表單提示,要求人工介入迴路確認透過全網域委派使用者身分模擬執行的敏感工具呼叫。

來自 Apps Script 的要求

如果從 Apps Script 呼叫 MCP 伺服器,則無法在 Apps Script 為指令碼建立及管理的預設 OAuth 用戶端上,選取「將這個用戶端用於 AI 輔助代理」。即使指令碼使用標準 Google Cloud 專案,也適用這項規定。

如要從 Apps Script 呼叫 MCP 伺服器,請按照下列步驟操作:

  1. 在 Google Cloud 控制台,依序前往「Google Auth Platform」>「Clients」(用戶端),建立 OAuth 用戶端,然後選取「Use this client for an AI-powered agent」(將這個用戶端用於 AI 輔助代理)。
  2. 在指令碼中,使用 Apps Script 的 OAuth2 程式庫,透過該 OAuth 用戶端授權使用者。
  3. 呼叫 MCP 伺服器時,請傳送程式庫傳回的存取權杖,而非 ScriptApp.getOAuthToken 的權杖。

不呼叫 Google Workspace MCP 伺服器的 Apps Script 專案則不受影響。

每小時重複顯示登入提示

如果系統每小時都提示您重新登入,表示 MCP 用戶端未收到或使用更新權杖。這通常發生在以下情況:

  • 網頁應用程式 OAuth 用戶端缺少離線存取權:與電腦版應用程式 OAuth 用戶端不同,網頁應用程式 OAuth 用戶端預設為線上存取。如要要求更新權杖,請加入 access_type=offline,或加入 OpenID Connect (OIDC) offline_access 範圍和至少一個 API 範圍,且不要設定 access_type=online。
  • 重新授權已同意的應用程式:使用者首次授予離線存取權時,Google 的 OAuth 2.0 伺服器會核發更新權杖。如果使用者已授權 OAuth 用戶端,但未啟用離線存取權,或 MCP 用戶端遺失儲存的更新權杖,後續登入可能不會傳回新的更新權杖。請在授權要求中加入 prompt=consent,或在 Google 帳戶連結中移除應用程式的存取權,然後重新登入。
  • 靜態不記名權杖:如果您在 Authorization 標頭中傳遞原始存取權杖 (例如 gcloud auth print-access-token 的輸出內容),權杖會在 1 小時後到期,除非用戶端重新整理權杖。

詳情請參閱「重新整理存取權杖」。

工具參考資料

Chat MCP 伺服器提供下列工具。如需輸入和輸出結構定義,請參閱 Chat MCP 參考資料:

重要安全考量:間接提示詞注入式攻擊

如果讓語言模型接觸不受信任的資料,可能會發生間接提示詞注入式攻擊。Google Antigravity 等 AI 應用程式可透過 Chat MCP 伺服器存取強大的工具和 API,因此能讀取、修改及刪除 Google 帳戶中的資料。

為降低這些風險,您必須篩選提示和回覆,找出惡意內容或提示詞注入式攻擊。您可以使用 Google 提供的 Model Armor,也可以使用自己的解決方案,但必須提供相關說明文件,讓使用者瞭解並接受風險。如需操作說明,請參閱「設定 Google Workspace MCP 伺服器的安全性」。

請遵循下列最佳做法:

  • 只使用可信任的工具。請勿將 Chat MCP 伺服器連至不受信任或未經驗證的應用程式。
  • 請謹慎處理不受信任的輸入內容。請勿要求 AI 應用程式處理來自未經驗證來源的訊息或其他資源。這些輸入內容可能包含隱藏指令,可劫持工作階段,讓攻擊者修改、竊取或刪除資料。
  • 查看所有動作。請務必仔細檢查 AI 應用程式代您執行的動作,確保這些動作正確無誤且符合您的意圖。