Antigravity 中的 Google Workspace MCP 服务器

1. 简介

在此 Codelab 中，您将学习如何使用 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 已安装在本地机器上

轻松访问此 Codelab

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

chat_app.png

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

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

Google Workspace MCP 服务器使用 OAuth 2.0 进行身份验证。您必须先配置权限请求页面。

  1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 品牌宣传 。如果尚未配置，请点击开始使用 。
  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 > 客户端 > 创建客户端 。
  2. 选择 Web 应用 作为应用类型。
  3. 将该文件命名为 Antigravity。
  4. 在已获授权的重定向 URI 下，点击 + 添加 URI ，然后输入 https://antigravity.google/oauth-callback。
  5. 点击创建 ，然后复制客户端 ID 和客户端密钥 。您将在下一步中需要这些信息。

oauth_client.png

4. 配置 Antigravity

现在，让我们配置 Antigravity 以使用这些端点。如果您尚未安装 Antigravity，请按照 Antigravity 网站上的安装说明进行操作。

添加自定义 MCP 服务器

  1. 通过编辑器智能体面板顶部的 ... 下拉菜单打开 MCP 服务器 。

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. 通过窗口顶部的编辑器专用设置 菜单下拉菜单打开 Antigravity 用户设置 。

open_user_settings.png

  1. 前往自定义 。

customizations.png

  1. 对于已安装的 MCP 服务器 下列出的每个服务器：
    1. 点击身份验证 。

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 云端硬盘中搜索包含‘[KEYWORD]’的文件。”
  • “列出我最近编辑的文档。”
  • “读取我的‘[FILE_NAME]’文档的内容，并总结主要目标。”

Gmail

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

  • “总结我收到的最近 5 封电子邮件的内容。”
  • “向‘[EMAIL_ADDRESS]’起草一封电子邮件，请求提供‘[PROJECT_NAME]’项目的最新动态。”

People API

尝试搜索您的个人资料或联系人：

  • “根据我的 Google 个人资料，我的名字是什么？”
  • “查找‘[NAME]’的联系信息。”

组合使用多项服务

当您跨多项服务编排任务时，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 服务器。

参考文档