Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Google Workspace-MCP-Server konfigurieren

Google Workspace bietet Remote-MCP-Server (Model Context Protocol), mit denen KI-Agenten sicher mit Google Workspace-Daten interagieren können. Durch die Konfiguration der Google Workspace-MCP-Server ermöglichen Sie KI-Anwendungen wie Google Antigravity und Claude, Aktionen in Google Workspace-Anwendungen wie Gmail, Google Drive, Google Docs, Google Sheets, Google Präsentationen, Google Kalender, Google Chat und Google Classroom auszuführen. Jedes Google Workspace-Produkt hat einen eigenen MCP-Server.

Die Google Workspace-MCP-Server bieten KI-Agenten eine standardisierte Möglichkeit, Folgendes zu tun:

Daten lesen: E‑Mails durchsuchen, Dateien abrufen und Kalendertermine auflisten.
Aktionen ausführen: E‑Mail-Entwürfe erstellen, Dateien hochladen und Besprechungen planen.
Sicherheit berücksichtigen: Es werden dieselben Berechtigungen und Data-Governance-Einstellungen wie für den Nutzer übernommen.

Vorbereitung

Mitgliedschaft im Google Workspace Entwicklervorschauprogramm.
Ein Google Cloud-Projekt. Informationen zum Erstellen eines Projekts finden Sie unter Projekt erstellen.
Ein MCP-Client wie Google Antigravity.
Richten Sie die gcloud CLI in einer lokalen Entwicklungsumgebung ein, um die Befehle auf dieser Seite auszuführen. Gehen Sie dazu so vor:
1. Installieren Sie die Google Cloud CLI. Wenn Sie die gcloud CLI bereits installiert haben, prüfen Sie mit gcloud components update, ob Sie die aktuelle Version verwenden.
2. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, melden Sie sich mit Ihrer föderierten Identität in der gcloud CLI an. Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.
3. Initialisieren Sie die Google Cloud CLI.
Wenn Sie den Google Classroom-MCP-Server konfigurieren, benötigen Sie einen Google Classroom-Testkurs mit mindestens einem Testschülerkonto. Wenn Sie keinen Google Classroom-Kurs haben, den Sie zum Testen verwenden können, erstellen Sie einen in der Benutzeroberfläche und fügen Sie einen Testschüler hinzu.

Google Workspace-MCP-Server konfigurieren

Wenn Sie die Google Workspace-MCP-Server verwenden möchten, müssen Sie sie in Ihrem Google Cloud-Projekt aktivieren und dann Ihren MCP-Client so konfigurieren, dass er eine Verbindung zu ihnen herstellt.

APIs aktivieren

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

Gmail API
Google Drive API
Google Docs API
Google Sheets API
Google Slides API
Google Calendar API
Google Chat API
People API
Google Classroom API

Befehlszeile

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.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 die einzelnen Google Workspace-Produkte aktivieren möchten, müssen Sie die folgenden Dienste in Ihrem Google Cloud-Projekt aktivieren:

Gmail MCP API
Google Drive MCP API
Google Docs MCP API
Google Sheets MCP API
Google Präsentationen MCP API
Google Calendar MCP API
Google Chat MCP API
People MCP API
Google Classroom MCP API

Befehlszeile

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID

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

Console

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

MCP-Dienste aktivieren

Chat-App konfigurieren

Wenn Sie den Google Chat-MCP-Server verwenden möchten, müssen Sie eine Chat-App in Ihrem Google Cloud-Projekt konfigurieren.

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

Zur Google Chat API
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 Funktionen die Option Interaktive Funktionen aktivieren.
5. Wählen Sie unter Logs die Option Fehler in Logging protokollieren aus.
Klicken Sie auf Speichern.

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

Die Google Workspace-MCP-Server verwenden 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.

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

