Erste Schritte mit dem Google Workspace MCP und der Gemini CLI

1. Einführung

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, mit dem KI-Modelle sicher Tools verwenden können, die von Remote-Servern bereitgestellt werden. 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

• Google Workspace MCP-Dienste in Ihrem Google Cloud-Projekt aktivieren.
• Die Gemini CLI so konfigurieren, dass diese MCP-Dienste verwendet werden.
• Die Integration mit lustigen und nützlichen Prompts testen, die mit Ihren Google Workspace-Daten interagieren.

Voraussetzungen

• Ein Webbrowser wie Chrome
• Ein Google Cloud-Projekt
• Ein Google Workspace-Konto
• Die Gemini CLI ist auf Ihrem lokalen Computer installiert

Für dieses Codelab benötigen Sie etwa 30 Minuten.

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 unter https://developers.google.com/workspace/preview und prüfen Sie, 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 Google 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

Wenn Sie den Google Chat MCP-Server verwenden möchten, 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 interaktiven Funktionen, indem Sie die Option Interaktive Funktionen aktivieren deaktivieren.
   • 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 , 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 Sie die Richtlinie zu Nutzerdaten und stimmen Sie ihr zu. 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 für die Server, die Sie verwenden möchten, Folgendes hinzu:
   • 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 Desktop-App als Anwendungstyp aus.
3. Geben Sie Gemini CLI als Namen ein.
4. Klicken Sie auf Erstellen und kopieren Sie die Client-ID und den Clientschlüssel. Sie benötigen diese im nächsten Schritt.

4. Gemini CLI konfigurieren

Konfigurieren wir nun die Gemini CLI, um diese Endpunkte zu verwenden. 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 die Cloud Shell. Für die OAuth-Authentifizierung ist ein lokaler Browser erforderlich. Verwenden Sie das Terminal Ihres lokalen Computers. Weitere Informationen finden Sie unter Anforderungen für die Browserweiterleitung.

Konfigurationsdatei erstellen

Öffnen Sie ~/.gemini/settings.json in Ihrem Home-Verzeichnis oder erstellen Sie die Datei 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 prüfen

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 den folgenden Befehl in Ihrem Terminal 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 jeden Dienst 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 die zugehörigen Tools auflisten.

6. MCP-Server testen

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

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

Google Kalender

Fragen Sie Gemini nach Ihrem Zeitplan:

• "Was sind meine anstehenden Termine diese Woche?"
• "Habe ich morgen Nachmittag Zeit?"

Google Chat

Bitten Sie Gemini, nach Nachrichten zu suchen:

• "Suche in ‘[SPACE_NAME]’ nach Nachrichten mit ‘[KEYWORD]'"

Google Drive

Bitten Sie Gemini, Dateien zu suchen oder 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

Bitten Sie Gemini, 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 nach einem Update zum Projekt ‘[PROJECT_NAME]’ fragst."

People API

Fragen Sie Gemini nach Ihrem Profil oder Ihren Kontakten:

• "Wie lautet mein Name laut meinem Google-Profil?"
• "Suche nach Kontaktdaten für ‘[NAME]'."

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 demonstrieren:

• "Suche in Drive nach Dateien zu ‘[PROJECT_NAME] milestone updates’, fasse den 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.

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

• Google Workspace MCP-Dienste in Google Cloud aktivieren
• OAuth-Client für MCP konfigurieren
• Mit der Gemini CLI und Standardtools mit Google Workspace-Daten interagieren

Referenzdokumente

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