開始使用 Google Workspace MCP 和 Gemini CLI

1. 簡介

注意：您是否仍在使用 Gemini CLI？請前往這個程式碼實驗室，瞭解如何改用 Antigravity CLI 設定 Google Workspace MCP 伺服器。如要進一步瞭解這項轉換，請參閱這篇官方網誌文章。

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

學習內容

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

軟硬體需求

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

完成這個程式碼實驗室大約需要 30 分鐘。

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

2. 事前準備

Google Workspace 開發人員預覽版計畫：Google Workspace MCP 伺服器存取權是公開開發人員預覽版計畫的一部分。如果尚未註冊，請前往 https://developers.google.com/workspace/preview 註冊，並確認帳戶已獲准加入計畫。

建立或選取 Google Cloud 專案

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

啟用 API

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

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

啟用 API

啟用 MCP 服務

接著，啟用產品專屬的 MCP 服務。

啟用 MCP 服務

設定 Chat 應用程式

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

1. 在 Google Cloud 控制台中搜尋「Google Chat API」，然後依序點選「Google Chat API」>「管理」>「設定」。前往 Google Chat API
2. 設定 Chat 擴充應用程式：
   • 在「App name」欄位中輸入 Chat MCP。
   • 在「Avatar URL」欄位中輸入 https://developers.google.com/chat/images/quickstart-app-avatar.png。
   • 在「Description」(說明) 中輸入 Chat MCP server。
   • 在「功能」下方，關閉「啟用互動功能」。
   • 在「記錄」下方，選取「將錯誤記錄至 Logging」。
3. 按一下「儲存」。

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

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

設定 OAuth 同意畫面

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

1. 在 Google Cloud 控制台中，依序前往「Google Auth Platform」>「品牌」。如果尚未設定，請按一下「Get Started」(開始使用)。
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 用戶端 ID

為 Google Workspace MCP 伺服器設定 OAuth 2.0 用戶端時，必須選取「將這個用戶端用於 AI 輔助代理」，啟用代理分類設定 (is_agentic)。如果 OAuth 用戶端未啟用這項設定，就無法呼叫 Google Workspace MCP 端點。

1. 依序前往「Google Auth Platform」>「用戶端」>「建立用戶端」(或依序前往「API 和服務」>「憑證」>「建立憑證」>「OAuth 用戶端 ID」)。
2. 選取「電腦版應用程式」做為應用程式類型。
3. 將其命名為 Gemini CLI。
4. 選取「讓 AI 代理使用這個用戶端」，在 OAuth 用戶端上啟用 is_agentic 分類旗標。
5. 按一下「建立」，然後複製「用戶端 ID」和「用戶端密鑰」。下一個步驟會用到這些資訊。

4. 設定 Gemini CLI

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

必須使用本機環境：請勿使用 Cloud Shell 執行這個步驟。Gemini CLI 需要本機瀏覽器才能進行 OAuth 驗證。請使用本機電腦的終端機。詳情請參閱「瀏覽器重新導向規定」。

建立設定檔

在主目錄中開啟或建立 ~/.gemini/settings.json，並新增下列設定。將預留位置替換為您的 OAuth 憑證。

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. 驗證 MCP 伺服器

您必須先驗證 MCP 伺服器並確認連線，才能使用。

啟動 Gemini CLI

在終端機執行下列指令，啟動 Gemini CLI：

gemini

驗證

在 Gemini CLI 執行對應指令，驗證要測試的服務。您只需要驗證要在這個程式碼實驗室中使用的服務。

日曆

/mcp auth calendar

即時通訊

/mcp auth chat

雲端硬碟

/mcp auth drive

Gmail

/mcp auth gmail

社交圈成員

/mcp auth people

按照瀏覽器中的提示，授權各項服務。

驗證連線

確認工具已載入並準備就緒：

/mcp list

輸出內容應會指出服務為 Ready，並列出相關工具。

6. 測試 MCP 伺服器

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

注意：請將下列提示中以括號括住的預留位置 (例如 [NAME]、[FILE_NAME])，替換為 Google Workspace 資料中的實際值。

Google 日曆

試著問問 Gemini 你的行程：

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

Google Chat

試著問問 Gemini 搜尋訊息：

• 「在『[聊天室名稱]』中尋找含有『[關鍵字]』的訊息」

Google 雲端硬碟

試著問問 Gemini 尋找或朗讀檔案：

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

Gmail

試著問問 Gemini 搜尋或管理電子郵件：

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

People API

試著問問 Gemini 關於您的個人資料或聯絡人：

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

結合多項服務

Gemini 跨多項服務自動調度管理工作時，MCP 才能發揮真正的威力。試試以下提示，體驗跨服務功能：

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

探索更多工具

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

7. 清除

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

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

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

8. 恭喜

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

目前所學內容

• 如何在 Google Cloud 啟用 Google Workspace MCP 服務。
• 如何設定 MCP 的 OAuth 用戶端。
• 如何使用 Gemini CLI，透過標準工具與 Google Workspace 資料互動。

參考文件

• Model Context Protocol (MCP) 簡介
• 設定 Google Workspace MCP 伺服器
• 設定 OAuth 同意畫面