Zum Branding
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 Workspace MCP Servers ein.
2. Wählen Sie unter E-Mail-Adresse für den 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 Abschließen die Richtlinie zu Nutzerdaten für Google API-Dienste 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 aller anderen autorisierten Testnutzer ein und klicken Sie auf Speichern.
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 die MCP-Server ein, die Sie verwenden möchten:
  - Gmail:
    - https://www.googleapis.com/auth/gmail.readonly
    - https://www.googleapis.com/auth/gmail.compose
  - Google Drive:
    - https://www.googleapis.com/auth/drive.readonly
    - https://www.googleapis.com/auth/drive.file
  - Google Docs:
    - https://www.googleapis.com/auth/drive.readonly
    - https://www.googleapis.com/auth/drive.file
    - https://www.googleapis.com/auth/documents.readonly
    - https://www.googleapis.com/auth/documents
  - Google Sheets:
    - https://www.googleapis.com/auth/drive.readonly
    - https://www.googleapis.com/auth/drive.file
    - https://www.googleapis.com/auth/spreadsheets.readonly
    - https://www.googleapis.com/auth/spreadsheets
  - Google Präsentationen:
    - https://www.googleapis.com/auth/drive.readonly
    - https://www.googleapis.com/auth/drive.file
    - https://www.googleapis.com/auth/presentations.readonly
    - https://www.googleapis.com/auth/presentations
  - Google Kalender:
    - https://www.googleapis.com/auth/calendar.calendarlist.readonly
    - https://www.googleapis.com/auth/calendar.events.freebusy
    - https://www.googleapis.com/auth/calendar.events.readonly
  - Google Chat:
    - 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
  - People API:
    - https://www.googleapis.com/auth/directory.readonly
    - https://www.googleapis.com/auth/userinfo.profile
    - https://www.googleapis.com/auth/contacts.readonly
  - Google Classroom:
    - https://www.googleapis.com/auth/classroom.announcements
    - https://www.googleapis.com/auth/classroom.courses.readonly
    - https://www.googleapis.com/auth/classroom.coursework.students
    - https://www.googleapis.com/auth/classroom.courseworkmaterials
    - https://www.googleapis.com/auth/classroom.rosters.readonly
    - https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
    - https://www.googleapis.com/auth/classroom.topics.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 Google Workspace-Remote-MCP-Server zu Ihrem MCP-Client hinzufügen möchten, folgen Sie der Anleitung für Ihren Client.

Antigravity

Wenn Sie die Remote-MCP-Server von Google Workspace 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.

Erstellen Sie eine OAuth 2.0-Client-ID und ein Client-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.
Öffnen oder erstellen Sie die Konfigurationsdatei ~/.gemini/config/mcp_config.json.

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

