Google Workspace-MCP-Server in Google Antigravity 2.0, IDE und/oder CLI

1. Einführung

Hinweis:Verwenden Sie noch die Gemini CLI? In dieser Anleitung geht es um die Antigravity CLI. Weitere Informationen zum Übergang finden Sie in diesem offiziellen Blogpost.

In diesem Codelab erfahren Sie, wie Sie das Model Context Protocol (MCP) verwenden, um Ihre Google Workspace-Daten mit Antigravity 2.0, IDE und/oder CLI zu verbinden. MCP ist ein offener Standard, mit dem KI-Modelle Tools verwenden können, die von Remote-Servern bereitgestellt werden. Sie richten Antigravity so ein, dass es mit Gmail, Google Drive, Google Docs, Google Sheets, Google Präsentationen, Google Kalender, Google Chat und der People API interagiert, ohne dass Sie Code schreiben müssen.

Aufgaben

• Aktivieren Sie die Google Workspace MCP-Dienste in Ihrem Google Cloud-Projekt.
• Konfigurieren Sie Antigravity für den Zugriff auf diese MCP-Dienste.
• Testen Sie die Integration mit unterhaltsamen und nützlichen Prompts , die mit Ihren Google Workspace-Daten interagieren.

Voraussetzungen

• Ein Webbrowser wie Chrome
• Ein Google Cloud-Projekt, das für das Google Workspace-Entwicklervorschauprogramm registriert ist
• Ein Google Workspace-Konto
• Antigravity 2.0, IDE und/oder CLI auf Ihrem lokalen Computer installiert. Weitere Informationen und eine Installationsanleitung finden Sie auf der offiziellen Website.

Einfacher Zugriff auf dieses Codelab

2. Hinweis

Google Workspace-Entwicklervorschauprogramm:Der Zugriff auf Google Workspace MCP-Server ist Teil des öffentlichen Entwicklervorschauprogramms. Wenn Sie sich noch nicht registriert haben, tun Sie das bitte unter https://developers.google.com/workspace/preview und prüfen Sie, ob Ihr Konto für das Programm akzeptiert wurde.

Google Cloud-Projekt erstellen oder auswählen

Wählen Sie in der Google Cloud Console ein Google Cloud-Projekt aus oder erstellen Sie eines.

APIs aktivieren

Wenn Sie die Google Workspace MCP-Server verwenden möchten, müssen Sie die Standard-Google Workspace APIs aktivieren.

APIs aktivieren

MCP-Dienste aktivieren

Aktivieren Sie als Nächstes die Google Workspace MCP-Dienste.

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.

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:
   • Geben Sie im Feld App-Name Chat MCP ein.
   • Geben Sie im Feld Avatar-URL https://developers.google.com/chat/images/quickstart-app-avatar.png ein.
   • Geben Sie unter Beschreibung Chat MCP server ein.
   • Deaktivieren Sie unter Funktionen die Option Interaktive Funktionen aktivieren.
   • Wählen Sie unter Logs die Option Fehler in Logging protokollieren aus.
3. Klicken Sie auf Speichern.

3. OAuth-Zustimmung und -Client konfigurieren

Die Google Workspace MCP-Server verwenden OAuth 2.0 für die sichere Authentifizierung und Autorisierung. Sie müssen einen OAuth-Zustimmungsbildschirm konfigurieren und einen Webanwendungsclient erstellen.

OAuth-Zustimmungsbildschirm einrichten

Sie müssen zuerst den Zustimmungsbildschirm konfigurieren.

1. Rufen Sie in der Google Cloud Console Google Auth Platform > Branding auf. Klicken Sie auf Jetzt starten , wenn die Option nicht konfiguriert ist.
2. Konfigurieren Sie die App-Informationen:
   • App-Name: Google Workspace MCP Servers
   • E‑Mail-Adresse für den Support: Wählen Sie Ihre E‑Mail-Adresse aus.
3. Konfigurieren Sie die Zielgruppe: Wählen Sie Intern aus (oder Extern, wenn Intern nicht verfügbar ist).
4. Konfigurieren Sie die Kontaktdaten: Geben Sie Ihre E‑Mail-Adresse ein.
5. Lesen Sie die Richtlinie zu Nutzerdaten und stimmen Sie ihr zu. Klicken Sie dann auf Erstellen.
6. Wenn Sie Extern ausgewählt haben, rufen Sie Zielgruppe auf und fügen Sie Ihre E‑Mail-Adresse unter Testnutzer hinzu.
7. Rufen Sie Datenzugriff > Bereiche hinzufügen oder entfernen auf. Fügen Sie unter Bereiche manuell hinzufügen die folgenden Bereiche für die Server hinzu, die Sie verwenden möchten:
   • Universal: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly
   • 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.readonly
   • People API: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
8. Klicken Sie auf Zur Tabelle hinzufügen, dann auf Aktualisieren und schließlich auf Speichern.

