Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

People API MCP サーバーを構成する

People API は、AI エージェントが Google Workspace のプロフィールデータや連絡先データと安全にやり取りできるリモート Model Context Protocol（MCP）サーバーを提供します。People API MCP サーバーを構成すると、Google Antigravity や Claude などの AI アプリケーションで People API を使用してアクションを実行できるようになります。

People API MCP サーバーは、AI エージェントが次のことを行うための標準化された方法を提供します。

データの読み取り: ユーザープロフィールの取得、連絡先やディレクトリのユーザーの検索。
セキュリティの尊重: ユーザーと同じ権限とデータガバナンスコントロールを継承。

前提条件

Google Workspace デベロッパープレビュープログラムのメンバーシップ。
Google Cloud プロジェクトプロジェクトを作成するには、プロジェクトを作成するをご覧ください。
Google Antigravity などの MCP ホスト。
このページにあるコマンドを実行するには、次の手順でローカル開発環境に gcloud CLI を設定します。
1. Google Cloud CLI をインストールします。すでに gcloud CLI をインストールしている場合は、最新バージョンがインストールされていることを確認してください。gcloud components update
2. 外部 ID プロバイダ（IdP）を使用している場合は、フェデレーション ID を使用して gcloud CLI にログインします。詳細については、フェデレーション ID を使用して gcloud CLI にログインするをご覧ください。
3. gcloud CLI を初期化します。

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 に置き換えます。

Console

Google Cloud コンソールで API を有効にします。

API を有効にする

People API MCP サーバーは、認証と認可に OAuth 2.0 を使用します。 OAuth クライアント ID を作成する前に、OAuth 同意画面を構成する必要があります。

Google Cloud コンソールで、[Google Auth Platform] > [ブランディング] に移動します。

[ブランディング] に移動
[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. [テストユーザー] で [ユーザーを追加] をクリックします。
  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 をサポートしています。

OAuth 2.0 クライアント ID とシークレットを作成します。
1. Google Cloud コンソールで、[Google Auth Platform] > [クライアント] > [クライアントを作成] に移動します。
  
  [クライアントを作成] に移動
2. アプリケーションの種類として [ウェブアプリケーション] を選択します。
3. 名前を入力します。
4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、 https://antigravity.google/oauth-callback を [URI] フィールドに追加します。
5. [このクライアントを AI 搭載エージェントに使用する] を選択します。
6. [作成] をクリックして、クライアント ID とクライアントシークレット をコピーします。
構成ファイル ~/.gemini/config/mcp_config.json を開くか、作成します。

mcp_config.json に mcpServers 構成を追加します。

{
  "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: 作成したクライアントシークレット。

mcp_config.json を保存します。
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 キーを押します。
サーバーが正しく構成され、実行されていることを確認します。
- Antigravity IDE または GUI の場合: [カスタマイズ] > [インストール済み MCP サーバー] のサーバーの横に [ログアウト] ボタンが表示されます。
- Antigravity CLI の場合: /mcp パネルを開いて、構成済みの MCP サーバーを表示します。検証および認証済みのサーバーは、インタラクティブな TUI パネル内の名前の横に [Authed] と表示されます。ダッシュボードビューでサーバーを選択すると、そのステータスを確認し、利用可能なすべてのツールを一覧表示できます。

リモート MCP サーバーは Antigravity で使用できるようになりました。

Claude

Claude.ai または Claude Desktop で People API リモート MCP サーバーを使用するには、Claude Enterprise、Pro、Max、Team プランが必要です。

People API リモート MCP サーバーを Claude に追加するには、OAuth クライアント ID とシークレットを使用してカスタムコネクタを構成します。

OAuth 2.0 クライアント ID とシークレットを作成します。
1. Google Cloud コンソールで、[Google Auth Platform] > [クライアント] > [クライアントを作成] に移動します。
  
  [クライアントを作成] に移動
2. アプリケーションの種類として [ウェブアプリケーション] を選択します。
3. 名前を入力します。
4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、 https://claude.ai/api/mcp/auth_callback を [URI] フィールドに追加します。
5. [このクライアントを AI 搭載エージェントに使用する] を選択します。
6. [作成] をクリックして、クライアント ID とクライアントシークレット をコピーします。
Claude で MCP サーバーを構成します。
1. Claude.ai または Claude Desktop で、[Settings]（または [Admin settings]）> [Connectors] に移動します。
2. [Add custom connector] をクリックします。
3. People API プロダクトの接続の詳細を入力します。
  - サーバー名: people。
  - リモート MCP サーバーの URL: https://people.googleapis.com/mcp/v1
4. [Advanced settings] で、[OAuth クライアント ID] と [OAuth クライアントシークレット] を入力します。
5. [追加] をクリックします。

その他

多くの AI アプリケーションには、リモート MCP サーバーに接続する方法があります。通常、サーバー名、エンドポイント、トランスポートプロトコル、認証方法などのサーバーの詳細を入力する必要があります。People API リモート MCP サーバーの場合は、次の情報を入力します。

サーバー名: people
サーバー URL: 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 クライアントがユーザーに代わって実行したアクションを常に慎重に確認し、それらが正しく、ユーザーの意図に沿っていることを確認してください。

People API MCP サーバーを構成する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

前提条件

People API MCP サーバーを構成する

API と MCP サービスを有効にする

CLI

Console

OAuth 同意画面を設定する

MCP クライアントを構成する

Antigravity

Claude

その他

People API MCP サーバーをテストする

トラブルシューティング

ツール リファレンス

セキュリティに関する重要な考慮事項: 間接的なプロンプト インジェクション

関連トピック

People API MCP サーバーを構成する

ツールリファレンス

セキュリティに関する重要な考慮事項: 間接的なプロンプトインジェクション