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

Der Universal Search MCP-Server für Google Workspace verwendet den MCP-Standard (Model Context Protocol), 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 produktspezifische Tools aufgerufen werden müssen.

Vorbereitung

MCP-Server für die universelle Suche konfigurieren

Wenn Sie den Universal Search-MCP-Server 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 Universal Search MCP Server verwenden möchten, aktivieren Sie die Google Workspace MCP API und die APIs für die Produkte, in denen Sie suchen möchten, in Ihrem Google Cloud-Projekt:

  • Gmail API
  • Google Drive API
  • Google Calendar API
  • Google Chat API

  • Google Workspace MCP API

Befehlszeile

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
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 Universal Search MCP-Server 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 Universal Search-MCP-Server 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 durchsucht nur die Produkte, 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 durchsucht 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), werden bei der universellen Suche nur Ergebnisse aus Google Drive, Google Kalender und Google Chat zurückgegeben. Es wird nicht in Ihren E‑Mails gesucht und es werden keine Gmail-Ergebnisse zurückgegeben.

  1. Rufen Sie in der Google Cloud Console Google Auth Platform > Data Access auf.
  2. Klicken Sie auf Bereiche hinzufügen oder entfernen.

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

  4. Klicken Sie auf Aktualisieren und dann auf Speichern.

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

MCP-Client konfigurieren

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

Antigravity

Wenn Sie den Universal Search MCP-Server zu Antigravity hinzufügen möchten, fügen Sie die Serverkonfiguration in Ihre mcp_config.json-Datei ein. Diese Anleitung unterstützt Antigravity 2.0, Antigravity IDE und Antigravity CLI.

  1. Erstellen Sie eine OAuth 2.0-Client-ID und ein Client-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. Eine Anleitung finden Sie unter Google Workspace-MCP-Server konfigurieren.

  2. Öffnen oder erstellen Sie die Konfigurationsdatei ~/.gemini/config/mcp_config.json.

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

  4. mcp_config.json sparen.

  5. Authentifizieren Sie den MCP-Server. Sie können sich entweder über die GUI-Einstellungen oder über die CLI authentifizieren:

    • Für Antigravity IDE oder GUI (Antigravity 2.0):

      1. Öffnen Sie die Einstellungen (z.B. durch Klicken auf Einstellungen unten links oder durch Öffnen der Antigravity-Nutzereinstellungen).
      2. Gehe 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-Verwaltungsfeld 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 den Anmeldevorgang in Ihrem Browser ab, kopieren Sie den Autorisierungscode, fügen Sie ihn in die Terminaleingabeaufforderung ein und drücken Sie die Eingabetaste.

  6. 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 Customizations > Installed MCP Servers die Schaltfläche Sign out (Abmelden) angezeigt.
    • Für die Antigravity CLI:Öffnen Sie den Bereich /mcp, um die konfigurierten MCP-Server aufzurufen. Bei verifizierten und authentifizierten Servern wird im interaktiven TUI-Bereich neben dem Namen Authed angezeigt. Sie können den workspace-universal-Server 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.

  1. Erstellen Sie eine OAuth 2.0-Client-ID und ein Client-Secret vom Typ Webanwendung. Eine Anleitung finden Sie unter Google Workspace-MCP-Server konfigurieren.

  2. 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: Umfassen 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.

MCP-Server für die universelle Suche testen

Stellen Sie Ihrem MCP-Client Fragen, für die eine Suche in verschiedenen Produkten erforderlich ist:

  • „Finde alles, was mit Projekt X in meinen E‑Mails, Dokumenten und Chatnachrichten zu tun hat.“
  • „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 richtig konfiguriert.

Unterstützte Tools

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

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