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

Wersja przedpremierowa dla programistów: dostępna w ramach programu wersji przedpremierowej Google Workspace dla programistów, który zapewnia wcześniejszy dostęp do niektórych funkcji.

Serwer MCP wyszukiwarki uniwersalnej w Google Workspace korzysta ze 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 Gmail, plikach na Dysku Google, wydarzeniach w Kalendarzu Google oraz w przestrzeniach i wiadomościach 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 danego produktu.

Wymagania wstępne

• Uczestnictwo w programie wersji przedpremierowej Google Workspace dla programistów.

• Projekt Google Cloud. Informacje o tworzeniu projektu znajdziesz w artykule 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 interfejs gcloud CLI został już zainstalowany, upewnij się, że masz najnowszą wersję, uruchamiając polecenie gcloud components update.
  2. Jeśli korzystasz z zewnętrznego dostawcy tożsamości, zaloguj się w interfejsie wiersza poleceń gcloud za pomocą tożsamości sfederowanej. Więcej informacji znajdziesz w artykule Logowanie się w gcloud CLI przy użyciu tożsamości sfederowanej.
  3. Zainicjuj gcloud CLI.

Konfigurowanie serwera MCP wyszukiwania uniwersalnego

Aby korzystać z serwera MCP wyszukiwania uniwersalnego, musisz włączyć go 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 wyszukiwarki uniwersalnej, 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

Interfejs wiersza poleceń

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 interfejsów API

Konfigurowanie ekranu zgody OAuth

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, sprawdź, czy dodano wymagane zakresy dla serwera MCP wyszukiwania uniwersalnego.

Podczas uwierzytelniania na serwerze MCP wyszukiwarki uniwersalnej możesz uwierzytelnić wszystkie zakresy lub tylko ich podzbiór. Serwer uwzględnia te wybory i wyszukuje tylko w usługach, do których przyznano dostęp.

Na przykład jeśli uwierzytelnianie odbywa się w ramach 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 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 przeszukuje ona Twojej poczty e-mail ani nie zwraca wyników z Gmaila.

1. W konsoli Google Cloud otwórz 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 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 klienta OAuth 2.0 i tajny klucz 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. 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 przez Ciebie tajny klucz klienta.

4. Zaoszczędź mcp_config.json.

5. Uwierzytelnij serwer MCP. Uwierzytelnianie możesz przeprowadzić 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 Ustawienia w lewym dolnym rogu lub otwórz Ustawienia użytkownika Antigravity).
     2. Kliknij Dostosowywanie.
     3. W sekcji Zainstalowane serwery MCP kliknij Odśwież.
     4. Na liście znajdź workspace-universal, kliknij Uwierzytelnij, zaloguj się na konto Google, skopiuj kod autoryzacji, wklej go w oknie wprowadzania i kliknij 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. Za pomocą klawiszy strzałek wybierz 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ń w terminalu 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 Dostosowywanie > Zainstalowane serwery MCP wyświetla się przycisk Wyloguj się.
   • W przypadku interfejsu 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. W widoku panelu możesz wybrać serwer workspace-universal, aby sprawdzić jego stan i wyświetlić listę wszystkich dostępnych narzędzi.

Claude

Aby dodać serwer MCP wyszukiwarki uniwersalnej do Claude, skonfiguruj niestandardowe złącze.

1. Utwórz identyfikator klienta OAuth 2.0 i tajny klucz typu Aplikacja internetowa. 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
   • Adres URL zdalnego serwera MCP: https://workspacemcp.googleapis.com/mcp/v1
   • Identyfikator klienta OAuth i tajny klucz klienta OAuth: wpisz swoje dane logowania.
   • Zakresy: obejmują 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

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

• „Znajdź wszystko, co jest związane z projektem X, w mojej poczcie e-mail, 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 jego temat?”

Jeśli narzędzia zostaną uruchomione i otrzymasz odpowiednie odpowiedzi z wielu usług, oznacza to, że serwer MCP wyszukiwania uniwersalnego jest prawidłowo skonfigurowany.

Obsługiwane narzędzia

Serwer MCP wyszukiwarki uniwersalnej 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.