Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

設定 Google Workspace MCP 伺服器

Google Workspace 提供遠端 Model Context Protocol (MCP) 伺服器，可讓 AI 代理安全地與 Google Workspace 資料互動。設定 Google Workspace MCP 伺服器後，Google Antigravity 和 Claude 等 AI 應用程式就能在 Gmail、Google 雲端硬碟、Google 文件、Google 試算表、Google 簡報、Google 日曆、Google Chat 和 Google Classroom 等 Google Workspace 應用程式中執行動作。每項 Google Workspace 產品都有專屬的 MCP 伺服器。

Google Workspace MCP 伺服器提供標準化方式，讓 AI 代理執行下列操作：

讀取資料：搜尋電子郵件、擷取檔案，以及列出日曆活動。
採取行動：建立電子郵件草稿、上傳檔案及安排會議。
遵循安全性：沿用與使用者相同的權限和資料治理控制項。

必要條件

加入 Google Workspace 開發人員預覽版計畫。
Google Cloud 專案。如要建立專案，請參閱「建立專案」。
MCP 用戶端，例如 Google Antigravity。
如要執行本頁中的指令，請按照下列步驟，在本機開發環境中設定 gcloud CLI：
1. 安裝 Google Cloud CLI。如果您先前已安裝 gcloud CLI，請執行 gcloud components update，確認您使用的是最新版本。
2. 如果您使用外部識別資訊提供者 (IdP)，請使用聯合身分登入 gcloud CLI。詳情請參閱「使用聯合身分登入 gcloud CLI」。
3. 初始化 gcloud CLI。
如要設定 Google Classroom MCP 伺服器，請建立 Google Classroom 測試課程，並至少加入一個測試學生帳戶。如果沒有可供測試的 Google Classroom 課程，請在 UI 中建立課程，並新增測試學生。

設定 Google Workspace MCP 伺服器

如要使用 Google Workspace MCP 伺服器，您必須在 Google Cloud 專案中啟用這些伺服器，然後設定 MCP 用戶端連線至這些伺服器。

啟用 API

如要使用 Google Workspace MCP 伺服器，您必須在 Google Cloud 雲端專案中啟用下列 API：

Gmail API
Google Drive API
Google Docs API
Google Sheets API
Google Slides API
Google Calendar API
Google Chat API
People API
Google Classroom API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.googleapis.com --project=PROJECT_ID

將 PROJECT_ID 替換為您的 Google Cloud 專案 ID。

控制台

在 Google Cloud 控制台中啟用 API：

啟用 API

啟用 MCP 服務

如要為各項 Google Workspace 產品啟用 MCP 元件，您必須在 Google Cloud 專案中啟用下列服務：

Gmail MCP API
Google Drive MCP API
Google Docs MCP API
Google Sheets MCP API
Google Slides MCP API
Google Calendar MCP API
Google Chat MCP API
People MCP API
Google Classroom MCP API

CLI

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID

將 PROJECT_ID 替換為您的 Google Cloud 專案 ID。

控制台

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

啟用 MCP 服務

設定 Chat 應用程式

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

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

前往 Google Chat API
設定 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」。
按一下「儲存」。

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

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

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

前往「Branding」(品牌宣傳)
如果您已設定 Google Auth Platform，可以在「Branding」(品牌)、「Audience」(目標對象) 和「Data Access」(資料存取權) 中，調整下列 OAuth 同意畫面設定。如果看到「尚未設定 Google 驗證平台」訊息，請按一下「開始使用」：
1. 在「App Information」(應用程式資訊) 的「App name」(應用程式名稱) 中，輸入 Workspace MCP Servers。
2. 在「User support email」(使用者支援電子郵件) 中，選取您的電子郵件地址或適當的 Google 群組。
3. 點選 [下一步]。
4. 在「Audience」(目標對象) 下方，選取「Internal」(內部)。如果無法選取「內部」，請選取「外部」。
5. 點選 [下一步]。
6. 在「Contact Information」(聯絡資訊) 下方，輸入可接收專案異動通知的電子郵件地址。
7. 點選 [下一步]。
8. 在「Finish」(完成) 部分，請詳閱《Google API 服務使用者資料政策》，然後選取「我同意《Google API 服務：使用者資料政策》」。
9. 按一下「繼續」。
10. 點選「建立」。
11. 如果使用者類型選取「外部」，請新增測試使用者：
  1. 按一下「目標對象」。
  2. 在「測試使用者」下方，按一下「新增使用者」。
  3. 輸入您的電子郵件地址和任何其他授權測試使用者，然後按一下「儲存」。
