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

1. Einführung

Hinweis:Verwenden Sie noch die Gemini CLI? In diesem Leitfaden wird die Antigravity CLI behandelt. Weitere Informationen zur Umstellung finden Sie in diesem offiziellen Antigravity CLI-Blogpost.

Verwenden Sie Gemini Enterprise? Wenn Ihre Organisation Gemini Enterprise verwendet, können Administratoren berechtigter Kunden genehmigte MCP-Server zentral verwalten und auf die Zulassungsliste setzen. Weitere Informationen finden Sie im Antigravity Enterprise-Blogpost und im zugehörigen Google Workspace MCP-Server mit Antigravity in Gemini Enterprise-Codelab.

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, der es KI-Modellen ermöglicht, Tools, die von Remoteservern bereitgestellt werden, sicher zu verwenden. 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 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 Developer Preview Program 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. Falls Sie es noch nicht getan haben, registrieren Sie sich bitte unter https://developers.google.com/workspace/preview und sorgen Sie dafür, dass Ihr Konto für das Programm akzeptiert wird.

Voraussetzungen für Unternehmen:Wenn in Ihrer Organisation Gemini Enterprise-Richtlinien erzwungen werden, muss Ihr Administrator für berechtigte Kunden zuerst KI-Entwicklertools aktivieren und die Google Workspace-MCP-Serverendpunkte in der Cloud Console auf die Zulassungsliste setzen, bevor Sie eine Verbindung herstellen können. Weitere Informationen finden Sie im Antigravity Enterprise-Blogpost und im zugehörigen Google Workspace MCP-Server mit Antigravity in Gemini Enterprise-Codelab.

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. Chat App einrichten:
   • 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

Hinweis für Unternehmen:In einer Google Workspace-Umgebung für Unternehmen werden der OAuth-Zustimmungsbildschirm und die Client-ID in der Regel zentral von Ihrem Cloud- oder Gemini Enterprise-Administrator bereitgestellt. Wenn Ihr Administrator Ihnen bereits eine genehmigte Client-ID zur Verfügung gestellt hat, können Sie diesen Schritt überspringen und direkt mit Antigravity konfigurieren fortfahren.

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 Funktion noch nicht konfiguriert ist.
2. App-Informationen konfigurieren:
   • App-Name: Google Workspace MCP Servers
   • E‑Mail-Adresse für den Nutzersupport: Wählen Sie Ihre E‑Mail-Adresse aus.
3. Konfigurieren Sie die Zielgruppe: Wählen Sie Intern aus (oder Extern, falls „Intern“ nicht verfügbar ist).
4. Kontaktdaten konfigurieren: 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, gehen Sie zu Zielgruppe und fügen Sie Ihre E‑Mail-Adresse unter Testnutzer hinzu.
7. Klicken Sie auf Data Access > Add or Remove Scopes. 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 Tabellen: 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 die Google Auth Platform > Clients > Create Client auf.
2. Wählen Sie als Anwendungstyp Webanwendung aus.
3. Geben Sie den Namen Antigravity 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 sie im nächsten Schritt.

4. Antigravity konfigurieren

Konfigurieren wir nun 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:Wenn Sie Antigravity IDE installiert haben, können Sie über die folgenden Schritte direkt auf die Datei zugreifen:

   1. Öffnen Sie MCP Servers (MCP-Server) über das Drop-down-Menü ... oben im Agent-Bereich des Editors.
   2. Klicken Sie auf MCP-Server verwalten und dann auf Rohkonfiguration ansehen.
2. Passen Sie sie mit der folgenden benutzerdefinierten MCP-Serverkonfiguration an. Ersetzen Sie 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.

