Umożliwianie agentom AI wyszukiwania w Workspace za pomocą serwera Universal Search MCP dla Workspace

Serwer MCP Universal Search dla Google Workspace używa standardu Model Context Protocol (MCP), aby umożliwić agentom AI przeszukiwanie artefaktów Workspace. Ten serwer umożliwia wyszukiwanie w wielu usługach Google Workspace, w tym w wiadomościach Gmaila, plikach na Dysku Google, wydarzeniach w Kalendarzu Google oraz pokojach i wiadomościach w Google Chat, za pomocą jednego narzędzia.

Serwer MCP wyszukiwania uniwersalnego zapewnia agentom AI ustandaryzowany sposób wyszukiwania informacji na całym koncie Google Workspace bez konieczności wywoływania poszczególnych narzędzi powiązanych z konkretnymi usługami.

Wymagania wstępne

Konfigurowanie serwera MCP wyszukiwarki uniwersalnej

Aby korzystać z serwera MCP wyszukiwania uniwersalnego, musisz go włączyć w projekcie w chmurze Google, a następnie skonfigurować klienta MCP, aby się z nim łączył.

Włączanie interfejsów API

Aby używać serwera MCP wyszukiwarki uniwersalnej, włącz interfejs Google Workspace MCP API w projekcie Google Cloud:

Interfejs wiersza poleceń

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

Zastąp PROJECT_ID identyfikatorem projektu Google Cloud.

Konsola

Włącz interfejsy API w konsoli Google Cloud:

Włączanie interfejsów API

Serwer MCP wyszukiwarki uniwersalnej używa protokołu OAuth 2.0 do uwierzytelniania i autoryzacji. Zanim utworzysz identyfikator klienta OAuth, musisz skonfigurować ekran zgody OAuth.

Jeśli ekran zgody OAuth został już skonfigurowany dla innych serwerów MCP, upewnij się, że dodano wymagane zakresy dla serwera MCP wyszukiwania uniwersalnego.

Podczas uwierzytelniania na serwerze MCP wyszukiwania uniwersalnego możesz uwierzytelnić wszystkie żądane zakresy lub tylko ich podzbiór. Serwer uwzględnia te wybory i przeszukuje tylko te usługi, do których przyznano dostęp.

Jeśli na przykład uwierzytelniasz się za pomocą wszystkich tych zakresów:

  • 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

Serwer MCP wyszukiwania uniwersalnego będzie wyszukiwać w Gmailu, na Dysku Google, w Kalendarzu Google i Google Chat.

Jeśli jednak przyznasz dostęp tylko do https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly i https://www.googleapis.com/auth/chat.messages.readonly (pomijając https://www.googleapis.com/auth/gmail.readonly), wyszukiwanie uniwersalne zwróci tylko wyniki z Dysku Google, Kalendarza Google i Google Chat. Nie przeszukuje poczty e-mail ani nie zwraca wyników z Gmaila.

  1. W konsoli Google Cloud kliknij Google Auth Platform > Dostęp do danych.
  2. Kliknij Dodaj lub usuń zakresy.

  3. Dodaj co najmniej jeden z tych zakresów:

    • 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. Kliknij Aktualizuj, a następnie Zapisz.

Szczegółowe instrukcje konfigurowania ekranu zgody znajdziesz w artykule Konfigurowanie serwerów MCP Google Workspace.

Konfigurowanie klienta MCP

Aby dodać serwer MCP wyszukiwania uniwersalnego do klienta MCP, postępuj zgodnie z instrukcjami dotyczącymi klienta.

Antigravity