OAuth-Client-ID erstellen

1. Rufen Sie Google Auth Platform > Clients > Client erstellen auf.
2. Wählen Sie als Anwendungstyp Webanwendung aus.
3. Geben Sie Antigravity als Namen ein.
4. Klicken Sie unter Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und geben Sie https://antigravity.google/oauth-callback ein.
5. Klicken Sie auf Erstellen und kopieren Sie die Client-ID und den Clientschlüssel. Sie benötigen diese im nächsten Schritt.

4. Antigravity konfigurieren

Konfigurieren wir jetzt Antigravity für die Verwendung dieser Endpunkte. Wenn Sie Antigravity 2.0, IDE und/oder CLI nicht installiert haben, folgen Sie der Anleitung auf der Antigravity-Website.

Benutzerdefinierte MCP-Server hinzufügen

Antigravity 2.0, IDE und CLI verwenden eine zentrale MCP-Konfiguration in der Datei ~/.gemini/config/mcp_config.json.

1. Öffnen Sie die Datei in Ihrem bevorzugten Texteditor.

   Hinweis:Sie können direkt über die Antigravity IDE auf die Datei zugreifen, wenn Sie sie installiert haben. Folgen Sie dazu dieser Anleitung:

   1. Öffnen Sie MCP-Server über das Drop-down-Menü ... oben im Agentenbereich des Editors.
   2. Klicken Sie auf MCP-Server verwalten und dann auf Rohkonfiguration ansehen.
2. Ändern Sie die folgende benutzerdefinierte MCP-Serverkonfiguration. Ersetzen Sie dazu die Platzhalter <YOUR_CLIENT_ID> und <YOUR_CLIENT_SECRET> durch die OAuth-Client-ID und das Secret, die Sie in den vorherigen Schritten erstellt haben.
3. Speichern Sie die Datei.

