Erste Schritte mit dem Google Workspace MCP und der Gemini CLI

1. Einführung

Hinweis: Verwenden Sie noch die Gemini CLI? In diesem Codelab erfahren Sie, wie Sie Google Workspace-MCP-Server mit der Antigravity-Befehlszeile einrichten. Weitere Informationen zur Umstellung finden Sie in diesem offiziellen Blogpost.

In diesem Codelab erfahren Sie, wie Sie das Model Context Protocol (MCP) verwenden, um die Gemini CLI mit Ihren Google Workspace-Daten zu verbinden. MCP ist ein offener Standard, der es KI-Modellen ermöglicht, Tools von Remote-Servern sicher zu verwenden. Sie verwenden die Gemini CLI als Client, um mit Gmail, Google Drive, Google Kalender, Google Chat und der People API zu interagieren, ohne Code schreiben zu müssen.

Aufgaben

• Aktivieren Sie Google Workspace MCP-Dienste in Ihrem Google Cloud-Projekt.
• Konfigurieren Sie die Gemini CLI so, dass diese MCP-Dienste verwendet werden.
• 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
• Ein Google Workspace-Konto
• Gemini CLI auf Ihrem lokalen Computer installiert

Dieses Codelab dauert etwa 30 Minuten.

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 sich unter https://developers.google.com/workspace/preview anmelden und prüfen, 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. 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 Drive ist die Standard-API für bestimmte Tools erforderlich.
• Für Google Kalender muss die Standard-API nicht aktiviert sein.
• Die People API verarbeitet sowohl den Standardzugriff als auch die MCP-Funktionen. 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

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

Die Google Workspace-MCP-Server verwenden OAuth 2.0 für die sichere Authentifizierung. Sie müssen einen OAuth-Zustimmungsbildschirm konfigurieren und einen Desktopanwendungsclient 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, 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. Kontaktdaten konfigurieren: 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:
   • 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

Wenn Sie einen OAuth 2.0-Client für die Google Workspace-MCP-Server konfigurieren, müssen Sie die Einstellung für die agentische Klassifizierung (is_agentic) aktivieren, indem Sie Diesen Client für einen KI-basierten Agenten verwenden auswählen. OAuth-Clients, für die diese Einstellung nicht aktiviert ist, können keine Google Workspace-MCP-Endpunkte aufrufen.

1. Rufen Sie Google Auth Platform > Clients > Client erstellen auf (oder APIs und Dienste > Anmeldedaten > Anmeldedaten erstellen > OAuth-Client-ID).
2. Wählen Sie als Anwendungstyp Desktop-Anwendung aus.
3. Geben Sie den Namen Gemini CLI ein.
4. Wählen Sie Diesen Client für einen KI-basierten Agenten verwenden aus, um das Klassifizierungsflag is_agentic für den OAuth-Client zu aktivieren.
5. Klicken Sie auf Erstellen und kopieren Sie die Client-ID und den Clientschlüssel. Sie benötigen sie im nächsten Schritt.

4. Gemini CLI konfigurieren

Konfigurieren Sie jetzt die Gemini CLI so, dass diese Endpunkte verwendet werden. Wenn Sie die Gemini CLI nicht installiert haben, folgen Sie der Installationsanleitung auf der Gemini CLI-Website.

Lokale Umgebung erforderlich: Verwenden Sie für diesen Schritt nicht Cloud Shell. Die Gemini CLI erfordert einen lokalen Browser für die OAuth-Authentifizierung. Verwenden Sie das Terminal Ihres lokalen Computers. Weitere Informationen finden Sie unter Anforderungen an die Browserweiterleitung.

Konfigurationsdatei erstellen

Öffnen oder erstellen Sie ~/.gemini/settings.json in Ihrem Basisverzeichnis und fügen Sie die folgende Konfiguration hinzu. Ersetzen Sie die Platzhalter durch Ihre OAuth-Anmeldedaten.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. MCP-Server authentifizieren und verifizieren

Bevor Sie die MCP-Server verwenden können, müssen Sie sich authentifizieren und prüfen, ob sie verbunden sind.

Gemini CLI starten

Führen Sie im Terminal den folgenden Befehl aus, um die Gemini CLI zu starten:

gemini

Authentifizieren

Authentifizieren Sie sich bei den Diensten, die Sie testen möchten, indem Sie den entsprechenden Befehl in der Gemini CLI ausführen. Sie müssen sich nur bei den Diensten authentifizieren, die Sie in diesem Codelab verwenden möchten.

Kalender

/mcp auth calendar

Chat

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

Personen

/mcp auth people

Folgen Sie der Anleitung in Ihrem Browser, um die einzelnen Dienste zu autorisieren.

Verbindung prüfen

Prüfen Sie, ob die Tools geladen und bereit sind:

/mcp list

Die Ausgabe sollte zeigen, dass die Dienste Ready sind, und ihre Tools auflisten.

6. MCP-Server testen

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.

Google Kalender

Fragen Sie Gemini nach Ihrem Terminplan:

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

Google Chat

Sie können Gemini zum Beispiel bitten, nach Nachrichten zu suchen:

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

Google Drive

Sie können Gemini bitten, 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 ‚[DATEINAME]‘ und fasse die wichtigsten Ziele zusammen.“

Gmail

Sie können Gemini bitten, Ihre E‑Mails zu durchsuchen 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 dem aktuellen Stand des Projekts [PROJECT_NAME] fragst.“

People API

Fragen Sie Gemini nach Ihrem Profil oder Ihren Kontakten:

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

Mehrere Dienste kombinieren

Das wahre Potenzial von MCP zeigt sich, wenn Gemini Aufgaben über mehrere Dienste hinweg orchestriert. 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.

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

8. Glückwunsch

Glückwunsch! Sie haben die offiziellen Google Workspace-MCP-Server mit der Gemini CLI konfiguriert und getestet.

Das haben Sie gelernt

• Google Workspace-MCP-Dienste in Google Cloud aktivieren
• OAuth-Client für MCP konfigurieren
• Wie Sie die Gemini CLI verwenden, um mit Standardtools mit Google Workspace-Daten zu interagieren.

Referenzdokumente

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