設定 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」>「Clients」>「Create Client」。

      前往「建立用戶端」

   2. 將應用程式類型設為「Web application」(網頁應用程式)。

   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 User Settings」)。
     2. 前往「自訂」。
     3. 在「已安裝的 MCP 伺服器」下方，按一下「重新整理」。
     4. 在清單中找出 people，按一下「驗證」，登入 Google 帳戶，複製授權碼，貼到輸入對話方塊中，然後按一下「提交」。

   • Antigravity CLI：

     1. 啟動 Antigravity CLI：

        agy
        

     2. 執行下列指令，開啟互動式 MCP 管理面板：

        /mcp
        

     3. 使用方向鍵選取 people，移至「Authenticate」動作，然後按下 Enter 鍵。在瀏覽器中完成登入流程，複製授權碼，貼到終端機提示中，然後按下 Enter 鍵。

6. 確認伺服器已正確設定並正在執行：

   • Antigravity IDE 或 GUI：「自訂」 >「已安裝的 MCP 伺服器」下方會顯示伺服器，旁邊有「登出」按鈕。
   • Antigravity CLI：開啟 /mcp 面板，查看已設定的 MCP 伺服器。經過驗證和驗證的伺服器會在互動式 TUI 面板中，於名稱旁顯示「已驗證」。您可以選取資訊主頁檢視畫面中的任何伺服器，檢查其狀態並列出所有可用工具。

您可以在 Antigravity 中使用遠端 MCP 伺服器。

Claude

如要透過 Claude.ai 或 Claude Desktop 使用 People API 遠端 MCP 伺服器，您必須訂閱 Claude Enterprise、Pro、Max 或 Team 方案。

如要將 People API 遠端 MCP 伺服器新增至 Claude，請使用 OAuth 用戶端 ID 和密鑰設定自訂連接器。

1. 建立 OAuth 2.0 用戶端 ID 和密鑰：

   1. 在 Google Cloud 控制台中，依序前往「Google Auth Platform」>「Clients」>「Create Client」。

      前往「建立用戶端」

   2. 將應用程式類型設為「Web application」(網頁應用程式)。

   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。詳情請參閱「瞭解驗證和授權」。