{
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "classroom": {
      "serverUrl": "https://classroommcp.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.

mcp_config.json sparen.
Authentifizieren Sie die MCP-Server. Sie können sich entweder über die GUI-Einstellungen oder die Befehlszeile authentifizieren:
- Für die Antigravity IDE oder die GUI (Antigravity 2.0):
  1. Öffnen Sie die Einstellungen, indem Sie beispielsweise links unten auf Einstellungen klicken oder die Antigravity-Nutzereinstellungen öffnen.
  2. Gehen Sie zu Anpassungen.
  3. Klicken Sie unter Installierte MCP-Server auf Aktualisieren.
  4. Klicken Sie für jeden aufgeführten Server (gmail, drive, docs, sheets, slides, calendar, chat, people und classroom) 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. Authentifizieren Sie jeden MCP-Server:
    1. Wählen Sie mit den Pfeiltasten den Server 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.
    2. Wiederholen Sie diese Schritte für jeden konfigurierten Server (gmail, drive, docs, sheets, slides, calendar, chat, people und classroom).
Prüfen Sie, ob die Server richtig konfiguriert sind und ausgeführt werden:
- Für die Antigravity IDE oder GUI: Neben jedem Server wird unter Anpassungen > Installierte MCP-Server die Schaltfläche 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 in der Dashboard-Ansicht einen beliebigen Server auswählen, um seinen Status zu prüfen und alle verfügbaren Tools aufzulisten.

Die Remote-MCP-Server können jetzt in Antigravity verwendet werden.

Claude

Wenn Sie die Remote-MCP-Server von Google Workspace mit Claude.ai oder Claude Desktop verwenden möchten, benötigen Sie ein Claude Enterprise-, Pro-, Max- oder Team-Abo.

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

Erstellen Sie eine OAuth 2.0-Client-ID und ein Client-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 im Feld URIs hinzu.
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.
Konfigurieren Sie den MCP-Server in Claude:
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 Google Workspace-Produkt ein, das Sie hinzufügen möchten:
  - Servername: Ein Name für den Server, z. B. Gmail.
  - Remote-MCP-Server-URL: Die URL für das Google Workspace-Produkt, z. B. eine der folgenden:
    - Gmail: https://gmailmcp.googleapis.com/mcp/v1
    - Google Drive: https://drivemcp.googleapis.com/mcp/v1
    - Google Docs: https://docsmcp.googleapis.com/mcp/v1
    - Google Sheets: https://sheetsmcp.googleapis.com/mcp/v1
    - Google Präsentationen: https://slidesmcp.googleapis.com/mcp/v1
    - Google Kalender: https://calendarmcp.googleapis.com/mcp/v1
    - Google Chat: https://chatmcp.googleapis.com/mcp/v1
    - People API: https://people.googleapis.com/mcp/v1
    - Google Classroom: https://classroommcp.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.
6. Wiederholen Sie diese Schritte für jedes Google Workspace-Produkt, das Sie hinzufügen möchten.

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 die Google Workspace-Remote-MCP-Server Folgendes ein:

Server name: googleworkspace
Server: Jedes Google Workspace-Produkt hat eine eigene Server-URL:
- Gmail: https://gmailmcp.googleapis.com/mcp/v1
- Google Drive: https://drivemcp.googleapis.com/mcp/v1
- Google Docs: https://docsmcp.googleapis.com/mcp/v1
- Google Sheets: https://sheetsmcp.googleapis.com/mcp/v1
- Google Präsentationen: https://slidesmcp.googleapis.com/mcp/v1
- Google Kalender: https://calendarmcp.googleapis.com/mcp/v1
- Google Chat: https://chatmcp.googleapis.com/mcp/v1
- People API: https://people.googleapis.com/mcp/v1
- Google Classroom: https://classroommcp.googleapis.com/mcp/v1
Transport: Streamable HTTP
Authentifizierung: Der Remote-MCP-Server von Google Workspace 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.

Ihr MCP-Client benötigt ein Aktualisierungstoken, damit sich Nutzer nicht etwa jede Stunde neu anmelden müssen. Der OAuth 2.0-Server von Google stellt nur dann ein Aktualisierungstoken aus, wenn die Autorisierungsanfrage access_type=offline enthält. Wenn Sie nur den OIDC-Bereich (OpenID Connect) offline_access anfordern, wird kein Bereich zurückgegeben. Wenn Ihr MCP-Client benutzerdefinierte Autorisierungsparameter unterstützt, 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. Wenn Ihr MCP-Client keine benutzerdefinierten Autorisierungsparameter unterstützt, müssen sich Nutzer jedes Mal neu anmelden, wenn das Zugriffstoken abläuft. Weitere Informationen finden Sie unter Zugriffstoken aktualisieren.

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

Google Workspace-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 hat Ariel in ihrer letzten E‑Mail zu unserem Marketingplan gesagt?“

Der Client filtert mit gmail.search_threads nach E‑Mails von Ariel, ruft mit gmail.get_thread den Inhalt des neuesten Threads ab und fasst ihn dann für Sie zusammen.
„Entwirf eine E‑Mail an ariel@beispiel.de, in der du schreibst, dass ich den Marketingplan genehmige.“

Der Client verwendet gmail.create_draft, um eine E‑Mail in Ihrem Ordner „Entwürfe“ zu erstellen, die Sie dann in Gmail prüfen und senden können.
„Fasse die Datei ‚Marketingplan‘ zusammen.“

Der Client ruft drive.search_files auf, um „Marketingplan“ zu finden, und verwendet dann drive.read_file_content, um den Inhalt abzurufen und zusammenzufassen.
„Zeige mir die strukturellen Inhalte der Besprechungsnotizen in Google Docs.“

Der Client ruft die Dokumentstruktur und den Inhalt mit docs.read_doc ab.
„Lies das Tabellenblatt ‚Sheet1‘ aus der Google-Tabelle ‚Quarterly Sales‘.“

Der Client ruft Rasterwerte mit sheets.get_values ab.
„Zeig mir das verbalisierte Layout der Google-Präsentation ‚Produktübersicht‘.“

Der Client ruft die visuellen Layoutstrukturen der Präsentation mit slides.read_presentation ab.
„Wann ist mein nächstes Meeting mit Ariel?“

Der Kunde prüft Ihren Zeitplan mit calendar.list_events und nennt Ihnen die Details für Ihr nächstes Treffen mit Ariel.
„Wie lautet mein Name laut meinem Google-Profil?“

Der Client verwendet people.get_user_profile, um Ihre Google Workspace-Profilinformationen abzurufen.
„Welche Kurse unterrichte ich gerade?“

Der Client prüft Ihren Zeitplan mit classroom.list_course_summaries und fasst die aktiven Kurse zusammen, in denen Sie die Rolle der Lehrkraft haben.
„Entwirf für meinen Geologiekurs eine Ankündigung für die bevorstehende Exkursion.“

Der Client verwendet classroom.create_announcement, um die Ankündigung zu entwerfen. Sie können sie dann in der Google Classroom App prüfen und posten.

Wenn die Tools erfolgreich ausgeführt werden und Sie relevante Antworten erhalten, sind Ihre Google Workspace-MCP-Server korrekt konfiguriert.

Fehlerbehebung

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

Wenn Ihre Anfragen an die MCP-Server abgelehnt werden, prüfen Sie, ob für Ihren OAuth 2.0-Client in der Google Auth Platform > Clients die Option Diesen Client für einen KI-basierten Agenten verwenden ausgewählt ist. Wenn Sie diese Einstellung für einen vorhandenen OAuth-Client nicht ändern können, erstellen Sie einen neuen OAuth-Client, wählen Sie Diesen Client für einen KI-basierten Agenten verwenden aus und aktualisieren Sie Ihre Anwendung, um ihn zu verwenden. Wenn ein vorhandener OAuth-Client sowohl für KI-Agenten- als auch für Nicht-Agenten-Funktionen verwendet wird, erstellen Sie einen separaten OAuth-Client für den KI-Agenten und behalten Sie den vorhandenen Client für Ihre Nicht-Agenten-Funktionen bei. Eine Anleitung finden Sie unter MCP-Client konfigurieren und OAuth-Clients verwalten.

Wenn Ihre App ein Dienstkonto mit domainweiter Delegierung verwendet, können Sie dafür nicht Diesen Client für einen KI-basierten Agenten verwenden auswählen, da Dienstkonten nicht in der Google Auth Platform > Clients verwaltet werden. Anfragen an die MCP-Server von Dienstkonten, die die domainweite Delegierung verwenden, werden aus diesem Grund nicht abgelehnt. Der Zugriff wird über die Einstellungen für die domainweite Delegierung gesteuert, die Ihr Google Workspace-Administrator verwaltet. Weitere Informationen finden Sie im Hilfeartikel Zugriff auf die API mit domainweiter Delegierung verwalten.

Wenn Sie die MCP-Server über Google Apps Script aufrufen, erstellt und verwaltet Apps Script einen Standard-OAuth-Client für Ihr Script. Sie können dafür jedoch nicht Diesen Client für einen KI-basierten Agenten verwenden auswählen. Das gilt auch, wenn Ihr Script ein Google Cloud-Standardprojekt verwendet. Gehen Sie stattdessen so vor:

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-basierten Agenten verwenden aus.
Verwenden Sie in Ihrem Script die OAuth2 for Apps Script-Bibliothek, um Nutzer mit diesem OAuth-Client zu autorisieren.
Wenn Sie die MCP-Server aufrufen, senden Sie das von der Bibliothek zurückgegebene Zugriffstoken anstelle des Tokens von ScriptApp.getOAuthToken.

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

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 Sie nur den OpenID Connect-Bereich (OIDC) offline_access anfordern, wird kein Bereich zurückgegeben. Wenn Ihr MCP-Client benutzerdefinierte Autorisierungsparameter unterstützt, 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. Wenn Ihr MCP-Client keine benutzerdefinierten Autorisierungsparameter unterstützt, müssen Sie sich jedes Mal neu anmelden, wenn das Zugriffstoken abläuft. Weitere Informationen finden Sie unter Zugriffstoken aktualisieren.

Unterstützte Produkte

Die folgenden Google Workspace-Produkte unterstützen Google Workspace-MCP-Server und bieten die folgenden Tools:

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

Beachten Sie die folgenden Best Practices, um diese Risiken zu minimieren:

Verwenden Sie nur vertrauenswürdige Tools. Verbinden Sie Google Workspace-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, E‑Mails, Dokumente 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 immer sorgfältig die Aktionen, die Ihr KI-Client in Ihrem Namen ausführt, um sicherzustellen, dass sie korrekt sind und Ihren Absichten entsprechen.

Google Workspace-MCP-Server konfigurieren Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Vorbereitung

Google Workspace-MCP-Server konfigurieren

APIs aktivieren

Befehlszeile

Console

MCP-Dienste aktivieren

Befehlszeile

Console

Chat-App konfigurieren

OAuth-Zustimmungsbildschirm einrichten

MCP-Client konfigurieren

Antigravity

Claude

Sonstiges

Google Workspace-MCP-Server testen

Fehlerbehebung

Unterstützte Produkte

Wichtiger Sicherheitsaspekt: Indirekte Prompt Injection

Weitere Informationen

Google Workspace-MCP-Server konfigurieren