Chat-MCP-Server konfigurieren

Google Chat bietet einen Remote-MCP-Server (Model Context Protocol), über den KI-Agenten sicher mit Google Chat-Daten interagieren können. Wenn Sie den Google Chat-MCP-Server konfigurieren, können KI-Anwendungen wie Google Antigravity und Claude Aktionen in Google Chat ausführen.

Der Google Chat-MCP-Server bietet KI-Agenten eine standardisierte Möglichkeit, Folgendes zu tun:

  • Daten lesen: Unterhaltungen auflisten und durchsuchen sowie Nachrichten lesen.
  • Sicherheit berücksichtigen: Es werden dieselben Berechtigungen und Data-Governance-Einstellungen wie für den Nutzer übernommen.

Vorbereitung

Google Chat-MCP-Server konfigurieren

Wenn Sie den Google Chat-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.

APIs aktivieren

Wenn Sie den Google Chat-MCP-Server verwenden möchten, müssen Sie die folgenden APIs in Ihrem Google Cloud-Projekt aktivieren:

  • Google Chat API

Befehlszeile

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

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

Console

Aktivieren Sie die APIs in der Google Cloud Console:

APIs aktivieren

MCP-Dienste aktivieren

Wenn Sie die MCP-Komponenten für Google Chat aktivieren möchten, müssen Sie den folgenden Dienst in Ihrem Google Cloud-Projekt aktivieren:

  • Google Chat MCP API

Befehlszeile

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

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

Console

Aieren Sie die MCP-Dienste in der Google Cloud Console:

MCP-Dienste aktivieren

Chat-App konfigurieren

Wenn Sie den Google Chat-MCP-Server für schreibgeschützte Vorgänge wie die Suche nach Unterhaltungen verwenden möchten, müssen Sie die API aktivieren und einen OAuth-Client erstellen. Eine konfigurierte Chat-App ist nicht erforderlich.

Wenn Sie Schreibvorgänge ausführen möchten, z. B. Nachrichten senden, müssen Sie eine Chat-App in Ihrem Google Cloud-Projekt konfigurieren.

  1. Suchen Sie in der Google Cloud Console nach Google Chat API und klicken Sie auf Google Chat API > Verwalten > Konfiguration.

    Zur Google Chat API

  2. Richten Sie die Chat-App ein:

    1. Geben Sie im Feld App-Name Chat MCP ein.
    2. Geben Sie im Feld Avatar-URL https://developers.google.com/chat/images/quickstart-app-avatar.png ein.
    3. Geben Sie unter Beschreibung Chat MCP server ein.
    4. Deaktivieren Sie unter Funktionalität die Option Interaktive Funktionen aktivieren.
    5. Wählen Sie unter Logs die Option Fehler in Logging protokollieren aus.

  3. Klicken Sie auf Speichern.

Weitere Informationen zum Erstellen einer Chat-App finden Sie unter Architektur für eine Google Chat-App auswählen.

Der Google Chat-MCP-Server 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 im Feld App-Name den Wert Chat MCP Server ein.
    2. Wählen Sie unter E-Mail-Adresse für Nutzersupport Ihre E-Mail-Adresse oder eine entsprechende 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 benachrichtigt werden können.
    7. Klicken Sie auf Weiter.
    8. Lesen Sie unter Fertigstellen die Richtlinie zu Nutzerdaten für Google API-Dienste durch und wählen Sie Ich akzeptiere die Richtlinie zu Nutzerdaten für Google API-Dienste aus, wenn Sie zustimmen.
    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 Adressen anderer autorisierter Testnutzer ein und klicken Sie auf Speichern.

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

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

      • https://www.googleapis.com/auth/chat.spaces.readonly
      • https://www.googleapis.com/auth/chat.memberships.readonly
      • https://www.googleapis.com/auth/chat.messages.readonly
      • https://www.googleapis.com/auth/chat.messages.create
      • https://www.googleapis.com/auth/chat.users.readstate
      • https://www.googleapis.com/auth/chat.users.spacesettings

    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 Google Chat Ihrem MCP-Client hinzufügen möchten, folgen Sie der Anleitung für Ihren Client.