{
  "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 MCP-Server, die Sie konfiguriert haben, 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 jede Oberfläche für jede Antigravity-Oberfläche authentifizieren, da OAuth-Tokens nicht zentralisiert sind.

Fehler bei Unternehmensrichtlinien beheben:Wenn auf einem MCP-Server nach dem Klicken auf Aktualisieren die Meldung Unauthorized / Blocked by Admin Policy angezeigt wird, ist dieser Dienst nicht auf der Zulassungsliste für Gemini Enterprise Ihrer Organisation enthalten. Bitten Sie Ihren Administrator, den Dienstendpunkt hinzuzufügen, und geben Sie ihm das Gemini Enterprise Admin Codelab als Konfigurationsanleitung.

Antigravity 2.0

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

4. Für jeden installierten MCP-Server, der aufgeführt ist:
   1. Klicken Sie auf Authentifizieren.
   
   2. Führen Sie den Authentifizierungsvorgang im neuen Browserfenster durch.
   3. Klicken Sie anschließend auf In Zwischenablage kopieren.
   
   4. Fügen Sie den gerade kopierten Autorisierungscode in das Textfeld ein, das in den Einstellungen von Antigravity 2.0 angezeigt wird, und klicken Sie auf Senden.
   
   5. Anstelle von Authentifizieren wird jetzt der Button Abmelden angezeigt.
   

Antigravity IDE

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

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

4. Für jeden installierten MCP-Server, der aufgeführt ist:
   1. Klicken Sie auf Authentifizieren.
   
   2. Führen Sie den Authentifizierungsvorgang im neuen Browserfenster durch.
   3. Klicken Sie anschließend auf In Zwischenablage kopieren.
   
   4. Fügen Sie den gerade kopierten Autorisierungscode in das Textfeld ein, das in den Einstellungen von Antigravity IDE angezeigt wird, und klicken Sie auf Senden.
   
   5. Anstelle von Authentifizieren wird jetzt der Button Abmelden angezeigt.
   

Antigravity CLI

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

2. Für jeden aufgeführten MCP-Server:
   1. Wählen Sie sie mit dem Aufwärts- und Abwärtspfeil aus und drücken Sie die Eingabetaste.
   2. Wählen Sie mit dem Links- und dem Rechtspfeil die Option Authentifizieren aus und drücken Sie die Eingabetaste.
   
   3. Öffnen Sie die angezeigte URL in einem neuen Browserfenster und führen Sie die Authentifizierung durch.
   
   4. Klicken Sie anschließend auf In Zwischenablage kopieren.
   
   5. Fügen Sie den gerade kopierten Autorisierungscode in das Textfeld ein, das in Ihrem Terminal angezeigt wird, während die Antigravity-CLI ausgeführt wird, und drücken Sie die Eingabetaste.
   
   6. Der Status Authed wird jetzt anstelle von Auth Needed angezeigt.
   

5. Test tools

Sie können jetzt in natürlicher Sprache mit Ihren Google Workspace-Daten interagieren. Hier sind einige Beispiel-Prompts für die einzelnen Dienste.

Hinweis:Ersetzen Sie die Platzhalter in den geschweiften Klammern in den Prompts unten (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 [PROJECT_NAME] zu tun hat.“
• „Wann ist meine nächste Besprechung zum Marketingplan und was sind die neuesten Notizen und Chatnachrichten dazu?“

Gmail

Suchen oder verwalten Sie Ihre E‑Mails:

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

Google Drive

Dateien suchen oder lesen:

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

Google Docs, Google Sheets und Google Präsentationen

Suchen Sie in Ihren Drive-Ressourcen:

• „Zeig mir die strukturellen Inhalte des Google-Dokuments [DOCS_TITLE].“
• „Lies das Tabellenblatt ‚Sheet1‘ aus der Google-Tabelle [SHEETS_TITLE] vor.“
• „Zeige mir das verbalisierte Layout von Google-Präsentation [SLIDES_TITLE].“

Google Kalender

So suchen Sie in Ihrem Zeitplan:

• „Welche Besprechungen habe ich diese Woche?“
• „Habe ich morgen Nachmittag kostenlose Zeit?“

Google Chat

So suchen Sie nach Nachrichten:

• Suche in „[SPACE_NAME]“ nach Nachrichten, die „[KEYWORD]“ enthalten

People API

Suchen Sie in Ihrem Profil oder in Ihren Kontakten:

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

Mehrere Dienste kombinieren

Die wahre Stärke von MCP liegt in der Orchestrierung von Aufgaben über mehrere Dienste hinweg. Hier sind einige Prompts, die die dienstübergreifenden Funktionen veranschaulichen:

• „Suche in Drive nach Dateien, die sich auf ‚[PROJECT_NAME] milestone updates‘ beziehen, fasse ihren Inhalt zusammen, suche nach der E-Mail-Adresse für ‚[NAME]‘ und erstelle einen Gmail-Entwurf mit der Zusammenfassung.“

Weitere Tools entdecken

Dies sind nur einige Beispiele für die Möglichkeiten. Eine vollständige Liste der für die einzelnen Dienste verfügbaren Tools 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 APIs und MCP-Dienste deaktivieren, die Sie aktiviert haben:

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

Löschen Sie die OAuth-Clientanmeldedaten 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 Enterprise – Übersicht
• Google Workspace MCP-Server mit Antigravity im Gemini Enterprise-Codelab
• Antigravity