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

1. 简介

注意：您是否仍在使用 Gemini CLI？本指南介绍了 Antigravity CLI。如需详细了解如何过渡，请参阅这篇关于 Antigravity CLI 的官方博文。

正在使用 Gemini Enterprise？如果贵组织使用 Gemini Enterprise，符合条件的客户的管理员可以集中管理已获批准的 MCP 服务器，并将其列入许可清单。如需了解详情，请参阅 Antigravity Enterprise 博文和配套的 Google Workspace MCP 服务器与 Gemini Enterprise 中的 Antigravity Codelab。

在此 Codelab 中，您将学习如何使用 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 Cloud 项目中启用 Google Workspace MCP 服务。
• 配置 Antigravity 以访问这些 MCP 服务。
• 使用有趣且实用的提示测试集成，这些提示会与您的 Google Workspace 数据进行交互。

所需条件

• 网络浏览器，例如 Chrome
• 已加入 Google Workspace 开发者预览版计划的 Google Cloud 云项目
• Google Workspace 账号
• 在本地机器上安装 Antigravity 2.0、IDE 和/或 CLI。如需了解更多详情和安装指南，请访问官方网站。

轻松访问此 Codelab

2. 准备工作

Google Workspace 开发者预览版计划：Google Workspace MCP 服务器的使用权限是公开开发者预览版计划的一部分。如果您尚未注册，请访问 https://developers.google.com/workspace/preview 进行注册，并确保您的账号已获准加入该计划。

企业版前提条件：对于符合条件的客户，如果您的组织强制执行 Gemini Enterprise 政策，则您的管理员必须先在 Cloud 控制台中启用 AI 开发者工具并将 Google Workspace MCP 服务器端点列入许可名单，然后您才能进行连接。如需了解详情，请参阅 Antigravity Enterprise 博文和配套的 Google Workspace MCP 服务器与 Gemini Enterprise 中的 Antigravity Codelab。

创建或选择 Google Cloud 项目

在 Google Cloud 控制台中，选择或创建 Google Cloud 项目。

启用 API

如需使用 Google Workspace MCP 服务器，您必须启用标准 Google Workspace API。

启用 API

启用 MCP 服务

接下来，启用 Google Workspace MCP 服务。

启用 MCP 服务

配置 Chat 应用

如需使用 Google Chat MCP 服务器，您必须在 Google Cloud 项目中配置 Chat 应用。

1. 在 Google Cloud 控制台中，搜索 Google Chat API，然后依次点击 Google Chat API > 管理 > 配置。

前往 Google Chat API

2. 设置 Chat 应用：
   • 在应用名称字段中，输入 Chat MCP。
   • 在头像网址字段中，输入 https://developers.google.com/chat/images/quickstart-app-avatar.png。
   • 在说明中，输入 Chat MCP server。
   • 在功能下，关闭启用互动功能。
   • 在日志下，选择将错误记录到 Logging。
3. 点击保存。

3. 配置 OAuth 权限请求和客户端

企业版注意事项：在企业 Google Workspace 环境中，您的 Cloud 或 Gemini Enterprise 管理员通常会集中配置 OAuth 权限请求页面和客户端 ID。如果您的管理员已为您提供获批的客户端 ID，您可以跳过此步骤，直接前往配置 Antigravity。

Google Workspace MCP 服务器使用 OAuth 2.0 进行安全身份验证和授权。您必须配置 OAuth 权限请求页面并创建 Web 应用客户端。

设置 OAuth 权限请求页面

您必须先配置权限请求页面。

1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 品牌信息。如果尚未配置，请点击开始使用。
2. 配置应用信息：
   • 应用名称：Google Workspace MCP Servers
   • 用户支持邮箱：选择您的邮箱。
3. 配置受众群体：选择内部（如果“内部”不可用，则选择外部）。
4. 配置联系信息：输入您的邮箱。
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 客户端 ID

1. 依次前往 Google Auth Platform > 客户端 > 创建客户端。
2. 选择 Web 应用作为应用类型。
3. 将该文件命名为 Antigravity。
4. 在已获授权的重定向 URI 下，点击 + 添加 URI，然后输入 https://antigravity.google/oauth-callback。
5. 选择将此客户端用于 AI 赋能的智能体。
6. 点击创建，然后复制客户端 ID 和客户端密钥。您在下一步中需要用到这些信息。

4. 配置 Antigravity

现在，我们来配置 Antigravity 以使用这些端点。如果您尚未安装 Antigravity 2.0、IDE 和/或 CLI，请按照 Antigravity 网站上的说明进行安装。

添加自定义 MCP 服务器

Antigravity 2.0、IDE 和 CLI 共享 ~/.gemini/config/mcp_config.json 文件中的中央 MCP 配置。

1. 在您偏好的文本编辑器中打开该文件。

   注意：如果您已安装 Antigravity IDE，则可以按照以下步骤直接从该 IDE 访问文件：

   1. 通过编辑器智能体面板顶部的 … 下拉菜单打开 MCP 服务器。
   2. 依次点击管理 MCP 服务器和查看原始配置。
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 服务器进行身份验证

