Google Antigravity 2.0、IDE 和/或 CLI 中的 Google Workspace MCP 伺服器

1. 簡介

在這個程式碼實驗室，您將瞭解如何使用 Model Context Protocol (MCP)，將 Google Workspace 資料連結至 Antigravity 2.0、IDE 和/或 CLI。MCP 是開放標準，可讓 AI 模型安全地使用遠端伺服器提供的工具。您將設定 Antigravity，與 Gmail、Google 雲端硬碟、Google 文件、Google 試算表、Google 簡報、Google 日曆、Google Chat 和 People API 互動，完全不必編寫程式碼！

google_workspace_mcp_antigravity_arch_2.png

學習內容

  • 在 Google Cloud 專案中啟用 Google Workspace MCP 服務。
  • 設定 Antigravity 存取這些 MCP 服務。
  • 使用有趣實用的提示，測試與 Google Workspace 資料互動的整合功能。

軟硬體需求

輕鬆存取這個程式碼實驗室

qr_code.png

2. 事前準備

建立或選取 Google Cloud 專案

在 Google Cloud 控制台中，選取或建立 Google Cloud 專案。

啟用 API

如要使用 Google Workspace MCP 伺服器，必須啟用標準 Google Workspace API。

啟用 MCP 服務

接著，啟用 Google Workspace MCP 服務。

設定 Chat 應用程式

如要使用 Google Chat MCP 伺服器，您必須在 Google Cloud 專案中設定 Chat 應用程式。

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

  1. 設定 Chat 擴充應用程式：
    • 在「App name」欄位中輸入 Chat MCP。
    • 在「Avatar URL」欄位中輸入 https://developers.google.com/chat/images/quickstart-app-avatar.png。
    • 在「Description」(說明) 中輸入 Chat MCP server。
    • 在「功能」下方，關閉「啟用互動功能」。
    • 在「記錄」下方，選取「將錯誤記錄至 Logging」。
  2. 按一下「儲存」。

chat_app.png

3. 設定 OAuth 同意畫面和用戶端

Google Workspace MCP 伺服器使用 OAuth 2.0 進行安全驗證和授權。您必須設定 OAuth 同意畫面，並建立網頁應用程式用戶端。

您必須先設定同意畫面。

  1. 在 Google Cloud 控制台，依序前往「Google Auth Platform」>「品牌宣傳」。如果尚未設定，請按一下「Get Started」(開始使用)。
  2. 設定「App Information」：
    • 應用程式名稱：Google Workspace MCP Servers
    • 「使用者支援電子郵件」：選取您的電子郵件地址。
  3. 設定「目標對象」：選取「內部」(如果沒有「內部」選項，請選取「外部」)。
  4. 設定「Contact Information」(聯絡資訊)：輸入電子郵件地址。
  5. 詳閱並同意《使用者資料政策》，然後按一下「建立」。
  6. 如果您選取「外部」，請前往「目標對象」，然後在「測試使用者」下方新增電子郵件地址。
  7. 依序前往「資料存取權」>「新增或移除範圍」。在「手動新增範圍」下方，為要使用的伺服器新增下列項目：
    • 通用：https://www.googleapis.com/auth/gmail.readonly、https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/calendar.readonly、https://www.googleapis.com/auth/chat.messages.readonly
    • Gmail：https://www.googleapis.com/auth/gmail.readonly、https://www.googleapis.com/auth/gmail.compose
    • Google 雲端硬碟：https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/drive.file
    • Google 文件：https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/drive.file、https://www.googleapis.com/auth/documents.readonly、https://www.googleapis.com/auth/documents
    • Google 試算表：https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/drive.file、https://www.googleapis.com/auth/spreadsheets.readonly、https://www.googleapis.com/auth/spreadsheets
    • Google 簡報：https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/drive.file、https://www.googleapis.com/auth/presentations.readonly、https://www.googleapis.com/auth/presentations
    • Google 日曆：https://www.googleapis.com/auth/calendar.calendarlist.readonly、https://www.googleapis.com/auth/calendar.events.freebusy、https://www.googleapis.com/auth/calendar.events.readonly
    • Google Chat：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.readonly
    • People API：https://www.googleapis.com/auth/directory.readonly、https://www.googleapis.com/auth/userinfo.profile、https://www.googleapis.com/auth/contacts.readonly
  8. 依序點選「新增至表格」、「更新」和「儲存」。

