Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

KI-Agenten mit dem Universal Search MCP Server für Workspace in Workspace suchen lassen

Der MCP-Server für die universelle Suche für Google Workspace verwendet den Model Context Protocol (MCP)-Standard, damit KI-Agenten Ihre Workspace-Artefakte durchsuchen können. Dieser Server ermöglicht die Suche in mehreren Google Workspace-Produkten, darunter Gmail-Nachrichten, Google Drive-Dateien, Google Kalender-Termine sowie Google Chat-Bereiche und -Nachrichten – und zwar mit nur einem Tool.

Der Universal Search MCP-Server bietet KI-Agenten eine standardisierte Möglichkeit, in Ihrem gesamten Google Workspace-Konto nach Informationen zu suchen, ohne dass einzelne produktspezifische Tools aufgerufen werden müssen.

Vorbereitung

Mitgliedschaft im Google Workspace Entwicklervorschauprogramm.
Ein Google Cloud-Projekt. Informationen zum Erstellen eines Projekts finden Sie unter Projekt erstellen.
Ein MCP-Client wie Google Antigravity.
Richten Sie die gcloud CLI in einer der folgenden Entwicklungsumgebungen ein, um die Befehle auf dieser Seite auszuführen:
Cloud Shell
Wenn Sie ein Onlineterminal mit bereits eingerichteter gcloud CLI einrichten möchten, aktivieren Sie Cloud Shell.

Cloud Shell aktivieren
Lokale Shell
So verwenden Sie eine lokale Entwicklungsumgebung:
1. Installieren Sie die Google Cloud CLI. Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie gcloud components update ausführen.
2. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, melden Sie sich mit Ihrer föderierten Identität in der gcloud CLI an. Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.
3. Initialisieren Sie die Google Cloud CLI.

MCP-Server für die universelle Suche konfigurieren

Wenn Sie den MCP-Server für die universelle Suche verwenden möchten, müssen Sie ihn in Ihrem Google Cloud-Projekt aktivieren und dann Ihren MCP-Client so konfigurieren, dass er eine Verbindung zu ihm herstellt.

APIs aktivieren

Wenn Sie den MCP-Server für die universelle Suche verwenden möchten, aktivieren Sie die Google Workspace MCP API in Ihrem Google Cloud-Projekt:

Befehlszeile

gcloud services enable workspacemcp.googleapis.com \
  --project=PROJECT_ID

Ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID.

Console

Aktivieren Sie die APIs in der Google Cloud Console:

APIs aktivieren

Der MCP-Server für die universelle Suche verwendet OAuth 2.0 für die Authentifizierung und Autorisierung. Sie müssen den OAuth-Zustimmungsbildschirm konfigurieren, bevor Sie eine OAuth-Client-ID erstellen können.

Wenn Sie den OAuth-Zustimmungsbildschirm bereits für andere MCP-Server konfiguriert haben, müssen Sie die erforderlichen Bereiche für den MCP-Server für die universelle Suche hinzufügen.

Wenn Sie sich beim Universal Search MCP-Server authentifizieren, können Sie alle angeforderten Bereiche oder nur eine Teilmenge davon authentifizieren. Der Server berücksichtigt diese Auswahl und sucht nur in den Produkten, für die Zugriff gewährt wurde.

Wenn Sie sich beispielsweise mit allen folgenden Bereichen authentifizieren:

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

Der Universal Search MCP Server sucht in Gmail, Google Drive, Google Kalender und Google Chat.

Wenn Sie jedoch nur Zugriff auf https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly und https://www.googleapis.com/auth/chat.messages.readonly gewähren (und https://www.googleapis.com/auth/gmail.readonly weglassen), liefert die universelle Suche nur Ergebnisse aus Google Drive, Google Kalender und Google Chat. Ihre E‑Mails werden nicht durchsucht und es werden keine Gmail-Ergebnisse zurückgegeben.

Rufen Sie in der Google Cloud Console Google Auth Platform > Datenzugriff auf.
Klicken Sie auf Bereiche hinzufügen oder entfernen.
Fügen Sie einen oder mehrere der folgenden Bereiche hinzu:
- 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
Klicken Sie auf Aktualisieren und dann auf Speichern.

Eine detaillierte Anleitung zum Einrichten des Zustimmungsbildschirms finden Sie im Hilfeartikel Google Workspace-MCP-Server konfigurieren.

MCP-Client konfigurieren

Wenn Sie den MCP-Server für die universelle Suche Ihrem MCP-Client hinzufügen möchten, folgen Sie der Anleitung für Ihren Client.

Antigravity

Wenn Sie den MCP-Server für die universelle Suche zu Antigravity hinzufügen möchten, fügen Sie die Serverkonfiguration in Ihre mcp_config.json-Datei ein. Diese Anleitung gilt für Antigravity 2.0, Antigravity IDE und Antigravity CLI.