Für vom Nutzer delegierte OAuth 2.0-Client-IDs, die den Chat-MCP-Server aufrufen, muss in der Google Auth Platform > Clients die Option Diesen Client für einen KI-basierten Agenten verwenden ausgewählt sein. Wenn Sie eine vorhandene OAuth 2.0-Client-ID aktualisieren möchten, wählen Sie diese Einstellung unter Google Auth Platform > Clients aus, wie unter OAuth-Clients verwalten beschrieben. Wenn Sie diese Einstellung für einen vorhandenen Client nicht ändern können oder der Client auch Funktionen unterstützt, die nicht für KI-Agenten bestimmt sind, erstellen Sie eine neue OAuth 2.0-Client-ID für Ihren KI-Agenten. Informationen zu abgelehnten Anfragen, Dienstkonten mit domainweiter Delegierung oder Google Apps Script finden Sie unter Fehlerbehebung.

Antigravity

Wenn Sie den Remote-MCP-Server für Google Chat zu Antigravity hinzufügen möchten, fügen Sie die Serverkonfiguration in Ihre mcp_config.json-Datei ein. Diese Anleitung gilt für Antigravity 2.0, Antigravity IDE und Antigravity CLI.

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

    1. Rufen Sie in der Google Cloud Console Google Auth Platform > Clients > Client erstellen 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. Wählen Sie Diesen Client für einen KI-basierten Agenten verwenden aus.

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

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

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

    {
  "mcpServers": {
    "chat": {
      "serverUrl": "https://chatmcp.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. Authentifizieren Sie den MCP-Server. Sie können sich entweder über die GUI-Einstellungen oder die Befehlszeile authentifizieren:

    • Für die Antigravity IDE oder die Antigravity 2.0-GUI:

      1. Öffnen Sie den Bildschirm „Einstellungen“ (klicken Sie z.B. links unten auf Einstellungen oder öffnen Sie Antigravity-Nutzereinstellungen).
      2. Gehen Sie zu Anpassungen.
      3. Klicken Sie unter Installierte MCP-Server auf Aktualisieren.
      4. Suchen Sie in der Liste nach chat, 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-Verwaltungssteuerfeld mit folgendem Befehl:

        /mcp

      3. Wählen Sie mit den Pfeiltasten chat aus, gehen Sie zur Aktion Authentifizieren und drücken Sie die Eingabetaste. Schließen Sie die Anmeldung in Ihrem Browser ab, kopieren Sie den Autorisierungscode, fügen Sie ihn in die Terminal-Eingabeaufforderung 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: Neben dem Server wird unter Anpassungen > Installierte MCP-Server der Button Abmelden angezeigt.
    • Für die Antigravity CLI: Öffnen Sie den Bereich /mcp, um Ihre konfigurierten MCP-Server anzusehen. Bei verifizierten und authentifizierten Servern wird im interaktiven TUI-Bereich neben dem Namen Authed angezeigt. Sie können einen beliebigen Server in der Dashboard-Ansicht auswählen, um seinen Status zu prüfen und alle verfügbaren Tools aufzulisten.

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

Claude

Wenn Sie den Remote-MCP-Server von Google Chat 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 Google Chat zu Claude hinzufügen möchten, konfigurieren Sie einen benutzerdefinierten Connector mit einer OAuth-Client-ID und einem Clientschlüssel.

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

    1. Rufen Sie in der Google Cloud Console Google Auth Platform > Clients > Client erstellen 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. Wählen Sie Diesen Client für einen KI-basierten Agenten verwenden aus.

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

  2. Konfigurieren Sie den MCP-Server in Claude:

    1. Gehen Sie in Claude.ai oder Claude für Desktop zu den Einstellungen > Connectors oder den Administratoreinstellungen > Connectors.
    2. Klicken Sie auf Benutzerdefinierten Connector hinzufügen.
    3. Geben Sie die Verbindungsdetails für das Google Chat-Produkt ein:
      • Server name: Google Chat.
      • Remote-MCP-Server-URL: https://chatmcp.googleapis.com/mcp/v1
    4. Geben Sie unter Erweiterte Einstellungen Ihre OAuth-Client-ID und Ihren OAuth-Clientschlüssel ein.
    5. Klicken Sie auf Hinzufügen.

Sonstiges

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

  • Server name: chat

  • Server-URL: https://chatmcp.googleapis.com/mcp/v1

  • Transport: Streamable HTTP

  • Authentifizierung: Der Remote-MCP-Server von Google Chat verwendet OAuth 2.0. Wählen Sie beim Erstellen des OAuth 2.0-Clients Diesen Client für einen KI-basierten Agenten verwenden aus. Weitere Informationen finden Sie unter Informationen zu Authentifizierung und Autorisierung.

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

Google Chat-MCP-Server testen

Nachdem Sie den MCP-Client konfiguriert haben, können Sie die Verbindung prüfen, indem Sie einige Test-Prompts ausführen.

Stellen Sie Ihrem MCP-Client die folgenden Fragen:

  • „Was war die letzte Nachricht im Gruppenbereich ‚Projekt X‘?“

    Der Client findet den Gruppenbereich mit search_conversations und ruft dann Nachrichten mit list_messages ab.

Wenn die Tools erfolgreich ausgeführt werden und Sie relevante Antworten erhalten, ist Ihr Google Chat-MCP-Server korrekt konfiguriert.

Fehlerbehebung

In den folgenden Abschnitten erfahren Sie, wie Sie häufige Authentifizierungs- und Verbindungsprobleme mit dem Chat-MCP-Server beheben.

OAuth-Protokollereignisse prüfen

Wenn Sie Probleme beim Herstellen einer Verbindung zum MCP-Server haben, prüfen Sie die OAuth-Logs auf Fehler. Bitten Sie Ihren Google Workspace-Administrator, die OAuth-Protokollereignisse im Sicherheitsprüftool zu prüfen.

Abgelehnte Anfragen von nutzerdelegierten OAuth-Clients

Wenn Ihre Anfragen an den MCP-Server abgelehnt werden, prüfen Sie, ob für die vom Nutzer delegierte OAuth 2.0-Client-ID für Ihren dreibeinigen OAuth-Flow in der Google Auth Platform > Clients die Option Diesen Client für einen KI-basierten Agenten verwenden ausgewählt ist:

  • Der vorhandene Client unterstützt die Einstellung: Wählen Sie für Ihren vorhandenen OAuth-Client Diesen Client für einen KI-basierten Agenten verwenden aus.
  • Vorhandener Client kann nicht aktualisiert werden: Erstellen Sie einen neuen OAuth-Client, wählen Sie Diesen Client für einen KI-basierten Agenten verwenden aus und aktualisieren Sie Ihre App, um ihn zu verwenden.
  • Der vorhandene Client unterstützt auch Funktionen, die nicht auf Agenten basieren: Erstellen Sie einen separaten OAuth-Client für den KI-Agenten und behalten Sie den vorhandenen Client für Ihre Funktionen, die nicht auf Agenten basieren.

Eine Anleitung finden Sie unter MCP-Client konfigurieren und OAuth-Clients verwalten.

Dienstkonten mit domainweiter Delegierung

Wenn Ihre Anwendung ein Dienstkonto mit domainweiter Delegierung für 2-Legged OAuth verwendet, können Sie Diesen Client für einen KI-basierten Agenten verwenden nicht auswählen, da Dienstkonten nicht in der Google Auth Platform > Clients verwaltet werden:

  • Zugriffssteuerung: Anfragen von diesen Dienstkonten an den MCP-Server werden nicht abgelehnt, wenn die Agent-Einstellung fehlt. Stattdessen wird der Zugriff durch die Einstellungen für die domainweite Delegierung geregelt, die Ihr Google Workspace-Administrator verwaltet. Weitere Informationen zu Administratoreinstellungen finden Sie unter Zugriff auf die API mit domainweiter Delegierung verwalten.
  • Sensible Aktionen: Google Workspace-MCP-Server geben weiterhin Aufforderungen zur Formularerfassung für die Bestätigung durch Human in the Loop bei sensiblen Toolaufrufen zurück, die über die Identitätsübernahme von Nutzern mit domainweiter Delegation erfolgen.

Anfragen von Apps Script

Wenn Sie den MCP-Server über Apps Script aufrufen, können Sie für den Standard-OAuth-Client, den Apps Script für Ihr Script erstellt und verwaltet, nicht Diesen Client für einen KI-basierten Agenten verwenden auswählen. Dies gilt auch, wenn Ihr Script ein Google Cloud-Standardprojekt verwendet.

So rufen Sie den MCP-Server über Apps Script auf:

  1. Rufen Sie in der Google Cloud Console Google Auth Platform > Clients auf, erstellen Sie einen OAuth-Client und wählen Sie Diesen Client für einen KI-gestützten Agenten verwenden aus.
  2. Verwenden Sie in Ihrem Skript die OAuth2 for Apps Script-Bibliothek, um Nutzer mit diesem OAuth-Client zu autorisieren.
  3. Wenn Sie den MCP-Server aufrufen, senden Sie das von der Bibliothek zurückgegebene Zugriffstoken anstelle des Tokens von ScriptApp.getOAuthToken.

Apps Script-Projekte, die keine Google Workspace-MCP-Server aufrufen, sind nicht betroffen.

Wiederholte stündliche Aufforderungen zur Anmeldung

Wenn Sie etwa jede Stunde aufgefordert werden, sich noch einmal anzumelden, erhält Ihr MCP-Client kein Aktualisierungstoken. Der OAuth 2.0-Server von Google stellt nur dann ein Aktualisierungstoken aus, wenn die Autorisierungsanfrage access_type=offline enthält. Wenn nur der OIDC-Bereich (OpenID Connect) offline_access angefordert wird, wird kein Bereich zurückgegeben.

Prüfen Sie, ob Ihr MCP-Client benutzerdefinierte Autorisierungsparameter unterstützt:

  • Client unterstützt benutzerdefinierte Autorisierungsparameter: Fügen Sie der Autorisierungsanfrage access_type=offline hinzu. Wenn Sie ein neues Aktualisierungstoken für einen Nutzer erhalten möchten, der bereits Zugriff gewährt hat, fügen Sie auch prompt=consent hinzu.
  • Client unterstützt keine benutzerdefinierten Autorisierungsparameter: Melden Sie sich jedes Mal neu an, wenn das Zugriffstoken abläuft.

Weitere Informationen finden Sie unter Zugriffstoken aktualisieren.

Toolreferenz

Die folgenden Tools sind für den Google Chat-MCP-Server verfügbar:

  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
  • get_notification_settings
  • update_notification_settings

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 Google Chat-MCP-Server Zugriff auf leistungsstarke Tools und APIs haben, können sie Daten in Ihrem Google-Konto lesen, ändern und löschen.

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 eine eigene Lösung, wenn Sie sie dokumentieren, damit Nutzer dieses Risiko akzeptieren können. Weitere Informationen finden Sie im Hilfeartikel Sicherheit für Google Workspace-MCP-Server konfigurieren.

Wir empfehlen folgende Best Practices:

  • Verwenden Sie nur vertrauenswürdige Tools. Verbinden Sie den Google Chat-MCP-Server niemals mit nicht vertrauenswürdigen oder nicht verifizierten Anwendungen.
  • Seien Sie vorsichtig bei nicht vertrauenswürdigen Eingaben. Bitten Sie Ihren MCP-Client nicht, Nachrichten oder andere Ressourcen aus nicht verifizierten Quellen zu verarbeiten. Diese Eingaben können versteckte Anweisungen enthalten, die Ihre Sitzung kapern können, sodass ein Angreifer Ihre Daten ändern, stehlen oder löschen kann.
  • Überprüfen Sie alle Aktionen. Prüfen Sie die von Ihrem KI-Client in Ihrem Namen ausgeführten Aktionen immer sorgfältig, um sicherzustellen, dass sie korrekt sind und Ihren Absichten entsprechen.