配置 People API MCP 服务器

People API 提供了一个远程 Model Context Protocol (MCP) 服务器，让 AI 智能体能够安全地与 Google Workspace 个人资料和联系人数据互动。 通过配置 People API MCP 服务器，您可以让 Google Antigravity 和 Claude 等 AI 应用使用 People API 执行操作。

People API MCP 服务器为 AI 智能体提供了一种标准化方式，以便：

  • 读取数据：检索用户个人资料并搜索联系人或目录 人员。
  • 尊重安全性：继承与用户相同的权限和数据治理 控制。

前提条件

配置 People API MCP 服务器

如需使用 People API MCP 服务器，您必须在 Google Cloud 项目中启用该服务器，然后配置 MCP 客户端以连接到该服务器。

启用 API 和 MCP 服务

如需使用 People API MCP 服务器，您必须在 Google Cloud 项目中启用以下服务：

  • People API

CLI

gcloud services enable people.googleapis.com --project=PROJECT_ID

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

控制台

在 Google Cloud 控制台中启用 API：

启用 API

People API MCP 服务器使用 OAuth 2.0 进行身份验证和授权。 您必须先配置 OAuth 权限请求页面，然后才能创建 OAuth 客户端 ID。

  1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 品牌塑造 。

    前往“品牌塑造”

  2. 如果您已配置 Google Auth Platform，则可以在 “品牌塑造”“受众群体”和“数据访问权限”中配置以下 OAuth 权限请求页面设置。 如果您看到一条消息，指出尚未配置 Google Auth Platform， 请点击开始使用：

    1. 在应用信息 下的应用名称 中，输入 People API MCP Server。
    2. 在用户支持邮箱 中，选择您的电子邮件地址或相应的 Google 群组。
    3. 点击下一步 。
    4. 在受众群体 下，选择内部 。如果您无法选择内部，请选择外部。
    5. 点击下一步 。
    6. 在联系信息下，输入一个电子邮件地址，以便您 接收有关项目变更的通知。
    7. 点击下一步 。
    8. 在完成 部分，查看 Google API 服务用户数据政策 ，如果您同意该政策，请选择 我同意 Google API 服务：用户数据政策。
    9. 点击继续 。
    10. 点击创建 。
    11. 如果您为用户类型选择了外部 ，请添加测试用户：
      1. 点击受众群体。
      2. 在测试用户 下，点击 Add users （添加用户）。
      3. 输入您的电子邮件地址和任何其他已获授权的测试用户，然后点击保存 。

  3. 依次点击数据访问权限 > 添加或移除范围 。系统会显示一个面板，其中列出了您在 Google Cloud 项目中启用的每个 API 的范围。

    1. 在手动添加范围 下，粘贴 People API MCP 服务器的范围：

      • https://www.googleapis.com/auth/directory.readonly
      • https://www.googleapis.com/auth/userinfo.profile
      • https://www.googleapis.com/auth/contacts.readonly

    2. 点击添加到表格 。

    3. 点击更新 。

    4. 选择应用所需范围后，在数据访问权限 页面上，点击保存 。

配置 MCP 客户端

如需将 People API 远程 MCP 服务器添加到 MCP 客户端，请按照客户端的说明操作。

Antigravity