Erstellen Sie eine OAuth 2.0-Client-ID und ein Secret vom Typ Webanwendung. Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und fügen Sie dann https://antigravity.google/oauth-callback in das Feld URIs ein. Wählen Sie Diesen Client für einen KI-basierten Agenten verwenden aus. Eine Anleitung finden Sie im Hilfeartikel Google Workspace-MCP-Server konfigurieren.
Öffnen oder erstellen Sie die Konfigurationsdatei ~/.gemini/config/mcp_config.json.

Fügen Sie die workspace-universal-Konfiguration zu mcp_config.json hinzu:

{
  "mcpServers": {
    "workspace-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

Ersetzen Sie Folgendes:

OAUTH_CLIENT_ID: Die von Ihnen erstellte Client-ID.
OAUTH_CLIENT_SECRET: Der von Ihnen erstellte Clientschlüssel.

mcp_config.json sparen.
Authentifizieren Sie den MCP-Server. Sie können sich entweder über die GUI-Einstellungen oder die Befehlszeile authentifizieren:
- Für die Antigravity IDE oder die GUI (Antigravity 2.0):
  1. Öffnen Sie die Einstellungen, indem Sie beispielsweise links unten auf Einstellungen klicken oder die Antigravity-Nutzereinstellungen öffnen.
  2. Gehen Sie zu Anpassungen.
  3. Klicken Sie unter Installierte MCP-Server auf Aktualisieren.
  4. Suchen Sie in der Liste nach workspace-universal, klicken Sie auf Authentifizieren, melden Sie sich in Ihrem Google-Konto an, kopieren Sie den Autorisierungscode, fügen Sie ihn in das Eingabefeld ein und klicken Sie auf Senden.
- Für die Antigravity CLI:
  1. Starten Sie die Antigravity CLI:
```
agy
```
  2. Öffnen Sie das interaktive MCP-Verwaltungssteuerfeld mit folgendem Befehl:
```
/mcp
```
  3. Wählen Sie mit den Pfeiltasten workspace-universal aus, gehen Sie zur Aktion Authentifizieren und drücken Sie die Eingabetaste. Schließen Sie die Anmeldung in Ihrem Browser ab, kopieren Sie den Autorisierungscode, fügen Sie ihn in die Terminal-Eingabeaufforderung ein und drücken Sie die Eingabetaste.
Prüfen Sie, ob der Server richtig konfiguriert ist und ausgeführt wird:
- Für die Antigravity-IDE oder ‑GUI: Neben workspace-universal wird unter Anpassungen > Installierte MCP-Server der Button Abmelden angezeigt.
- Für die Antigravity CLI: Öffnen Sie den Bereich /mcp, um Ihre konfigurierten MCP-Server anzusehen. Bei verifizierten und authentifizierten Servern wird im interaktiven TUI-Bereich neben dem Namen Authed angezeigt. Sie können den Server workspace-universal in der Dashboard-Ansicht auswählen, um seinen Status zu prüfen und alle verfügbaren Tools aufzulisten.

Claude

Wenn Sie den Universal Search-MCP-Server zu Claude hinzufügen möchten, konfigurieren Sie einen benutzerdefinierten Connector.

Erstellen Sie eine OAuth 2.0-Client-ID und ein Secret vom Typ Webanwendung und wählen Sie Diesen Client für einen KI-Agenten verwenden aus. Eine Anleitung finden Sie im Hilfeartikel Google Workspace-MCP-Server konfigurieren.
Fügen Sie in den Claude-Einstellungen einen benutzerdefinierten Connector hinzu:
- Server name: Universal Search MCP Server
- Remote-MCP-Server-URL: https://workspacemcp.googleapis.com/mcp/v1
- OAuth-Client-ID und OAuth-Clientschlüssel: Geben Sie Ihre Anmeldedaten ein.
- Bereiche: Schließen Sie https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly und https://www.googleapis.com/auth/chat.messages.readonly ein.

MCP-Server für die universelle Suche testen

Stellen Sie Ihrem MCP-Client Fragen, die eine Suche in verschiedenen Produkten erfordern:

„Finde alles, was mit Projekt X 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?“

Wenn die Tools erfolgreich ausgeführt werden und Sie relevante Antworten von mehreren Produkten erhalten, ist Ihr Universal Search-MCP-Server korrekt konfiguriert.

Unterstützte Tools

Der MCP-Server für die universelle Suche bietet das folgende Tool:

search_corpus: Führt basierend auf der angegebenen Abfrage eine Suche in mehreren Google Workspace-Produkten (Google Drive, Gmail, Google Kalender und Google Chat) durch.

KI-Agenten mit dem Universal Search MCP Server für Workspace in Workspace suchen lassen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Vorbereitung

Cloud Shell

Lokale Shell

MCP-Server für die universelle Suche konfigurieren

APIs aktivieren

Befehlszeile

Console

OAuth-Zustimmungsbildschirm einrichten

MCP-Client konfigurieren

Antigravity

Claude

MCP-Server für die universelle Suche testen

Unterstützte Tools

KI-Agenten mit dem Universal Search MCP Server für Workspace in Workspace suchen lassen