Google Workspace-MCP-Server in Google Antigravity

1. Einführung

Hinweis:Verwenden Sie die Gemini CLI? Dann rufen Sie stattdessen dieses Codelab auf. Dieser Leitfaden bezieht sich speziell auf Antigravity.

In diesem Codelab erfahren Sie, wie Sie das Model Context Protocol (MCP) verwenden, um Antigravity mit Ihren Google Workspace-Daten zu verbinden. MCP ist ein offener Standard, mit dem KI-Modelle Tools, die von Remote-Servern bereitgestellt werden, sicher verwenden können. Sie richten Antigravity so ein, dass es mit Gmail, Google Drive, 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 lustigen und nützlichen Prompts , die mit Ihren Google Workspace-Daten interagieren.

Voraussetzungen

• Ein Webbrowser wie Chrome
• Ein Google Cloud-Projekt
• Ein Google Workspace-Konto
• Antigravity auf Ihrem lokalen Computer installiert

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 und prüfen Sie, ob Ihr Konto für das Programm akzeptiert wurde: https://developers.google.com/workspace/preview.

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

Um die Google Workspace MCP-Server zu verwenden, müssen Sie die Standard-Google Workspace APIs aktivieren. Einige MCP-Server funktionieren unabhängig, für andere muss die zugrunde liegende Standard-API aktiviert sein:

• Für Gmail und Chat sind weiterhin die Standard-APIs erforderlich.
• Für Drive ist für bestimmte Tools die Standard-API erforderlich.
• Für Google Kalender muss die Standard-API nicht aktiviert sein.
• Die People API verarbeitet sowohl den Standardzugriff als auch die MCP-Funktionalität. Daher muss kein separater MCP-Dienst aktiviert werden.

APIs aktivieren

MCP-Dienste aktivieren

Aktivieren Sie als Nächstes die dedizierten MCP-Dienste für die Produkte.

MCP-Dienste aktivieren

Google Chat-App konfigurieren

Um den Google Chat MCP-Server zu verwenden, müssen Sie in Ihrem Google Cloud-Projekt eine Google Chat-App 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 Google 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 Funktionalität 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. Sie müssen einen OAuth-Zustimmungsbildschirm konfigurieren und einen Webanwendungsclient erstellen.

OAuth-Zustimmungsbildschirm einrichten

Die Google Workspace MCP-Server verwenden OAuth 2.0 für die Authentifizierung. 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 , falls noch nicht konfiguriert.
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, falls „Intern“ nicht verfügbar ist).
4. Konfigurieren Sie die Kontaktdaten: Geben Sie Ihre E‑Mail-Adresse ein.
5. Lesen und akzeptieren Sie die Richtlinie zu Nutzerdaten und 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:
   • 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.users.readstate.readonly
   • Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • 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 sie im nächsten Schritt.

4. Antigravity konfigurieren

Konfigurieren wir nun Antigravity für die Verwendung dieser Endpunkte. Wenn Sie Antigravity noch nicht installiert haben, folgen Sie der Installationsanleitung auf der Antigravity-Website.

Benutzerdefinierte MCP-Server hinzufügen

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.

4. Ändern Sie die neu geöffnete Datei mcp_config.json mit der folgenden benutzerdefinierten MCP-Serverkonfiguration. Ersetzen Sie dazu die Platzhalter <YOUR_CLIENT_ID> und <YOUR_CLIENT_SECRET> durch die OAuth-Client-ID und den Clientschlüssel, die Sie in den vorherigen Schritten erstellt haben:

{
  "mcpServers": {
    "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-drive": {
      "serverUrl": "https://drivemcp.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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

5. Kehren Sie zu MCP-Server verwalten zurück und klicken Sie auf Aktualisieren.

Benutzerdefinierte MCP-Server authentifizieren

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

2. Rufen Sie Anpassungen auf.

3. Führen Sie für jeden Server unter INSTALLIERTE MCP-SERVER folgende Schritte aus:
   1. Klicken Sie auf Authentifizieren.

2. Führen Sie den Authentifizierungsprozess im neuen Browserfenster aus.
3. Klicken Sie anschließend auf In die Zwischenablage kopieren.

4. Schließen Sie das Browserfenster.
5. Fügen Sie den soeben kopierten Autorisierungscode in das Textfeld ein, das in den Einstellungen von Antigravity angezeigt wird.
6. Klicken Sie auf Senden.

5. Test tools

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

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

Google Kalender

Versuchen Sie, in Ihrem Terminkalender zu suchen:

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

Google Chat

Versuchen Sie, nach Nachrichten zu suchen:

• „Suche in ‚[SPACE_NAME]‘ nach Nachrichten mit ‚[KEYWORD]‘“

Google Drive

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

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

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 ‚[EMAIL_ADDRESS]‘, in der ich um ein Update zum Projekt ‚[PROJECT_NAME]‘ bitte.“

People API

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

• „Wie lautet mein Name laut meinem Google-Profil?“
• „Suche nach 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 die dienstübergreifenden Funktionen demonstrieren:

• „Suche in Drive nach Dateien zu ‚[PROJECT_NAME] – 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-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 Editor: MCP-Integration