如需将 People API 远程 MCP 服务器添加到 Antigravity，请将服务器配置添加到 mcp_config.json 文件中。这些说明支持 Antigravity 2.0、Antigravity IDE 和 Antigravity CLI。

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

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

      前往“创建客户端”

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

    3. 输入名称 。

    4. 在 已获授权的重定向 URI 部分中，点击 + 添加 URI, 然后在 URI 字段中添加 https://antigravity.google/oauth-callback。

    5. 选择将此客户端用于 AI 赋能的智能体 。

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

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

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

    {
  "mcpServers": {
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    替换以下内容：

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

  4. 保存 mcp_config.json。

  5. 对 MCP 服务器进行身份验证。您可以使用 GUI 设置或 CLI 进行身份验证：

    • 对于 Antigravity IDE 或 GUI (Antigravity 2.0)：

      1. 打开设置界面（例如，点击左下角的设置 或打开 Antigravity 用户设置 ）。
      2. 前往自定义 。
      3. 在已安装的 MCP 服务器 下，点击刷新 。
      4. 在列表中找到 people，点击 身份验证， 登录您的 Google 账号，复制授权代码， 将其粘贴到输入对话框中，然后点击 提交。

    • 对于 Antigravity CLI：

      1. 启动 Antigravity CLI：

        agy

      2. 运行以下命令，打开互动式 MCP 管理面板：

        /mcp

      3. 使用箭头键选择 people，移至 Authenticate 操作，然后按 Enter 键。在浏览器中完成登录流程，复制授权代码，将其粘贴到终端提示符中，然后按 Enter 键。

  6. 验证服务器是否已正确配置并正在运行：

    • 对于 Antigravity IDE 或 GUI： Sign out 按钮会显示在自定义 > 已安装的 MCP 服务器 下的服务器旁边。
    • 对于 Antigravity CLI： 打开 /mcp 面板以查看您配置的 MCP 服务器。经过验证和身份验证的服务器会在互动式 TUI 面板中其名称旁边显示 Authed 。 您可以在信息中心视图下选择任何服务器，以检查其状态并列出其所有可用工具。

远程 MCP 服务器已准备好在 Antigravity 中使用。

Claude

如需将 People API 远程 MCP 服务器与 Claude.ai 或 Claude Desktop 搭配使用，您必须拥有 Claude 企业版、Pro 版、Max 版或团队版方案。

如需将 People API 远程 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. 选择将此客户端用于 AI 赋能的智能体 。

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

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

    1. 在 Claude.ai 或 Claude Desktop 中，依次前往设置 （或管理员设置 ）> 连接器 。
    2. 点击 Add custom connector （添加自定义连接器）。
    3. 输入 People API 产品的连接详细信息：
      • 服务器名称：people。
      • 远程 MCP 服务器网址： https://people.googleapis.com/mcp/v1
    4. 在高级设置中，输入您的OAuth 客户端 ID和 OAuth 客户端密钥。
    5. 点击添加 。

其他

许多 AI 应用都有连接到远程 MCP 服务器的方式。您通常需要输入有关服务器的详细信息，例如其名称、端点、传输协议和身份验证方法。对于 People API 远程 MCP 服务器，请输入以下内容：

  • 服务器名称: people

  • 服务器网址：https://people.googleapis.com/mcp/v1

  • 传输：可流式传输的 HTTP

  • 身份验证：People API 远程 MCP 服务器 使用 OAuth 2.0。创建 OAuth 2.0 客户端时，请选择将此客户端用于 AI 赋能的智能体 。如需了解详情，请参阅 了解身份验证和授权。

如需详细了解如何连接不同类型的客户端，请参阅 在 AI 应用中配置 MCP。

测试 People API MCP 服务器

配置 MCP 客户端后，您可以运行一些测试提示来验证连接。

尝试向 MCP 客户端提出以下问题：

  • “根据我的 Google 个人资料，我的名字是什么？”

    客户端使用 people.get_user_profile 检索您的 Google Workspace 个人资料信息。

如果工具成功执行并收到相关响应，则说明您的 People API MCP 服务器已正确配置。

问题排查

如果您在连接到 MCP 服务器时遇到问题，可以在 OAuth 日志中检查错误。请让管理员在 安全调查工具中检查 OAuth 日志事件。

工具参考文档

以下工具可用于 People API MCP 服务器：

  • get_user_profile
  • search_contacts
  • search_directory_people

重要安全注意事项：间接提示注入

当您将语言模型公开给不受信任的数据时，存在 间接提示注入攻击的风险。 由于 Google Antigravity 等 MCP 主机可以通过 People API MCP 服务器访问强大的工具和 API，因此它们可以读取您 Google 账号中的数据。

为降低这些风险，您必须筛选提示和响应，以查找恶意内容或提示注入攻击。您可以使用 Google 提供的 Model Armor，也可以使用您自己的解决方案（如果您记录了该解决方案，以便用户接受该风险）。如需了解详情，请参阅 为 Google Workspace MCP 服务器配置安全性。

请遵循以下最佳做法：

  • 仅使用受信任的工具。切勿将 People API MCP 服务器连接到不受信任或未经验证的应用。
  • 谨慎处理不受信任的输入。避免要求 MCP 客户端处理来自未经验证来源的资源。这些输入可能包含隐藏的指令，这些指令可能会劫持您的会话，让攻击者能够修改、窃取或删除您的数据。
  • 检查所有操作。请务必仔细检查 AI 客户端代表您执行的操作，确保这些操作正确无误且符合您的意图。