MCP-Server für die People API konfigurieren

Die People API bietet einen Remote-MCP-Server (Model Context Protocol), der es KI-Agenten ermöglicht, sicher mit Google Workspace-Profil- und Kontaktdaten zu interagieren. Wenn Sie den MCP-Server der People API konfigurieren, können KI-Anwendungen wie Google Antigravity und Claude Aktionen über die People API ausführen.

Der People API MCP-Server bietet KI-Agenten eine standardisierte Möglichkeit,

  • Daten lesen: Nutzerprofile abrufen und in Kontakten oder im Verzeichnis nach Personen suchen.
  • Sicherheit beachten: Die Berechtigungen und Data Governance-Einstellungen des Nutzers werden übernommen.

Vorbereitung

MCP-Server für die People API konfigurieren

Wenn Sie den People API-MCP-Server verwenden möchten, müssen Sie ihn in Ihrem Google Cloud-Projekt aktivieren und dann Ihren MCP-Client so konfigurieren, dass er eine Verbindung zu ihm herstellt.

API und MCP-Dienst aktivieren

Wenn Sie den People API MCP-Server verwenden möchten, müssen Sie den folgenden Dienst in Ihrem Google Cloud-Projekt aktivieren:

  • People API

Befehlszeile

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

Ersetzen Sie PROJECT_ID durch die Google Cloud-Projekt-ID.

Console

Aktivieren Sie die APIs in der Google Cloud Console:

APIs aktivieren

Der MCP-Server der People API verwendet OAuth 2.0 für die Authentifizierung und Autorisierung. Sie müssen den OAuth-Zustimmungsbildschirm konfigurieren, bevor Sie eine OAuth-Client-ID erstellen können.

  1. Rufen Sie in der Google Cloud Console Google Auth Platform > Branding auf.

    Zum Branding

  2. Wenn Sie die Google Auth Platform bereits konfiguriert haben, können Sie die folgenden Einstellungen für den OAuth-Zustimmungsbildschirm unter Branding, Zielgruppe und Datenzugriff konfigurieren. Wenn Sie die Meldung Google Auth Platform noch nicht konfiguriert sehen, klicken Sie auf Jetzt starten:

    1. Geben Sie unter App-Informationen bei App-Name People API MCP Server ein.
    2. Wählen Sie unter E-Mail-Adresse für den Nutzersupport Ihre E-Mail-Adresse oder eine geeignete Google-Gruppe aus.
    3. Klicken Sie auf Weiter.
    4. Wählen Sie unter Zielgruppe die Option Intern aus. Wenn Sie Intern nicht auswählen können, wählen Sie Extern aus.
    5. Klicken Sie auf Weiter.
    6. Geben Sie unter Kontaktdaten eine E-Mail-Adresse ein, unter der Sie über Änderungen an Ihrem Projekt informiert werden können.
    7. Klicken Sie auf Weiter.
    8. Sehen Sie sich unter Abschließen die Nutzerdatenrichtlinie für Google API-Dienste an. Wenn Sie damit einverstanden sind, wählen Sie Ich akzeptiere die Richtlinie zu Nutzerdaten für Google API-Dienste aus.
    9. Klicken Sie auf Weiter.
    10. Klicken Sie auf Erstellen.
    11. Wenn Sie als Nutzertyp Extern ausgewählt haben, fügen Sie Testnutzer hinzu:
      1. Klicken Sie auf Zielgruppe.
      2. Klicken Sie unter Testnutzer auf Nutzer hinzufügen.
      3. Geben Sie Ihre E‑Mail-Adresse und die E‑Mail-Adressen aller anderen autorisierten Testnutzer ein und klicken Sie auf Speichern.

  3. Klicken Sie auf Datenzugriff > Bereiche hinzufügen oder entfernen. Ein Bereich mit einer Liste der Bereiche für jede API, die Sie in Ihrem Google Cloud-Projekt aktiviert haben, wird angezeigt.

    1. Fügen Sie unter Bereiche manuell hinzufügen die Bereiche für den People API MCP-Server ein:

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

    2. Klicken Sie auf Zur Tabelle hinzufügen.

    3. Klicken Sie auf Aktualisieren.

    4. Nachdem Sie die für Ihre App erforderlichen Bereiche ausgewählt haben, klicken Sie auf der Seite Datenzugriff auf Speichern.

MCP-Client konfigurieren