Aby dodać serwer MCP wyszukiwarki uniwersalnej do Antigravity, dodaj konfigurację serwera do pliku mcp_config.json. Te instrukcje dotyczą Antigravity 2.0, Antigravity IDE i Antigravity CLI.

  1. Utwórz identyfikator klienta OAuth 2.0 i klucz tajny typu Aplikacja internetowa. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie dodaj https://antigravity.google/oauth-callback w polu Identyfikatory URI. Wybierz Używaj tego klienta w przypadku agenta opartego na AI. Instrukcje znajdziesz w artykule Konfigurowanie serwerów MCP Google Workspace.

  2. Otwórz lub utwórz plik konfiguracji ~/.gemini/config/mcp_config.json.

  3. Dodaj konfigurację workspace-universal do mcp_config.json:

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

    Zastąp te elementy:

    • OAUTH_CLIENT_ID: utworzony przez Ciebie identyfikator klienta.
    • OAUTH_CLIENT_SECRET: utworzony tajny klucz klienta.

  4. Zaoszczędź mcp_config.json.

  5. Uwierzytelnij serwer MCP. Możesz uwierzytelnić się za pomocą ustawień GUI lub interfejsu wiersza poleceń:

    • W przypadku Antigravity IDE lub GUI (Antigravity 2.0):

      1. Otwórz ekran ustawień (np. kliknij Ustawienia w lewym dolnym rogu lub otwórz Ustawienia użytkownika Antigravity).
      2. Kliknij Dostosowania.
      3. W sekcji Zainstalowane serwery MCP kliknij Odśwież.
      4. Znajdź na liście workspace-universal, kliknij Authenticate (Uwierzytelnij), zaloguj się na konto Google, skopiuj kod autoryzacji, wklej go w oknie i kliknij Submit (Prześlij).

    • W przypadku Antigravity CLI:

      1. Uruchom Antigravity CLI:

        agy

      2. Otwórz interaktywny panel zarządzania MCP, uruchamiając to polecenie:

        /mcp

      3. Użyj klawiszy strzałek, aby wybrać workspace-universal, przejdź do działania Uwierzytelnij i naciśnij Enter. Zakończ proces logowania w przeglądarce, skopiuj kod autoryzacji, wklej go w wierszu poleceń terminala i naciśnij Enter.

  6. Sprawdź, czy serwer jest prawidłowo skonfigurowany i czy działa:

    • W przypadku Antigravity IDE lub GUI: przycisk Wyloguj się jest wyświetlany obok workspace-universal w sekcji Dostosowania > Zainstalowane serwery MCP.
    • W przypadku Antigravity CLI: otwórz panel /mcp, aby wyświetlić skonfigurowane serwery MCP. Zweryfikowane i uwierzytelnione serwery mają obok nazwy w interaktywnym panelu TUI oznaczenie Authed (Uwierzytelniony). Możesz wybrać serwer workspace-universal w widoku panelu, aby sprawdzić jego stan i wyświetlić listę wszystkich dostępnych narzędzi.

Claude

Aby dodać serwer MCP wyszukiwania uniwersalnego do Claude, skonfiguruj niestandardowe oprogramowanie sprzęgające.

  1. Utwórz identyfikator klienta OAuth 2.0 i obiekt tajny typu Aplikacja internetowa, a następnie wybierz Użyj tego klienta w przypadku agenta opartego na AI. Instrukcje znajdziesz w artykule Konfigurowanie serwerów MCP Google Workspace.

  2. W ustawieniach Claude dodaj niestandardowe oprogramowanie sprzęgające:

    • Nazwa serwera: Universal Search MCP Server
    • URL zdalnego serwera MCP: https://workspacemcp.googleapis.com/mcp/v1
    • Identyfikator klienta OAuth i tajny klucz klienta OAuth: wpisz swoje dane uwierzytelniające.
    • Zakresy: uwzględnij https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly i https://www.googleapis.com/auth/chat.messages.readonly.

Testowanie serwera MCP wyszukiwania uniwersalnego

Zadaj klientowi MCP pytania, które wymagają wyszukiwania w różnych usługach:

  • „Znajdź wszystko, co jest związane z projektem X, w moich e-mailach, dokumentach i wiadomościach na czacie”.
  • „Kiedy mam następne spotkanie dotyczące planu marketingowego i jakie są najnowsze notatki i wiadomości na czacie na ten temat?”

Jeśli narzędzia zostaną wykonane prawidłowo i otrzymasz odpowiednie odpowiedzi z wielu usług, serwer MCP wyszukiwarki uniwersalnej jest prawidłowo skonfigurowany.

Obsługiwane narzędzia

Serwer MCP wyszukiwania uniwersalnego oferuje to narzędzie:

  • search_corpus: przeprowadza wyszukiwanie w wielu usługach Google Workspace (Dysk Google, Gmail, Kalendarz Google i Google Chat) na podstawie podanego zapytania.