依序按一下「資料存取權」>「新增或移除範圍」。系統會顯示一個面板，列出您在 Google Cloud 雲端專案中啟用的每個 API 範圍。
1. 在「Manually add scopes」(手動新增範圍) 下方，貼上要使用的 MCP 伺服器範圍：
  - 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
    - https://www.googleapis.com/auth/chat.users.spacesettings
  - People API：
    - https://www.googleapis.com/auth/directory.readonly
    - https://www.googleapis.com/auth/userinfo.profile
    - https://www.googleapis.com/auth/contacts.readonly
  - Google Classroom：
    - https://www.googleapis.com/auth/classroom.announcements
    - https://www.googleapis.com/auth/classroom.courses.readonly
    - https://www.googleapis.com/auth/classroom.coursework.students
    - https://www.googleapis.com/auth/classroom.courseworkmaterials
    - https://www.googleapis.com/auth/classroom.rosters.readonly
    - https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
    - https://www.googleapis.com/auth/classroom.topics.readonly
2. 按一下「新增至表格」。
3. 按一下「更新」。
4. 選取應用程式所需的範圍後，在「資料存取權」頁面按一下「儲存」。

設定 MCP 用戶端

如要將 Google Workspace 遠端 MCP 伺服器新增至 MCP 用戶端，請按照用戶端的操作說明操作。

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

Antigravity

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

建立 OAuth 2.0 用戶端 ID 和密鑰：
1. 在 Google Cloud 控制台，依序前往「Google Auth Platform」>「Clients」>「Create Client」。
  
  前往「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」和「用戶端密鑰」。
開啟或建立設定檔 ~/.gemini/config/mcp_config.json。

將 mcpServers 設定新增至 mcp_config.json：

