配置 People API MCP 服务器

CLI

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

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

控制台

在 Google Cloud 控制台中启用 API：

启用 API

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. 点击创建，然后复制您的客户端 ID 和客户端密钥。

2. 打开或创建配置文件 ~/.gemini/antigravity/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，移动到身份验证操作，然后按 Enter。在浏览器中完成登录流程，复制授权代码，将其粘贴到终端提示中，然后按 Enter 键。

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

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

远程 MCP 服务器已准备就绪，可在 Antigravity 中使用。

Claude

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

如需将 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. 点击创建，然后复制您的客户端 ID 和客户端密钥。

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

   1. 在 Claude.ai 或 Claude Desktop 中，依次前往设置（或管理设置）> 连接器。
   2. 点击添加自定义连接器。
   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。如需了解详情，请参阅了解身份验证和授权。