Google Workspace-MCP-Server in Antigravity

1. Einführung

Hinweis:Verwenden Sie die Gemini CLI? 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, 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 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 interessanten 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 Developer Preview Program: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.

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. Einige MCP-Server funktionieren unabhängig, für andere muss die zugrunde liegende Standard-API aktiviert sein:

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

APIs aktivieren

MCP-Dienste aktivieren

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

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

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 zur 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, wenn die Funktion noch nicht konfiguriert ist.
2. Konfigurieren Sie App-Informationen:
   • 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:
   • 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 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 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 das Secret, 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. Gehe zu Anpassungen.

3. Für jeden Server, der unter INSTALLIERTE MCP-SERVER aufgeführt ist:
   1. Klicken Sie auf Authentifizieren.

2. Führen Sie den Authentifizierungsvorgang im neuen Browserfenster durch, das sich öffnet.
3. Klicken Sie anschließend auf In Zwischenablage kopieren.

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

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 folgenden Prompts (z.B. [NAME], [FILE_NAME]) durch tatsächliche Werte aus Ihren eigenen Google Workspace-Daten.

Google Kalender

So können Sie in Ihrem Zeitplan suchen:

• „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.

Google Drive

Dateien suchen oder lesen:

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

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.“

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] – Meilenstein-Updates‘ beziehen, fasse ihren Inhalt zusammen, suche nach der E‑Mail-Adresse von ‚[NAME]‘ und erstelle einen Gmail-Entwurf mit der Zusammenfassung.“

Weitere Tools

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 in der offiziellen Dokumentation im Abschnitt Unterstützte Produkte.

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 Editor: MCP-Integration