oauth_consent_screen_1.pngoauth_consent_screen_2.pngoauth_consent_screen_3.png

建立 OAuth 用戶端 ID

  1. 依序前往「Google Auth Platform」>「用戶端」>「建立用戶端」。
  2. 將應用程式類型設為「Web application」(網頁應用程式)。
  3. 將其命名為 Antigravity。
  4. 在「已授權的重新導向 URI」下方，點選「+ 新增 URI」，然後輸入 https://antigravity.google/oauth-callback。
  5. 選取「讓 AI 代理使用這個用戶端」。
  6. 按一下「建立」，然後複製「用戶端 ID」和「用戶端密鑰」。下一個步驟會用到這些資訊。

oauth_client.png

4. 設定 Antigravity

現在，請設定 Antigravity 使用這些端點。如果尚未安裝 Antigravity 2.0、IDE 和/或 CLI，請按照 Antigravity 網站上的操作說明進行。

新增自訂 MCP 伺服器

Antigravity 2.0、IDE 和 CLI 會共用 ~/.gemini/config/mcp_config.json 檔案中的中央 MCP 設定。

  1. 使用慣用的文字編輯器開啟檔案。
  2. 請修改下列自訂 MCP 伺服器設定。執行前，請將 <YOUR_CLIENT_ID> 和 <YOUR_CLIENT_SECRET> 預留位置，替換為您在先前步驟中建立的 OAuth 用戶端 ID 和密鑰。
  3. 儲存。
{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

驗證自訂 MCP 伺服器

您應該會看到所有設定為安裝在 Antigravity 的 MCP 伺服器：gws-universal、gws-gmail、gws-drive、gws-docs、gws-sheets、gws-slides、gws-calendar、gws-chat和 gws-people。由於 OAuth 權杖並非集中管理，因此您必須為每個 Antigravity 介面分別驗證。

Antigravity 2.0

  1. 按一下左下方的「設定」。
  2. 前往「自訂」。
  3. 在「已安裝的 MCP 伺服器」下方，點按「重新整理」。

unauthed_mcp_servers_20.png

  1. 針對列出的每個已安裝 MCP 伺服器：
    1. 按一下「Authenticate」(驗證)。
    gui_auth.png
    1. 在開啟的新瀏覽器視窗中，完成驗證流程。
    2. 完成後，按一下「複製到剪貼簿」。
    copy_auth_code.png
    1. 將剛才複製的授權碼貼到 Antigravity 2.0 設定顯示的文字欄位中，然後按一下「Submit」。
    gui_paste_auth_code.png
    1. 「Authenticate」(驗證) 按鈕現在會替換為「Sign out」(登出) 按鈕。
    gui_sign_out.png

Antigravity IDE

  1. 在視窗頂端的「Editor-Specific settings」下拉式選單中，開啟「Antigravity User Settings」。

open_user_settings_ide.png

  1. 前往「自訂」。
  2. 在「已安裝的 MCP 伺服器」下方，點按「重新整理」。

unauthed_mcp_servers_ide.png

  1. 針對列出的每個已安裝 MCP 伺服器：
    1. 按一下「Authenticate」(驗證)。
    gui_auth.png
    1. 在開啟的新瀏覽器視窗中，完成驗證流程。
    2. 完成後，按一下「複製到剪貼簿」。
    copy_auth_code.png
    1. 在 Antigravity IDE 設定顯示的文字欄位中，貼上剛才複製的授權碼，然後按一下「Submit」。
    gui_paste_auth_code.png
    1. 「Authenticate」(驗證) 按鈕現在會替換為「Sign out」(登出) 按鈕。
    gui_sign_out.png

Antigravity CLI

  1. 輸入 /mcp，然後按下 Enter 鍵。

unauthed_mcp_servers_cli.png

  1. 針對列出的每個 MCP 伺服器：
    1. 使用向上和向下鍵選取，然後按下 Enter 鍵。
    2. 使用向左和向右鍵選取「Authenticate」，然後按下 Enter 鍵。
    cli_auth.png
    1. 在新的瀏覽器視窗中開啟顯示的網址，然後完成驗證流程。
    cli_auth_url.png
    1. 完成後，按一下「複製到剪貼簿」。
    copy_auth_code.png
    1. 在執行 Antigravity CLI 的終端機中，將剛才複製的授權碼貼到文字欄位，然後按下 Enter 鍵。
    cli_paste_auth_code.png
    1. 狀態會從「Auth Needed」變更為「Authed」。
    cli_sign_out.png

5. 測試工具

現在，您可以使用自然語言與 Google Workspace 資料互動。以下是各項服務的提示範例。

通用

請嘗試在不同產品中搜尋：

  • 「用幾句話總結我的 Google Workspace 帳戶最近發生的事。」
  • 「在我的電子郵件、文件和即時通訊訊息中，找出與 [PROJECT_NAME] 相關的內容。」
  • 「下一場行銷計畫會議是什麼時候？最新的相關筆記和即時通訊訊息有哪些？」

ide_uni_test.png

Gmail

請嘗試搜尋或管理電子郵件：

  • 「重點摘要我收到的最後 5 封電子郵件。」
  • 「草擬一封電子郵件給『[EMAIL_ADDRESS]』，詢問『[PROJECT_NAME]』專案的最新進度。」

Google 雲端硬碟

嘗試搜尋或讀取檔案：

  • 「在我的 Google 雲端硬碟中搜尋含有『[關鍵字]』的檔案。」
  • 「列出我最近編輯的文件。」
  • 「讀取『[FILE_NAME]』文件的內容，並摘要主要目標。」

Google 文件、試算表和簡報

試著搜尋雲端硬碟資源：

  • 「顯示 Google 文件 [DOCS_TITLE] 的結構內容。」
  • 「讀取 Google 試算表 [SHEETS_TITLE] 的工作表 Sheet1」
  • 「顯示 Google 簡報 [SLIDES_TITLE] 的口述版面配置。」

Google 日曆

試著搜尋時間表：

  • 「我這週有哪些會議？」
  • 「我明天下午有空嗎？」

Google Chat

嘗試搜尋訊息：

  • 「在『[SPACE_NAME]』中尋找含有『[KEYWORD]』的訊息」

People API

請嘗試搜尋個人資料或聯絡人：

  • 「根據我的 Google 個人資料，我叫什麼名字？」
  • 「尋找『[名稱]』的聯絡資訊。」

結合多項服務

MCP 的真正威力在於能協調多項服務的工作。試試以下提示，體驗跨服務功能：

  • 「在雲端硬碟中搜尋與『[PROJECT_NAME] 里程碑更新』相關的檔案，並總結內容。接著找出『[NAME]』的電子郵件地址，然後在 Gmail 中建立草稿，將摘要傳送給對方。」

探索更多工具

以上只是幾個例子。如要查看各項服務提供的完整工具清單並試用，請參閱官方說明文件的「支援的產品」一節。

6. 清除

如要清理專案而不刪除，可以停用已啟用的 API 和 MCP 服務：

  1. 在 Google Cloud 控制台中，前往「API & Services Dashboard」(API 和服務資訊主頁)。
  2. 按一下您啟用的各個 Google Workspace 和 MCP API (例如 Calendar MCP、Chat MCP)，然後點選「停用 API」。

如果不再使用 OAuth 用戶端憑證，請在 Google Auth Platform 控制台刪除。

7. 恭喜

恭喜！您已成功使用 Antigravity 設定及測試官方 Google Workspace MCP 伺服器。

參考文件