{
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "classroom": {
      "serverUrl": "https://classroommcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

更改下列內容：

OAUTH_CLIENT_ID：您建立的用戶端 ID。
OAUTH_CLIENT_SECRET：您建立的用戶端密鑰。

現省 mcp_config.json。
驗證 MCP 伺服器。您可以使用 GUI 設定或 CLI 進行驗證：
- Antigravity IDE 或 GUI (Antigravity 2.0)：
  1. 開啟設定畫面 (例如點選左下方的「Settings」，或開啟「Antigravity User Settings」)。
  2. 前往「自訂」。
  3. 在「已安裝的 MCP 伺服器」下方，點按「重新整理」。
  4. 針對列出的每個伺服器 (gmail、drive、docs、sheets、slides、calendar、chat、people 和 classroom)，按一下「Authenticate」(驗證)，登入 Google 帳戶，複製授權碼，將其貼到輸入對話方塊中，然後按一下「Submit」(提交)。
- Antigravity CLI：
  1. 啟動 Antigravity CLI：
```
agy
```
  2. 執行下列指令，開啟互動式 MCP 管理面板：
```
/mcp
```
  3. 驗證各個 MCP 伺服器：
    1. 使用方向鍵選取伺服器，移至「Authenticate」(驗證) 動作，然後按下 Enter 鍵。在瀏覽器中完成登入流程，複製授權碼，貼到終端機提示中，然後按下 Enter 鍵。
    2. 針對您設定的每個伺服器 (gmail、drive、docs、sheets、slides、calendar、chat、people 和 classroom) 重複執行這些步驟。
確認伺服器已正確設定並運作：
- Antigravity IDE 或 GUI：依序前往「Customizations」>「Installed MCP Servers」，每個 MCP 伺服器旁都會顯示「Sign out」按鈕。
- Antigravity CLI：開啟 /mcp 面板，查看已設定的 MCP 伺服器。在互動式 TUI 面板中，經過驗證和驗證的伺服器名稱旁會顯示「Authed」。您可以在資訊主頁檢視畫面中選取任何伺服器，檢查其狀態並列出所有可用工具。

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

Claude

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

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

建立 OAuth 2.0 用戶端 ID 和密鑰：
1. 在 Google Cloud 控制台，依序前往「Google Auth Platform」>「Clients」>「Create Client」。
  
  前往「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」和「用戶端密鑰」。
在 Claude 中設定 MCP 伺服器：
1. 在 Claude.ai 或 Claude Desktop 中，依序前往「Settings」>「Connectors」或「Admin settings」>「Connectors」。
2. 按一下「新增自訂連接器」。
3. 輸入要新增的 Google Workspace 產品連線詳細資料：
  - 伺服器名稱：伺服器的名稱，例如 Gmail。
  - 遠端 MCP 伺服器網址：Google Workspace 產品的網址，例如：
    - Gmail：https://gmailmcp.googleapis.com/mcp/v1
    - Google 雲端硬碟：https://drivemcp.googleapis.com/mcp/v1
    - Google 文件：https://docsmcp.googleapis.com/mcp/v1
    - Google 試算表：https://sheetsmcp.googleapis.com/mcp/v1
    - Google 簡報：https://slidesmcp.googleapis.com/mcp/v1
    - Google 日曆：https://calendarmcp.googleapis.com/mcp/v1
    - Google Chat：https://chatmcp.googleapis.com/mcp/v1
    - People API：https://people.googleapis.com/mcp/v1
    - Google Classroom：https://classroommcp.googleapis.com/mcp/v1
4. 在「進階設定」中，輸入 OAuth 用戶端 ID 和 OAuth 用戶端密鑰。
5. 按一下 [新增]。
6. 針對要新增的每個 Google Workspace 產品重複執行上述步驟。

其他

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

伺服器名稱：googleworkspace
伺服器：每項 Google Workspace 產品都有專屬的伺服器網址：
- Gmail：https://gmailmcp.googleapis.com/mcp/v1
- Google 雲端硬碟：https://drivemcp.googleapis.com/mcp/v1
- Google 文件：https://docsmcp.googleapis.com/mcp/v1
- Google 試算表：https://sheetsmcp.googleapis.com/mcp/v1
- Google 簡報：https://slidesmcp.googleapis.com/mcp/v1
- Google 日曆：https://calendarmcp.googleapis.com/mcp/v1
- Google Chat：https://chatmcp.googleapis.com/mcp/v1
- People API：https://people.googleapis.com/mcp/v1
- Google Classroom：https://classroommcp.googleapis.com/mcp/v1
傳輸：可串流 HTTP
驗證：Google Workspace 遠端 MCP 伺服器使用 OAuth 2.0。建立 OAuth 2.0 用戶端時，請選取「讓 AI 輔助代理使用這個用戶端」。詳情請參閱「瞭解驗證和授權」。

MCP 用戶端需要更新權杖，使用者才不必每小時重新登入。只有在授權要求包含 access_type=offline 時，Google 的 OAuth 2.0 伺服器才會核發更新權杖。如果只要求 OpenID Connect (OIDC) offline_access 範圍，則不會傳回 ID 權杖。如果 MCP 用戶端支援自訂授權參數，請在授權要求中加入 access_type=offline。如要為已授予存取權的使用者取得新的更新權杖，請一併新增 prompt=consent。如果 MCP 用戶端不支援自訂授權參數，使用者就必須在每次存取權杖到期時重新登入。詳情請參閱「重新整理存取權杖」。

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

新增 Developer Knowledge MCP 伺服器

開發人員知識 MCP 伺服器是遠端伺服器，可搜尋即時的官方 Google Developers 說明文件 (包括 developers.google.com/workspace)，讓 AI 代理查詢目前的 API 方法、OAuth 範圍和程式碼範例，而不必只依賴訓練資料。這個伺服器提供 search_documents、get_documents 和 answer_query 工具，並與 Google Workspace MCP 伺服器相輔相成，讓代理能對 Google Workspace 資料執行操作。新增 Developer Knowledge MCP 伺服器後，代理就能根據最新說明文件，回答有關使用 Google Workspace API 建構的問題。

如要將這個伺服器新增至 AI 應用程式，請按照「設定 IDE 或程式設計代理」一節的說明操作，並選取用戶端。為協助代理決定何時搜尋文件，以及要使用哪項工具，請一併安裝 retrieving-developer-knowledge 代理技能。

測試 Google Workspace MCP 伺服器

設定 MCP 用戶端後，您可以執行一些測試提示詞，驗證連線是否正常。

試著向 MCP 用戶端提出下列問題：

「Ariel 在上一封電子郵件中，對我們的行銷計畫有何看法？」

用戶端會使用 gmail.search_threads 篩選 Ariel 的電子郵件，並透過 gmail.get_thread 擷取最新討論串的內容，然後為您提供摘要。
「草擬一封電子郵件給 ariel@example.com，說明我核准了行銷企劃。」

用戶端會使用 gmail.create_draft 在草稿資料夾中建立電子郵件，方便您在 Gmail 中查看及傳送。
「生成『行銷企劃』檔案的摘要。」

用戶端會呼叫 drive.search_files 找出「行銷計畫」，然後使用 drive.read_file_content 擷取並摘要內容。
「顯示 Google 文件會議記錄的結構內容。」

用戶端會使用 docs.read_doc 擷取文件結構和內容。
「讀取 Google 試算表『季度銷售』中的『工作表 1』。」

用戶端會使用 sheets.get_values 擷取格線值。
「顯示 Google 簡報檔案『產品總覽』的口述版面配置。」

用戶端會使用 slides.read_presentation 擷取簡報視覺版面配置結構。
「我下次和 Ariel 開會是什麼時候？」

用戶端會使用 calendar.list_events 檢查您的時間表，並提供您與 Ariel 下次會議的詳細資料。
「根據我的 Google 個人資料，我叫什麼名字？」

用戶端會使用 people.get_user_profile 擷取您的 Google Workspace 個人資料。
「我目前教授哪些課程？」

用戶端會使用 classroom.list_course_summaries 檢查您的時間表，並彙整您擔任老師角色的有效課程。
「為地質學課程草擬即將到來的校外教學公告。」

用戶端會使用 classroom.create_announcement 撰寫公告草稿，您可以在 Google Classroom 應用程式中查看及發布公告。
「查看官方 Google Workspace 文件，瞭解 Gmail create_draft 工具所需的 OAuth 範圍，然後草擬一封電子郵件給 ariel@example.com，確認行銷計畫。」

如果您新增了開發人員知識 MCP 伺服器，用戶端會呼叫 search_documents，在 Gmail MCP 參考文件中尋找範圍，然後使用 gmail.create_draft 建立草稿。

如果工具執行成功，且您收到相關回覆，代表 Google Workspace MCP 伺服器設定正確。

疑難排解

請參閱下列各節，解決 Google Workspace 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 代理建立獨立的 OAuth 用戶端，並保留現有用戶端用於非代理功能。

如需操作說明，請參閱「設定 MCP 用戶端」和「管理 OAuth 用戶端」。

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

如果應用程式使用具備全網域委派權限的服務帳戶進行雙足式 OAuth，則無法選取「將這個用戶端用於 AI 輔助代理」，因為服務帳戶並非在「Google Auth Platform」 >「用戶端」中管理：

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

來自 Apps Script 的要求

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

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

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

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

如果系統大約每小時提示您重新登入，表示 MCP 用戶端未收到更新權杖。只有在授權要求包含 access_type=offline 時，Google 的 OAuth 2.0 伺服器才會核發更新權杖。如果只要求 OIDC offline_access 範圍，則不會傳回 ID 權杖。

確認 MCP 用戶端是否支援自訂授權參數：

用戶端支援自訂授權參數：在授權要求中加入 access_type=offline。如要為已授予存取權的使用者取得新的更新權杖，請一併新增 prompt=consent。
用戶端不支援自訂授權參數：每次存取權杖到期時，請重新登入。

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

支援的產品

下列 Google Workspace 產品支援 Google Workspace MCP 伺服器，並提供以下工具：

重要安全考量：間接提示詞注入

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

為降低這些風險，請遵循下列最佳做法：

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

設定 Google Workspace MCP 伺服器 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

必要條件

設定 Google Workspace MCP 伺服器

啟用 API

CLI

控制台

啟用 MCP 服務

CLI

控制台

設定 Chat 應用程式

設定 OAuth 同意畫面

設定 MCP 用戶端

Antigravity

Claude

其他

新增 Developer Knowledge MCP 伺服器

測試 Google Workspace MCP 伺服器

疑難排解

查看 OAuth 記錄事件

拒絕使用者委派 OAuth 用戶端提出的要求

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

來自 Apps Script 的要求

每小時重複顯示登入提示

支援的產品

重要安全考量：間接提示詞注入

相關主題

設定 Google Workspace MCP 伺服器