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 wird die Antigravity CLI behandelt. Weitere Informationen zur Umstellung finden Sie in diesem offiziellen Blogpost zur Antigravity CLI.

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

In diesem Codelab erfahren Sie, wie Sie das Model Context Protocol (MCP) verwenden, um Ihre Google Workspace-Daten mit Antigravity 2.0, der IDE und/oder der Befehlszeile zu verbinden. MCP ist ein offener Standard, der es KI-Modellen ermöglicht, Tools von Remote-Servern 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, um auf diese MCP-Dienste zuzugreifen.
• 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 Developer Preview Program: Der Zugriff auf Google Workspace-MCP-Server ist Teil des Public Developer Preview Program. Falls Sie sich noch nicht registriert haben, können Sie das unter https://developers.google.com/workspace/preview tun. Dort erfahren Sie auch, ob Ihr Konto für das Programm zugelassen wurde.

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

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-Anwendung 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 Features 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 nicht konfiguriert ist.
2. Konfigurieren Sie die App-Informationen:
   • App-Name: Google Workspace MCP Servers
   • E‑Mail-Adresse für Nutzersupport: Wählen Sie Ihre E‑Mail-Adresse aus.
3. Zielgruppe konfigurieren: 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 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. Gehen Sie zu Datenzugriff > Bereiche hinzufügen oder entfernen. Fügen Sie unter Bereiche manuell hinzufügen Folgendes 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 die Google Auth Platform > Clients > Client erstellen 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. Wählen Sie Diesen Client für einen KI-basierten Agenten verwenden aus.
6. 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 Sie jetzt Antigravity für die Verwendung dieser Endpunkte. Wenn Sie Antigravity 2.0, die IDE und/oder die Befehlszeile nicht installiert haben, folgen Sie der Anleitung auf der Antigravity-Website.

Benutzerdefinierte MCP-Server hinzufügen

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

1. Öffnen Sie sie in Ihrem bevorzugten Texteditor.

   Hinweis: Wenn Sie die Antigravity IDE installiert haben, können Sie direkt darauf zugreifen. Gehen Sie dazu so vor:

   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 sie in die folgende benutzerdefinierte MCP-Serverkonfiguration: Ersetzen Sie zuvor 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.
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

Sie sollten alle MCP-Server sehen, die Sie als in Antigravity installiert konfiguriert haben: gws-universal, gws-gmail, gws-drive, gws-docs, gws-sheets, gws-slides, gws-calendar, gws-chat und gws-people. Sie müssen jede dieser Oberflächen für jede Antigravity-Oberfläche authentifizieren, da OAuth-Tokens nicht zentralisiert sind.

Fehlerbehebung bei Unternehmensrichtlinien: Wenn ein MCP-Server nach dem Klicken auf Aktualisieren Unauthorized / Blocked by Admin Policy anzeigt, ist dieser Dienst nicht in der Zulassungsliste für Gemini Enterprise Ihrer Organisation enthalten. Bitten Sie Ihren Administrator, den Dienstendpunkt hinzuzufügen, und geben Sie das Codelab für Gemini Enterprise-Administratoren an ihn weiter, um eine Anleitung zur Konfiguration zu erhalten.

Antigravity 2.0

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

4. Für jeden installierten MCP-Server in der Liste:
   1. Klicken Sie auf Authentifizieren.
   
   2. Führen Sie den Authentifizierungsablauf im neuen Browserfenster durch, das sich öffnet.
   3. Klicken Sie anschließend auf In Zwischenablage kopieren.
   
   4. Fügen Sie den soeben 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. Gehen Sie zu Anpassungen.
3. Klicken Sie unter Installierte MCP-Server auf Aktualisieren.

4. Für jeden installierten MCP-Server in der Liste:
   1. Klicken Sie auf Authentifizieren.
   
   2. Führen Sie den Authentifizierungsablauf im neuen Browserfenster durch, das sich öffnet.
   3. Klicken Sie anschließend auf In Zwischenablage kopieren.
   
   4. Fügen Sie den soeben kopierten Autorisierungscode in das Textfeld ein, das in den Einstellungen der 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 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 den Authentifizierungsvorgang durch.
   
   4. Klicken Sie anschließend auf In Zwischenablage kopieren.
   
   5. Fügen Sie den kopierten Autorisierungscode in das Textfeld ein, das im Terminal mit der Antigravity CLI angezeigt wird, und drücken Sie die Eingabetaste.
   
   6. Der Status Auth Needed (Autorisierung erforderlich) wird jetzt durch Authed (Autorisiert) ersetzt.
   

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 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 ein paar Sätzen zusammen, was zuletzt in meinem Google Workspace-Konto passiert ist.“
• „Finde alles, was mit [PROJEKTNAME] zu tun hat, in meinen E‑Mails, Dokumenten und Chatnachrichten.“
• „Wann ist meine nächste Besprechung zum Marketingplan und was sind die neuesten Notizen und Chatnachrichten dazu?“

Gmail

Versuchen Sie, Ihre E‑Mails zu suchen oder zu verwalten:

• „Fasse die letzten 5 E‑Mails zusammen, die ich erhalten habe.“
• „Entwirf eine E‑Mail an [EMAIL_ADDRESS], in der du nach einem Update zum Projekt [PROJECT_NAME] fragst.“

Google Drive

Versuchen Sie, Dateien zu suchen oder zu lesen:

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

Google Docs, Google Sheets und Google Präsentationen

Suchen Sie in Ihren Drive-Ressourcen:

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

Google Kalender

Versuche, in deinem Kalender zu suchen:

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

Google Chat

Versuchen Sie, nach Nachrichten zu suchen:

• „Suche nach Nachrichten mit ‚[SCHLÜSSELWORT]‘ in ‚[SPACE_NAME]‘“

People API

Suchen Sie in Ihrem Profil oder in Ihren Kontakten:

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

Mehrere Dienste kombinieren

Die wahre Stärke von MCP zeigt sich, wenn Aufgaben über mehrere Dienste hinweg orchestriert werden. Probieren Sie diese Prompts aus, die die dienstübergreifenden Funktionen veranschaulichen:

• „Suche in Drive nach Dateien, die sich auf ‚[PROJEKTNAME] Meilenstein-Updates‘ beziehen, fasse ihren Inhalt zusammen, suche die E‑Mail-Adresse von ‚[NAME]‘ und erstelle einen Gmail-Entwurf mit der Zusammenfassung.“

Weitere Tools entdecken

Dies sind nur einige Beispiele für die Möglichkeiten, die Ihnen zur Verfügung stehen. Eine vollständige Liste der für die einzelnen Dienste verfügbaren Tools finden Sie im Abschnitt Unterstützte Produkte der offiziellen Dokumentation. Dort können Sie die Tools auch ausprobieren.

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 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-Konsole, wenn Sie sie nicht mehr verwenden möchten.

7. Glückwunsch

Glückwunsch! Sie haben die offiziellen Google Workspace-MCP-Server mit Antigravity 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 in Gemini Enterprise – Codelab
• Antigravity