配置 Google Workspace MCP 服务器

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
people.googleapis.com --project=PROJECT_ID

将 PROJECT_ID 替换为您的 Google Cloud 项目 ID。

控制台

在 Google Cloud 控制台中启用 API：

启用 API

CLI

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
calendarmcp.googleapis.com \
people.googleapis.com --project=PROJECT_ID

将 PROJECT_ID 替换为您的 Google Cloud 项目 ID。

控制台

在 Google Cloud 控制台中启用 MCP 服务：

启用 MCP 服务

Gemini CLI

如需将 Google Workspace 远程 MCP 服务器添加到 Gemini CLI，请将服务器配置添加到 settings.json 文件。

1. 创建 OAuth 2.0 客户端 ID 和密钥：

   1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端

      前往“创建客户端”

   2. 选择桌面应用作为应用类型。

   3. 输入名称。

   4. 点击创建，然后复制您的客户端 ID 和客户端密钥。

2. 打开或创建配置文件 ~/.gemini/settings.json。

3. 将 mcpServers 配置添加到 settings.json：

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

   替换以下内容：

   • OAUTH_CLIENT_ID：您创建的客户端 ID。
   • OAUTH_CLIENT_SECRET：您创建的客户端密钥。

4. 可享受 settings.json 的优惠。

5. 启动 Gemini CLI：

   gemini
   

6. 在 Gemini CLI 中，通过运行以下命令向每个 MCP 服务器进行身份验证：

   /mcp auth gmail
   

   1. 出现提示时，按 1 在浏览器中打开身份验证页面。如果您是通过 SSH 进行操作，请按照 CLI 中的说明操作。
   2. 登录您的 Google 账号。
   3. 查看所请求的 OAuth 范围，然后点击允许。
   4. 系统会显示一条消息，确认身份验证成功。

   5. 针对每个 MCP 服务器重复执行以下操作：

      • /mcp auth drive
      • /mcp auth calendar
      • /mcp auth people

7. 在 Gemini CLI 中，运行 /mcp list 以查看已配置的 MCP 服务器及其工具。

   响应类似于以下示例：

   🟢 gmail - Ready (9 tools)
     Tools:
     - create_draft
     - get_thread
     - label_message
     - label_thread
     - list_drafts
     - list_labels
     - search_threads
     - unlabel_message
     - unlabel_thread
   
   🟢 drive - Ready (7 tools)
     Tools:
     - create_file
     - download_file_content
     - get_file_metadata
     - get_file_permissions
     - list_recent_files
     - read_file_content
     - search_files
   
   🟢 calendar - Ready (8 tools)
     Tools:
     - create_event
     - delete_event
     - get_event
     - list_calendars
     - list_events
     - respond_to_event
     - suggest_time
     - update_event
   
   🟢 people - Ready (3 tools)
     Tools:
     - get_user_profile
     - search_contacts
     - search_directory_people
   

远程 MCP 服务器已可在 Gemini CLI 中使用。

Claude

如需将 Google Workspace 远程 MCP 服务器与 Claude.ai 或 Claude Desktop 搭配使用，您必须拥有 Claude Enterprise、Pro、Max 或 Team 方案。

如需将 Google Workspace 远程 MCP 服务器添加到 Claude，请使用 OAuth 客户端 ID 和密钥配置自定义连接器。

1. 创建 OAuth 2.0 客户端 ID 和密钥：

   1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端

      前往“创建客户端”

   2. 选择 Web 应用作为应用类型。

   3. 输入名称。

   4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中添加 https://claude.ai/api/mcp/auth_callback。

   5. 点击创建，然后复制您的客户端 ID 和客户端密钥。

2. 在 Claude 中配置 MCP 服务器：

   1. 在 Claude.ai 或 Claude Desktop 中，依次前往设置（或管理设置）> 连接器。
   2. 点击添加自定义连接器。
   3. 输入要添加的 Google Workspace 产品的连接详细信息：
      • 服务器名称：服务器的名称，例如 Gmail。
      • 远程 MCP 服务器网址：Google Workspace 产品的网址，例如以下网址之一：
        • Gmail：https://gmailmcp.googleapis.com/mcp/v1
        • Google 云端硬盘：https://drivemcp.googleapis.com/mcp/v1
        • Google 日历：https://calendarmcp.googleapis.com/mcp/v1
        • People API：https://people.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://calendarmcp.googleapis.com/mcp/v1
  • People API：https://people.googleapis.com/mcp/v1

• 传输：HTTP

• 身份验证：Google Workspace 远程 MCP 服务器使用 OAuth 2.0。如需了解详情，请参阅了解身份验证和授权。