{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

Benutzerdefinierte MCP-Server authentifizieren

Alle konfigurierten MCP-Server sollten in Antigravity als installiert angezeigt werden: gws-universal, gws-gmail, gws-drive, gws-docs, gws-sheets, gws-slides, gws-calendar, gws-chat und gws-people. Sie müssen jeden von ihnen für jede Antigravity-Oberfläche authentifizieren, da OAuth-Tokens nicht zentralisiert sind.

Antigravity 2.0

1. Klicken Sie links unten auf Einstellungen.
2. Rufen Sie Anpassungen auf.
3. Klicken Sie unter Installierte MCP-Server auf Aktualisieren.

4. Führen Sie für jeden aufgeführten installierten MCP-Server die folgenden Schritte aus:
   1. Klicken Sie auf Authentifizieren.
   
   2. Folgen Sie der Authentifizierung im neuen Browserfenster.
   3. Klicken Sie anschließend auf In die Zwischenablage kopieren.
   
   4. Fügen Sie den gerade kopierten Authentifizierungscode in das Textfeld ein, das in den Einstellungen von Antigravity 2.0 angezeigt wird, und klicken Sie auf Senden.
   
   5. Die Schaltfläche Authentifizieren wurde durch Abmelden ersetzt.
   

Antigravity IDE

1. Öffnen Sie die Antigravity-Nutzereinstellungen über das Drop-down-Menü Editorspezifische Einstellungen oben im Fenster.

2. Rufen Sie Anpassungen auf.
3. Klicken Sie unter Installierte MCP-Server auf Aktualisieren.

4. Führen Sie für jeden aufgeführten installierten MCP-Server die folgenden Schritte aus:
   1. Klicken Sie auf Authentifizieren.
   
   2. Folgen Sie der Authentifizierung im neuen Browserfenster.
   3. Klicken Sie anschließend auf In die Zwischenablage kopieren.
   
   4. Fügen Sie den gerade kopierten Authentifizierungscode in das Textfeld ein, das in den Einstellungen von Antigravity IDE angezeigt wird, und klicken Sie auf Senden.
   
   5. Die Schaltfläche Authentifizieren wurde durch Abmelden ersetzt.
   

Antigravity CLI

1. Geben Sie /mcp ein und drücken Sie die Eingabetaste.

2. Führen Sie für jeden aufgeführten MCP-Server die folgenden Schritte aus:
   1. Wählen Sie ihn mit den Pfeiltasten nach oben und nach unten aus und drücken Sie die Eingabetaste.
   2. Wählen Sie mit den Pfeiltasten nach links und nach rechts die Option Authentifizieren aus und drücken Sie die Eingabetaste.
   
   3. Öffnen Sie die angezeigte URL in einem neuen Browserfenster und folgen Sie der Authentifizierung.
   
   4. Klicken Sie anschließend auf In die Zwischenablage kopieren.
   
   5. Fügen Sie den gerade kopierten Authentifizierungscode in das Textfeld ein, das in Ihrem Terminal angezeigt wird, auf dem die Antigravity CLI ausgeführt wird, und drücken Sie die Eingabetaste.
   
   6. Der Status Authentifiziert wird jetzt anstelle von Authentifizierung erforderlich angezeigt.
   

5. Test tools

Jetzt können Sie mit Ihren Google Workspace-Daten in natürlicher Sprache interagieren. Hier sind einige Beispiele für Prompts für jeden Dienst.

Hinweis: Ersetzen Sie die Platzhalter in Klammern in den folgenden Prompts (z.B. [NAME], [FILE_NAME]) durch tatsächliche Werte aus Ihren eigenen Google Workspace-Daten.

Universal

Versuchen Sie, in verschiedenen Produkten zu suchen:

• "Fasse in wenigen Sätzen zusammen, was zuletzt in meinem Google Workspace-Konto passiert ist."
• "Suche in meinen E‑Mails, Dokumenten und Chatnachrichten nach allem, was mit [PROJEKTNAME] zu tun hat."
• "Wann ist meine nächste Besprechung zum Marketingplan und was sind die neuesten Notizen und Chatnachrichten dazu?"

Gmail

Versuchen Sie, nach E‑Mails zu suchen oder sie zu verwalten:

• "Fasse die letzten fünf E‑Mails zusammen, die ich erhalten habe."
• "Entwirf eine E‑Mail an „[E‑MAIL-ADRESSE]“, in der du um ein Update zum Projekt „[PROJEKTNAME]“ bittest."

Google Drive

Versuchen Sie, nach Dateien zu suchen oder sie zu lesen:

• "Suche in meinem Google Drive nach Dateien, die „[SCHLÜSSELWORT]“ enthalten."
• "Liste die zuletzt bearbeiteten Dokumente auf."
• „Lies den Inhalt meines Dokuments „[DATEINAME]“ und fasse die Hauptziele zusammen.“

Google Docs, Google Sheets und Google Präsentationen

Versuchen Sie, in Ihren Drive-Ressourcen zu suchen:

• "Zeige mir den strukturellen Inhalt von Google Docs [DOKUMENTTITEL]."
• „Lies das Tabellenblatt „Sheet1“ aus der Google-Tabelle [TABELLENTITEL] vor.“
• "Zeige mir das verbalisierte Layout von Google Präsentationen [PRÄSENTATIONSTITEL]."

Google Kalender

Versuchen Sie, in Ihrem Zeitplan zu suchen:

• "Welche Besprechungen stehen diese Woche an?"
• "Habe ich morgen Nachmittag Zeit?"

Google Chat

Versuchen Sie, nach Nachrichten zu suchen:

• "Suche in „[SPACE-NAME]“ nach Nachrichten, die „[SCHLÜSSELWORT]“ enthalten."

People API

Versuchen Sie, in Ihrem Profil oder in Ihren Kontakten zu suchen:

• "Wie lautet mein Name laut meinem Google-Profil?"
• "Suche nach den Kontaktdaten für „[NAME]“."

Mehrere Dienste kombinieren

Die wahre Leistungsfähigkeit von MCP zeigt sich, wenn Aufgaben über mehrere Dienste hinweg orchestriert werden. Probieren Sie diese Prompts aus, die dienstübergreifende Funktionen demonstrieren:

• "Suche in Drive nach Dateien zu „[PROJEKTNAME] – Meilenstein-Updates“, fasse ihren Inhalt zusammen, suche nach der E‑Mail-Adresse für „[NAME]“ und erstelle eine Gmail-E‑Mail mit der Zusammenfassung."

Weitere Tools entdecken

Dies sind nur einige Beispiele für die Möglichkeiten. Eine vollständige Liste der für jeden Dienst verfügbaren Tools und eine Anleitung zum Ausprobieren finden Sie im Abschnitt Unterstützte Produkte der offiziellen Dokumentation.

6. Bereinigen

Wenn Sie Ihr Projekt bereinigen möchten, ohne es zu löschen, können Sie die aktivierten APIs und MCP-Dienste deaktivieren:

1. Rufen Sie in der Google Cloud Console das Dashboard „APIs & Dienste“ auf.
2. Klicken Sie auf jede der aktivierten Google Workspace- und MCP-APIs (z.B. „Calendar MCP“, „Chat MCP“) und dann auf API deaktivieren.

Löschen Sie die OAuth-Client-Anmeldedaten in der Google Auth Platform Console , wenn Sie sie nicht mehr verwenden möchten.

7. Glückwunsch

Glückwunsch! Sie haben die offiziellen Google Workspace MCP-Server mit Antigravity erfolgreich konfiguriert und getestet.

Referenzdokumente

• Einführung in das Model Context Protocol (MCP)
• Google Workspace MCP-Server konfigurieren
• OAuth-Zustimmung konfigurieren
• Antigravity