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

Serwer MCP uniwersalnej wyszukiwarki w 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 wyszukiwania uniwersalnego

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 korzystać z 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 wyszukiwarki uniwersalnej.

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
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.memberships.readonly

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

Jeśli jednak pominiesz https://www.googleapis.com/auth/gmail.readonly i przyznasz dostęp tylko do https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.spaces.readonly i https://www.googleapis.com/auth/chat.memberships.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
    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.memberships.readonly

    Uwzględnij https://www.googleapis.com/auth/chat.spaces.readonly i https://www.googleapis.com/auth/chat.memberships.readonly, aby serwer mógł określić, kto uczestniczy w każdej rozmowie w Google Chat. Bez nich wyniki Google Chat są traktowane jako udostępnione zewnętrznie i mogą wymagać potwierdzenia przez użytkownika lub zostać odfiltrowane.

  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.

Identyfikatory klienta OAuth 2.0 delegowane przez użytkownika, które wywołują serwer MCP wyszukiwarki uniwersalnej, muszą mieć zaznaczoną opcję Używaj tego klienta w przypadku agenta opartego na AI w sekcji Platforma uwierzytelniania Google > Klienci. Aby zaktualizować istniejący identyfikator klienta OAuth 2.0, wybierz to ustawienie w sekcji Platforma uwierzytelniania Google > Klienci, zgodnie z opisem w artykule Zarządzanie klientami OAuth. Jeśli nie możesz zmienić tego ustawienia na istniejącym kliencie lub jeśli klient obsługuje też funkcje niezwiązane z agentem, utwórz nowy identyfikator klienta OAuth 2.0 dla agenta AI. Informacje o odrzuconych prośbach, kontach usługi z przekazywaniem dostępu w całej domenie i Google Apps Script znajdziesz w sekcji Rozwiązywanie problemów.

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 dialogowym i kliknij Submit (Prześlij).

    • 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. Dokoń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 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 połączenie.

  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 logowania.
    • Zakresy: uwzględnij 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, https://www.googleapis.com/auth/chat.spaces.readonly i https://www.googleapis.com/auth/chat.memberships.readonly.

Testowanie serwera MCP wyszukiwania uniwersalnego

Spróbuj zadać 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 wyszukiwania uniwersalnego jest prawidłowo skonfigurowany.

Obsługiwane narzędzia

Serwer MCP wyszukiwarki uniwersalnej oferuje to narzędzie. Schematy wejściowe i wyjściowe znajdziesz w dokumentacji MCP wyszukiwarki uniwersalnej.

  • search_corpus: wyszukuje informacje w wielu usługach Google Workspace, w tym na Dysku, w Gmailu, Kalendarzu i Google Chat, na podstawie podanego zapytania.