Erste Schritte mit dem Google Workspace MCP und der Gemini CLI

1. Einführung

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

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, die von Remoteservern bereitgestellt werden, 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 für die Verwendung dieser 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
• 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 ö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 Client für Desktopanwendungen 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 Desktop-App aus.
3. Geben Sie den Namen Gemini CLI ein.
4. 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 nun die Gemini CLI, damit 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. Für die OAuth-Authentifizierung ist in der Gemini CLI ein lokaler Browser erforderlich. Verwenden Sie das Terminal Ihres lokalen Computers. Weitere Informationen finden Sie unter Anforderungen an Browserweiterleitungen.

Konfigurationsdatei erstellen

Öffnen oder erstellen Sie ~/.gemini/settings.json in Ihrem Home-Verzeichnis 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 bestätigen

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

Gemini CLI starten

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

gemini

Authentifizieren

Authentifizieren Sie sich für die Dienste, 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 jeden Dienst zu autorisieren.

Verbindung prüfen

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

/mcp list

In der Ausgabe sollte angezeigt werden, dass die Dienste Ready sind und ihre Tools aufgeführt werden.

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

Google Kalender

Fragen Sie Gemini zum Beispiel nach Ihrem Terminplan:

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

Google Chat

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

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

Google Drive

Sie können Gemini zum Beispiel bitten, Dateien zu suchen oder zu 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

Sie können Gemini bitten, Ihre E‑Mails zu suchen oder zu verwalten:

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

Sie können Gemini zum Beispiel Folgendes fragen:

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

Mehrere Dienste kombinieren

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

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

8. Glückwunsch

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

Das haben Sie gelernt

• So aktivieren Sie Google Workspace MCP-Dienste in Google Cloud.
• So konfigurieren Sie einen OAuth-Client für MCP.
• So interagieren Sie mit Standardtools über die Gemini CLI mit Google Workspace-Daten.

Referenzdokumente

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