Wenn Sie den Remote-MCP-Server für die People API zu Ihrem MCP-Client hinzufügen möchten, folgen Sie der Anleitung für Ihren Client.

Antigravity

Wenn Sie den Remote-MCP-Server der People API zu Antigravity hinzufügen möchten, fügen Sie die Serverkonfiguration in Ihre mcp_config.json-Datei ein. Diese Anleitung unterstützt Antigravity 2.0, Antigravity IDE und Antigravity CLI.

  1. So erstellen Sie eine OAuth 2.0-Client-ID und ein Secret:

    1. Rufen Sie in der Google Cloud Console Google Auth Platform > Clients > Create Client auf.

      Zur Seite „Client erstellen“

    2. Wählen Sie als Anwendungstyp Webanwendung aus.

    3. Geben Sie einen Namen ein.

    4. Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und fügen Sie dann https://antigravity.google/oauth-callback in das Feld URIs ein.

    5. Klicken Sie auf Erstellen und kopieren Sie Ihre Client-ID und Ihren Clientschlüssel.

  2. Öffnen oder erstellen Sie die Konfigurationsdatei ~/.gemini/antigravity/mcp_config.json.

  3. Fügen Sie die mcpServers-Konfiguration zu mcp_config.json hinzu:

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

    Ersetzen Sie Folgendes:

    • OAUTH_CLIENT_ID: Die von Ihnen erstellte Client-ID.
    • OAUTH_CLIENT_SECRET: Der von Ihnen erstellte Clientschlüssel.

  4. mcp_config.json sparen.

  5. Authentifiziere den MCP-Server. Sie können sich entweder über die GUI-Einstellungen oder über die CLI authentifizieren:

    • Für Antigravity IDE oder GUI (Antigravity 2.0):

      1. Öffnen Sie die Einstellungen (z.B. durch Klicken auf Einstellungen unten links oder durch Öffnen der Antigravity-Nutzereinstellungen).
      2. Gehe zu Anpassungen.
      3. Klicken Sie unter Installierte MCP-Server auf Aktualisieren.
      4. Suchen Sie in der Liste nach people, klicken Sie auf Authentifizieren, melden Sie sich in Ihrem Google-Konto an, kopieren Sie den Autorisierungscode, fügen Sie ihn in das Eingabefeld ein und klicken Sie auf Senden.

    • Für die Antigravity CLI:

      1. Starten Sie die Antigravity CLI:

        agy

      2. Öffnen Sie das interaktive MCP-Verwaltungsfeld mit folgendem Befehl:

        /mcp

      3. Wählen Sie mit den Pfeiltasten people aus, gehen Sie zur Aktion Authentifizieren und drücken Sie die Eingabetaste. Schließen Sie den Anmeldevorgang in Ihrem Browser ab, kopieren Sie den Autorisierungscode, fügen Sie ihn in die Terminaleingabeaufforderung ein und drücken Sie die Eingabetaste.

  6. Prüfen Sie, ob der Server richtig konfiguriert ist und ausgeführt wird:

    • Für die Antigravity IDE oder GUI:Unter Customizations > Installed MCP Servers (Anpassungen > Installierte MCP-Server) wird neben dem Server die Schaltfläche Sign out (Abmelden) angezeigt.
    • Für die Antigravity CLI:Öffnen Sie den Bereich /mcp, um die konfigurierten MCP-Server aufzurufen. Bei verifizierten und authentifizierten Servern wird im interaktiven TUI-Bereich neben dem Namen Authed angezeigt. Sie können in der Dashboard-Ansicht einen beliebigen Server auswählen, um seinen Status und eine Liste aller verfügbaren Tools aufzurufen.

Der Remote-MCP-Server kann jetzt in Antigravity verwendet werden.

Claude

Wenn Sie den Remote-MCP-Server der People API mit Claude.ai oder Claude Desktop verwenden möchten, benötigen Sie ein Claude Enterprise-, Pro-, Max- oder Team-Abo.