您应该会看到您配置的所有 MCP 服务器都已安装在 Antigravity 中：gws-universal、gws-gmail、gws-drive、gws-docs、gws-sheets、gws-slides、gws-calendar、gws-chat 和 gws-people。您需要为每个 Antigravity 平台分别对每个账号进行身份验证，因为 OAuth 令牌不是集中管理的。

排查企业政策错误：如果 MCP 服务器在点击刷新后显示 Unauthorized / Blocked by Admin Policy，则表示该服务未包含在贵组织的 Gemini Enterprise 许可清单中。请联系您的管理员添加服务终端节点，并与他们分享 Gemini Enterprise 管理员 Codelab，以便他们获取配置指南。

Antigravity 2.0

1. 点击左下角的设置。
2. 前往自定义。
3. 在已安装的 MCP 服务器下，点击刷新。

4. 对于列出的每个已安装 MCP 服务器：
   1. 点击身份验证。
   
   2. 在打开的新浏览器窗口中完成身份验证流程。
   3. 完成后，点击复制到剪贴板。
   
   4. 将您刚刚复制的授权代码粘贴到 Antigravity 2.0 设置中显示的文本字段中，然后点击提交。
   
   5. 现在，系统会显示退出按钮，而不是进行身份验证。
   

Antigravity IDE

1. 通过窗口顶部的编辑器专用设置菜单下拉列表打开 Antigravity 用户设置。

2. 前往自定义。
3. 在已安装的 MCP 服务器下，点击刷新。

4. 对于列出的每个已安装 MCP 服务器：
   1. 点击身份验证。
   
   2. 在打开的新浏览器窗口中完成身份验证流程。
   3. 完成后，点击复制到剪贴板。
   
   4. 将您刚刚复制的授权代码粘贴到 Antigravity IDE 设置中显示的文本字段中，然后点击提交。
   
   5. 现在，系统会显示退出按钮，而不是进行身份验证。
   

Antigravity CLI

1. 输入 /mcp，然后按 Enter 键。

2. 对于列出的每个 MCP 服务器：
   1. 使用向上和向下箭头键选择该选项，然后按 Enter 键。
   2. 使用向左和向右箭头键选择身份验证，然后按 Enter 键。
   
   3. 在新的浏览器窗口中打开显示的网址，然后完成身份验证流程。
   
   4. 完成后，点击复制到剪贴板。
   
   5. 将您刚刚复制的授权代码粘贴到运行 Antigravity CLI 的终端中显示的文本字段中，然后按 Enter 键。
   
   6. 现在，系统会显示已授权状态，而不是需要授权。
   

5. 测试工具

现在，您可以使用自然语言与 Google Workspace 数据进行互动。以下是每项服务的一些示例提示。

注意：请将以下提示中用方括号括起来的占位符（例如 [NAME]、[FILE_NAME]）替换为您自己的 Google Workspace 数据中的实际值。

通用

尝试在不同产品中搜索：

• “用几句话总结一下我的 Google Workspace 账号中最近发生的事情。”
• “在我的电子邮件、文档和聊天消息中查找与 [PROJECT_NAME] 相关的任何内容。”
• “我的下一场关于营销计划的会议是什么时候？关于该计划的最新备注和聊天消息有哪些？”

Gmail

尝试搜索或管理您的电子邮件：

• “总结我收到的最后 5 封邮件。”
• “起草一封邮件给‘[EMAIL_ADDRESS]’，询问‘[PROJECT_NAME]’项目的最新进展。”

Google 云端硬盘

尝试搜索或读取文件：

• “在我的 Google 云端硬盘中搜索包含‘[KEYWORD]’的文件。”
• “列出我最近编辑过的文档。”
• “阅读我的‘[FILE_NAME]’文档内容，并总结主要目标。”

Google 文档、表格和幻灯片

尝试搜索您的云端硬盘资源：

• “显示 Google 文档 [DOCS_TITLE] 的结构化内容。”
• “Read sheet Sheet1 from Google Sheet [SHEETS_TITLE]”
• “请显示 Google 幻灯片 [SLIDES_TITLE] 的语音布局。”

Google 日历

尝试搜索您的日程安排：

• “我本周有哪些即将举行的会议？”
• “我明天下午有空闲时间吗？”

Google Chat

尝试搜索消息：

• “在‘[SPACE_NAME]’中查找包含‘[KEYWORD]’的消息”

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 Auth Platform 控制台中将其删除。

7. 恭喜

恭喜！您已成功使用 Antigravity 配置并测试了官方 Google Workspace MCP 服务器。

参考文档

• Model Context Protocol (MCP) 简介
• 配置 Google Workspace MCP 服务器
• 配置 OAuth 权限请求
• Antigravity Enterprise 概览
• “在 Gemini Enterprise 中使用 Antigravity 的 Google Workspace MCP 服务器”Codelab
• Antigravity