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 Standard Model Context Protocol (MCP) , damit KI-Agenten in Ihren Workspace-Artefakten suchen können. Mit diesem Server können Sie mit einem einzigen Tool in mehreren Google Workspace-Produkten suchen, darunter Gmail-Nachrichten, Google Drive-Dateien, Google Kalender-Termine sowie Google Chat-Gruppenbereiche und -Nachrichten.

Der MCP-Server für die universelle Suche bietet eine standardisierte Möglichkeit für KI-Agenten, 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 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 und die APIs für die Produkte, in denen Sie in Ihrem Google Cloud-Projekt suchen möchten:

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

  • Google Workspace MCP API

CLI

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 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, prüfen Sie, ob Sie die erforderlichen Bereiche für den MCP-Server für die universelle Suche hinzugefügt haben.

Wenn Sie sich mit dem MCP-Server für die universelle Suche 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.

Beispiel: Sie authentifizieren sich mit allen folgenden Bereichen:

  • 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 MCP-Server für die universelle Suche 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), gibt die universelle Suche nur Ergebnisse aus Google Drive, Google Kalender und Google Chat zurück. Ihre E-Mails werden nicht durchsucht und es werden keine Gmail-Ergebnisse zurückgegeben.

  1. Rufen Sie in der Google Cloud Console Google Auth Platform > Datenzugriff 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 ausführliche Anleitung zum Einrichten des Zustimmungsbildschirms finden Sie unter Google Workspace-MCP-Server konfigurieren.

MCP-Client konfigurieren

Folgen Sie der Anleitung für Ihren Client, um den MCP-Server für die universelle Suche zu Ihrem MCP-Client hinzuzufügen.

Antigravity

Wenn Sie den MCP-Server für die universelle Suche zu Antigravity hinzufügen möchten, fügen Sie die Serverkonfiguration der Datei mcp_config.json hinzu. Diese Anleitung unterstützt Antigravity 2.0, Antigravity IDE und Antigravity CLI.

  1. Erstellen Sie eine OAuth 2.0-Client-ID und ein OAuth 2.0-Client-Secret vom Typ Webanwendung. Klicken Sie im Bereich 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/antigravity/mcp_config.json.

  3. Fügen Sie die Konfiguration workspace-universal 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: Das von Ihnen erstellte Client-Secret.

  4. Speichern Sie mcp_config.json.

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

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

      1. Öffnen Sie den Bildschirm mit den Einstellungen (z.B. klicken Sie unten links auf Einstellungen oder öffnen Sie Antigravity-Nutzereinstellungen).
      2. Rufen Sie Anpassungen auf.
      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 Antigravity CLI :

      1. Starten Sie Antigravity CLI:

        agy

      2. Öffnen Sie das interaktive MCP-Verwaltungsfeld, indem Sie Folgendes ausführen:

        /mcp

      3. Wählen Sie mit den Pfeiltasten workspace-universal aus, wechseln 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 Antigravity IDE oder GUI:Neben workspace-universal wird unter Anpassungen > Installierte MCP-Server die Schaltfläche Abmelden angezeigt.
    • Für Antigravity CLI:Öffnen Sie das Feld /mcp, um die konfigurierten MCP-Server aufzurufen. Bei verifizierten und authentifizierten Servern wird im interaktiven TUI-Feld neben dem Namen Authed angezeigt. Sie können den Server workspace-universal in der Dashboardansicht auswählen, um seinen Status zu prüfen und alle verfügbaren Tools aufzulisten.

Claude

Wenn Sie den MCP-Server für die universelle Suche zu Claude hinzufügen möchten, konfigurieren Sie einen benutzerdefinierten Connector.

  1. Erstellen Sie eine OAuth 2.0-Client-ID und ein OAuth 2.0-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-Client-Secret: Geben Sie Ihre Anmeldedaten ein.
    • Bereiche: Fügen 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 hinzu.

MCP-Server für die universelle Suche testen

Stellen Sie Ihrem MCP-Client Fragen, für die in verschiedenen Produkten gesucht werden muss:

  • "Suche in meinen E-Mails, Dokumenten und Chatnachrichten nach allem, was mit Projekt X 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 aus mehreren Produkten erhalten, ist der MCP-Server für die universelle Suche richtig 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.