Antigravity 中的 Google Workspace MCP 伺服器

1. 簡介

在本程式碼研究室中，您將瞭解如何使用 Model Context Protocol (MCP)，將 Antigravity 連結至 Google Workspace 資料。MCP 是一項開放標準，可讓 AI 模型安全地使用遠端伺服器提供的工具。您將設定 Antigravity，與 Gmail、Google 雲端硬碟、Google 日曆、Google Chat 和 People API 互動，完全不需要編寫任何程式碼！

Google Workspace MCP 架構

學習內容

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

軟硬體需求

  • 網路瀏覽器，例如 Chrome
  • 具備 Google Cloud 專案
  • Google Workspace 帳戶
  • 本機電腦已安裝 Antigravity

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

qr_code.png

2. 事前準備

建立或選取 Google Cloud 專案

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

啟用 API

如要使用 Google Workspace MCP 伺服器，必須啟用標準 Google Workspace API。部分 MCP 伺服器可獨立運作，但其他伺服器仍須啟用基礎標準 API：

  • Gmail 和 Chat 仍需使用標準 API。
  • 雲端硬碟需要標準 API 才能使用特定工具。
  • 日曆不需要啟用標準 API。
  • People API 可處理標準存取權和 MCP 功能，因此不需要啟用個別的 MCP 服務。

啟用 MCP 服務

接著，為產品啟用專屬的 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 同意畫面，並建立網頁應用程式用戶端。

Google Workspace MCP 伺服器會使用 OAuth 2.0 進行驗證。您必須先設定同意畫面。

  1. 在 Google Cloud 控制台中，依序前往「Google Auth Platform」 >「Branding」。如果尚未設定，請按一下「開始使用」。
  2. 設定「應用程式資訊」：
    • 應用程式名稱：Google Workspace MCP Servers
    • 使用者支援電子郵件地址：選取您的電子郵件地址。
  3. 設定「目標對象」：選取「內部」 (如果無法選取「內部」，請選取「外部」)。
  4. 設定「聯絡資訊」：輸入電子郵件地址。
  5. 詳閱並同意使用者資料政策，然後按一下「建立」。
  6. 如果選取「外部」，請前往「目標對象」，並在「測試使用者」下方新增電子郵件地址。
  7. 依序前往「資料存取」 >「新增或移除範圍」。在「手動新增範圍」下方，為要使用的伺服器新增下列項目：
    • 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.users.readstate.readonly
    • Google 雲端硬碟：https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/drive.file
    • Gmail：https://www.googleapis.com/auth/gmail.readonly、https://www.googleapis.com/auth/gmail.compose
    • 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.png

建立 OAuth 用戶端 ID

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

oauth_client.png

4. 設定 Antigravity

現在，請設定 Antigravity 使用這些端點。如果尚未安裝 Antigravity，請按照 Antigravity 網站上的安裝說明操作。

新增自訂 MCP 伺服器

  1. 透過編輯器服務專員面板頂端的「...」下拉式選單，開啟「MCP Servers」。

open_mcp_servers.png

  1. 依序點按「管理 MCP 伺服器」和「查看原始設定」。

manage_mcp_servers.png

  1. 使用下列自訂 MCP 伺服器設定，修改新開啟的 mcp_config.json 檔案。請先將 <YOUR_CLIENT_ID> 和 <YOUR_CLIENT_SECRET> 預留位置，替換為您在先前步驟中建立的 OAuth 用戶端 ID 和密碼：
{
  "mcpServers": {
    "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-drive": {
      "serverUrl": "https://drivemcp.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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

mcp_config.png

  1. 返回「管理 MCP 伺服器」，然後按一下「重新整理」。

configured_mcp_servers.png

驗證自訂 MCP 伺服器

  1. 透過視窗頂端的「Editor-Specific settings」(編輯器專屬設定) 選單下拉式選單，開啟「Antigravity User Settings」(Antigravity 使用者設定)。

open_user_settings.png

  1. 前往「自訂」。

customizations.png

  1. 針對「已安裝的 MCP 伺服器」下方列出的每個伺服器：
    1. 按一下「Authenticate」(驗證)。

installed_servers.png

  1. 在開啟的新瀏覽器視窗中完成驗證流程。
  2. 完成後，按一下「複製到剪貼簿」。

copy_auth_code.png

  1. 關閉瀏覽器視窗。
  2. 將剛才複製的授權碼貼到 Antigravity 設定中顯示的文字欄位。
  3. 按一下「提交」。

mcp_servers_authenticated.png

5. 測試工具

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

Google 日曆

請嘗試搜尋行程：

  • 「我這週有哪些即將舉行的會議？」
  • 「明天下午我有空嗎？」

test_prompt.png

Google Chat

請嘗試搜尋郵件：

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

Google 雲端硬碟

嘗試搜尋或閱讀檔案：

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

Gmail

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

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

People API

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

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

結合多項服務

MCP 的真正強大之處在於協調多項服務的任務。請嘗試使用下列提示詞，瞭解跨服務功能：

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

探索更多工具

以上僅列舉部分功能。如要查看各項服務的完整工具清單並試用，請參閱官方文件的「支援的產品」一節。

6. 清理

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

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

如果不再打算使用 OAuth 用戶端憑證，請在 Google 驗證平台控制台中刪除。

7. 恭喜

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

參考文件