Wenn Sie den Remote-MCP-Server für die People API zu Claude hinzufügen möchten, konfigurieren Sie einen benutzerdefinierten Connector mit einer OAuth-Client-ID und einem Clientschlüssel.

  1. So erstellen Sie eine OAuth 2.0-Client-ID und ein Secret:

    1. Rufen Sie in der Google Cloud Console Google Auth Platform > Clients > Create Client auf.

      Zur Seite „Client erstellen“

    2. Wählen Sie als Anwendungstyp Webanwendung aus.

    3. Geben Sie einen Namen ein.

    4. Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und fügen Sie dann https://claude.ai/api/mcp/auth_callback in das Feld URIs ein.

    5. Klicken Sie auf Erstellen und kopieren Sie Ihre Client-ID und Ihren Clientschlüssel.

  2. MCP-Server in Claude konfigurieren:

    1. Rufen Sie in Claude.ai oder Claude für Desktop die Einstellungen (oder Administratoreinstellungen) > Connectors auf.
    2. Klicken Sie auf Benutzerdefinierten Connector hinzufügen.
    3. Geben Sie die Verbindungsdetails für das People API-Produkt ein:
      • Server name: people.
      • Remote-MCP-Server-URL: https://people.googleapis.com/mcp/v1
    4. Geben Sie unter Erweiterte Einstellungen Ihre OAuth-Client-ID und Ihr OAuth-Client-Secret ein.
    5. Klicken Sie auf Hinzufügen.

Sonstiges

Viele KI-Anwendungen bieten Möglichkeiten, eine Verbindung zu einem Remote-MCP-Server herzustellen. Normalerweise müssen Sie Details zum Server eingeben, z. B. Name, Endpunkte, Transportprotokoll und Authentifizierungsmethode. Geben Sie für den Remote-MCP-Server der People API Folgendes ein:

Weitere Informationen zum Verbinden verschiedener Clienttypen finden Sie unter MCP in einer KI-Anwendung konfigurieren.

MCP-Server für die People API testen

Nachdem Sie den MCP-Client konfiguriert haben, können Sie die Verbindung mit einigen Testprompts überprüfen.

Stelle deinem MCP-Kunden die folgenden Fragen:

  • „Wie lautet mein Name laut meinem Google-Profil?“

    Der Client verwendet people.get_user_profile, um Ihre Google Workspace-Profilinformationen abzurufen.

Wenn die Tools erfolgreich ausgeführt werden und Sie relevante Antworten erhalten, ist Ihr People API MCP-Server richtig konfiguriert.

Fehlerbehebung

Wenn Sie Probleme beim Herstellen einer Verbindung zum MCP-Server haben, können Sie in den OAuth-Logs nach Fehlern suchen. Bitten Sie Ihren Administrator, die OAuth-Protokollereignisse im Sicherheitsprüftool zu prüfen.

Tool-Referenz

Die folgenden Tools sind für den People API MCP-Server verfügbar:

  • get_user_profile
  • search_contacts
  • search_directory_people

Wichtiger Sicherheitsaspekt: Indirekte Prompt Injection

Wenn Sie ein Language Model nicht vertrauenswürdigen Daten aussetzen, besteht das Risiko eines indirekten Prompt-Injection-Angriffs. Da MCP-Hosts wie Google Antigravity über den People API MCP-Server Zugriff auf leistungsstarke Tools und APIs haben, können sie Daten in Ihrem Google-Konto lesen.

Um diese Risiken zu minimieren, müssen Sie Prompts und Antworten auf schädliche Inhalte oder Prompt-Injection-Angriffe prüfen. Sie können die von Google bereitgestellte Model Armor verwenden oder Ihre eigene Lösung, wenn Sie sie dokumentieren, damit Nutzer dieses Risiko akzeptieren können. Weitere Informationen finden Sie unter Sicherheit für Google Workspace-MCP-Server konfigurieren.

Wir empfehlen folgende Best Practices:

  • Verwenden Sie nur vertrauenswürdige Tools. Verbinden Sie den People API MCP-Server niemals mit nicht vertrauenswürdigen oder nicht bestätigten Anwendungen.
  • Seien Sie vorsichtig bei nicht vertrauenswürdigen Eingaben. Bitten Sie Ihren MCP-Client nicht, Ressourcen aus nicht bestätigten Quellen zu verarbeiten. Diese Eingaben können verborgene Anweisungen enthalten, die Ihre Sitzung manipulieren und es einem Angreifer ermöglichen, Ihre Daten zu ändern, zu stehlen oder zu löschen.
  • Alle Aktionen überprüfen: Prüfen Sie immer sorgfältig die Aktionen, die Ihr KI-Client in Ihrem Namen ausführt, um sicherzustellen, dass sie korrekt sind und Ihren Absichten entsprechen.