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

Serwer MCP wyszukiwania uniwersalnego w Google Workspace korzysta ze standardu Model Context Protocol (MCP) , aby umożliwić agentom AI przeszukiwanie artefaktów Workspace. Ten serwer umożliwia przeszukiwanie wielu usług Google Workspace, w tym wiadomości Gmail, plików na Dysku Google, wydarzeń w Kalendarzu Google oraz pokoi i wiadomości w Google Chat, za pomocą jednego narzędzia.

Serwer MCP wyszukiwania uniwersalnego zapewnia agentom AI standardowy sposób wyszukiwania informacji na całym koncie Google Workspace bez konieczności wywoływania poszczególnych narzędzi specyficznych dla danej usługi.

Wymagania wstępne

  • Projekt Google Cloud. Aby utworzyć projekt, przeczytaj artykuł Tworzenie projektu.

  • Klient MCP, np. Google Antigravity.

  • Aby uruchomić polecenia na tej stronie, skonfiguruj gcloud CLI w jednym z tych środowisk programistycznych:

    Cloud Shell

    Aby użyć terminala online z już skonfigurowanym gcloud CLI, aktywuj Cloud Shell:

    Aktywuj Cloud Shell

    Powłoka lokalna

    Aby użyć lokalnego środowiska programistycznego, wykonaj te czynności:

    1. Zainstaluj Google Cloud CLI. Jeśli gcloud CLI został już zainstalowany, upewnij się, że masz najnowszą wersję, uruchamiając polecenie gcloud components update.
    2. Jeśli używasz zewnętrznego dostawcy tożsamości, zaloguj się w gcloud CLI za pomocą tożsamości sfederowanej. Więcej informacji znajdziesz w artykule Logowanie się w gcloud CLI za pomocą tożsamości sfederowanej.
    3. Zainicjuj gcloud CLI.

Konfigurowanie serwera MCP wyszukiwania uniwersalnego

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

Włączanie interfejsów API

Aby korzystać z serwera MCP wyszukiwania uniwersalnego, włącz w projekcie Google Cloud interfejs Google Workspace MCP API oraz interfejsy API usług, w których chcesz wyszukiwać:

  • Gmail API
  • Google Drive API
  • Google Calendar API
  • Interfejs API aplikacji Google Chat

  • 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

Zastąp PROJECT_ID identyfikatorem projektu Google Cloud.

Konsola

Włącz interfejsy API w konsoli Google Cloud:

Włączanie API

Serwer MCP wyszukiwania uniwersalnego używa protokołu OAuth 2.0 do uwierzytelniania i autoryzacji. Zanim utworzysz identyfikator klienta OAuth, musisz skonfigurować ekran akceptacji OAuth.

Jeśli ekran akceptacji OAuth został już skonfigurowany na potrzeby innych serwerów MCP, upewnij się, że masz dodane 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 respektuje 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 przeszukiwać Gmaila, Dysk Google, Kalendarz Google i Google Chat.

Jeśli jednak przyznasz dostęp tylko do zakresów https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly i https://www.googleapis.com/auth/chat.messages.readonly (i pominiesz https://www.googleapis.com/auth/gmail.readonly), wyszukiwanie uniwersalne będzie zwracać tylko wyniki z Dysku Google, Kalendarza Google i Google Chat. Nie będzie przeszukiwać Twojej poczty e-mail ani zwracać wyników z Gmaila.

  1. W konsoli Google Cloud otwórz Google Auth Platform > Data Access (Dostęp do danych).
  2. Kliknij Add or Remove Scopes (Dodaj lub usuń zakresy).

  3. Dodaj co najmniej 1 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 Update (Aktualizuj), a potem Save (Zapisz).

Szczegółowe instrukcje konfigurowania ekranu akceptacji 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 wyszukiwania uniwersalnego 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 i tajny klucz klienta OAuth 2.0 typu Aplikacja internetowa. W sekcji Authorized redirect URIs (Autoryzowane identyfikatory URI przekierowania) kliknij + Add URI (\+ Dodaj URI), a następnie dodaj https://antigravity.google/oauth-callback w polu URIs (Identyfikatory URI). Odpowiednie instrukcje znajdziesz w artykule Konfigurowanie serwerów MCP Google Workspace.

  2. Otwórz lub utwórz plik konfiguracji ~/.gemini/antigravity/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 następujące elementy:

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

  4. Zapisz mcp_config.json.

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

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

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

    • W przypadku Antigravity CLI:

      1. Uruchom Antigravity CLI:

        agy

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

        /mcp

      3. Użyj klawiszy strzałek, aby wybrać workspace-universal, przejdź do działania Authenticate (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 działa:

    • W przypadku Antigravity IDE lub GUI: obok workspace-universal w sekcji Customizations (Dostosowania) > Installed MCP Servers (Zainstalowane serwery MCP) wyświetla się przycisk Sign out (Wyloguj się).
    • W przypadku Antigravity CLI: otwórz panel /mcp, aby wyświetlić skonfigurowane serwery MCP. Zweryfikowane i uwierzytelnione serwery wyświetlają Authed (Uwierzytelnione) obok swoich nazw w interaktywnym panelu TUI. Aby sprawdzić stan serwera workspace-universal i wyświetlić listę wszystkich dostępnych narzędzi, możesz wybrać go w widoku panelu.

Claude

Aby dodać serwer MCP wyszukiwania uniwersalnego do Claude, skonfiguruj niestandardowy łącznik.

  1. Utwórz identyfikator i tajny klucz klienta OAuth 2.0 typu Aplikacja internetowa. Odpowiednie instrukcje znajdziesz w artykule Konfigurowanie serwerów MCP Google Workspace.

  2. W ustawieniach Claude dodaj niestandardowy łącznik:

    • Server name (Nazwa serwera): Universal Search MCP Server
    • Remote MCP server URL (URL zdalnego serwera MCP): https://workspacemcp.googleapis.com/mcp/v1
    • OAuth client ID (Identyfikator klienta OAuth) i OAuth client secret (Tajny klucz klienta OAuth): wpisz swoje dane logowania.
    • Scopes (Zakresy): dodaj 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ą przeszukania różnych usług:

  • „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 oraz wiadomości na czacie na ten temat?”

Jeśli narzędzia działają prawidłowo i otrzymujesz odpowiednie odpowiedzi z różnych usług, serwer MCP wyszukiwania uniwersalnego jest prawidłowo skonfigurowany.

Obsługiwane narzędzia

Serwer MCP wyszukiwania uniwersalnego oferuje to narzędzie:

  • search_corpus: przeszukuje wiele usług Google Workspace (Dysk Google, Gmail, Kalendarz Google i Google Chat) na podstawie podanego zapytania.