Serwery MCP Google Workspace w Google Antigravity 2.0, IDE lub interfejsie wiersza poleceń

1. Wprowadzenie

Uwaga: czy nadal używasz interfejsu wiersza poleceń Gemini? Ten przewodnik dotyczy interfejsu wiersza poleceń Antigravity. Więcej informacji o tym, jak przejść na nowy interfejs, znajdziesz w tym oficjalnym poście na blogu.

Z tego ćwiczenia dowiesz się, jak używać protokołu Model Context Protocol (MCP) do łączenia danych Google Workspace z Antigravity 2.0, IDE lub interfejsem wiersza poleceń. MCP to otwarty standard, który umożliwia modelom AI bezpieczne korzystanie z narzędzi udostępnianych przez serwery zdalne. Skonfigurujesz Antigravity tak, aby mogła wchodzić w interakcje z Gmailem, Dyskiem Google, Kalendarzem Google, Google Chat i People API bez pisania kodu.

Jakie zadania wykonasz

• Włącz usługi Google Workspace MCP w projekcie Google Cloud.
• Skonfiguruj Antigravity tak, aby miała dostęp do tych usług MCP.
• Przetestuj integrację za pomocą zabawnych i przydatnych promptów , które wchodzą w interakcje z Twoimi danymi Google Workspace.

Czego potrzebujesz

• Przeglądarka internetowa, np. Chrome.
• Projekt Google Cloud.
• Konto Google Workspace.
• Antigravity 2.0, IDE lub interfejs wiersza poleceń zainstalowany na komputerze lokalnym. Więcej informacji i instrukcje instalacji znajdziesz na oficjalnej stronie.

Łatwy dostęp do tego ćwiczenia

2. Zanim zaczniesz

Program testów beta dla deweloperów Google Workspace: dostęp do serwerów Google Workspace MCP jest częścią programu testów beta dla deweloperów. Jeśli jeszcze tego nie zrobisz, zarejestruj się i upewnij się, że Twoje konto zostało zaakceptowane w programie na stronie https://developers.google.com/workspace/preview.

Tworzenie lub wybieranie projektu Google Cloud

W konsoli Google Cloud wybierz lub utwórz projekt w chmurze Google Cloud.

Włączanie interfejsów API

Aby korzystać z serwerów Google Workspace MCP, musisz włączyć standardowe interfejsy Google Workspace API. Niektóre serwery MCP działają niezależnie, ale inne nadal wymagają włączenia podstawowego standardowego interfejsu API:

• Gmail i Chat nadal wymagają standardowych interfejsów API.
• Dysk wymaga standardowego interfejsu API w przypadku niektórych narzędzi.
• Kalendarz nie wymaga włączenia standardowego interfejsu API.
• People API obsługuje zarówno dostęp standardowy, jak i funkcje MCP, więc nie ma oddzielnej usługi MCP, którą trzeba włączyć.

Włącz interfejsy API

Włączanie usług MCP

Następnie włącz dedykowane usługi MCP dla tych usług.

Włącz usługi MCP

Konfigurowanie aplikacji Chat

Aby korzystać z serwera Google Chat MCP, musisz skonfigurować aplikację do Google Chat w projekcie w chmurze Google.

1. W konsoli Google Cloud wyszukaj Google Chat API i kliknij Google Chat API > Zarządzaj > Konfiguracja.

Otwórz Google Chat API

2. Skonfiguruj aplikację Chat:
   • W polu Nazwa aplikacji wpisz Chat MCP.
   • W polu Adres URL awatara wpisz https://developers.google.com/chat/images/quickstart-app-avatar.png.
   • W polu Opis wpisz Chat MCP server.
   • W sekcji Funkcje wyłącz Włącz funkcje interaktywne.
   • W sekcji Logi wybierz Loguj błędy w usłudze Logging.
3. Kliknij Zapisz.

3. Konfigurowanie zgody i klienta OAuth

Serwery Google Workspace MCP używają protokołu OAuth 2.0 do bezpiecznego uwierzytelniania. Musisz skonfigurować ekran zgody OAuth i utworzyć klienta aplikacji internetowej.

Konfigurowanie ekranu zgody OAuth

Serwery Google Workspace MCP używają protokołu OAuth 2.0 do uwierzytelniania. Najpierw musisz skonfigurować ekran zgody.

1. W konsoli Google Cloud otwórz Google Auth Platform > Elementy marki. Jeśli nie jest skonfigurowana, kliknij Rozpocznij.
2. Skonfiguruj Informacje o aplikacji:
   • Nazwa aplikacji: Google Workspace MCP Servers
   • Adres e-mail dla użytkowników potrzebujących pomocy: wybierz swój adres e-mail.
3. Skonfiguruj Odbiorców: wybierz Wewnętrzny (lub Zewnętrzny, jeśli opcja Wewnętrzny jest niedostępna).
4. Skonfiguruj Informacje kontaktowe: wpisz swój adres e-mail.
5. Zapoznaj się z zasadami dotyczącymi danych użytkownika i zaakceptuj je, a następnie kliknij Utwórz.
6. Jeśli wybierzesz Zewnętrzny, otwórz Odbiorcy i dodaj swój adres e-mail w sekcji Użytkownicy testowi.
7. Otwórz Dostęp do danych > Dodaj lub usuń zakresy. W sekcji Ręcznie dodaj zakresy dodaj te zakresy dla serwerów, których chcesz używać:
   • Kalendarz Google: https://www.googleapis.com/auth/calendar.calendarlist.readonly, https://www.googleapis.com/auth/calendar.events.freebusy, https://www.googleapis.com/auth/calendar.events.readonly
   • Google Chat: https://www.googleapis.com/auth/chat.spaces.readonly, https://www.googleapis.com/auth/chat.memberships.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.users.readstate.readonly
   • Dysk Google: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • People API: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
8. Kliknij Dodaj do tabeli, a potem Aktualizuj i Zapisz.

Tworzenie identyfikatora klienta OAuth

1. Otwórz Google Auth Platform > Klienci > Utwórz klienta.
2. Jako typ aplikacji wybierz Aplikacja internetowa.
3. Nazwij ją Antigravity.
4. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie wpisz https://antigravity.google/oauth-callback.
5. Kliknij Utwórz i skopiuj Identyfikator klienta oraz Tajny klucz klienta. Będą Ci potrzebne w następnym kroku.

4. Konfigurowanie Antigravity

Teraz skonfigurujmy Antigravity tak, aby korzystała z tych punktów końcowych. Jeśli nie masz zainstalowanej Antigravity 2.0, IDE lub interfejsu wiersza poleceń, postępuj zgodnie z instrukcjami na stronie Antigravity.

Dodawanie niestandardowych serwerów MCP

Antigravity 2.0, IDE i interfejs wiersza poleceń mają wspólną konfigurację MCP w pliku ~/.gemini/config/mcp_config.json.

1. Otwórz go w preferowanym edytorze tekstu.

   Uwaga: jeśli masz zainstalowane Antigravity IDE, możesz otworzyć plik bezpośrednio z tego środowiska, wykonując te czynności:

   1. Otwórz Serwery MCP za pomocą menu ... u góry panelu agenta edytora.
   2. Kliknij Zarządzaj serwerami MCP , a następnie Wyświetl konfigurację w postaci nieprzetworzonej.
2. Zmodyfikuj go, korzystając z tej konfiguracji niestandardowego serwera MCP. Zanim to zrobisz, zastąp symbole zastępcze <YOUR_CLIENT_ID> i <YOUR_CLIENT_SECRET> identyfikatorem klienta OAuth i tajnym kluczem utworzonym w poprzednich krokach:

{
  "mcpServers": {
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

3. Zapisz go.

Uwierzytelnianie niestandardowych serwerów MCP

Powinny być widoczne wszystkie skonfigurowane serwery MCP zainstalowane w Antigravity: gws-calendar, gws-chat, gws-drive, gws-gmail i gws-people. Musisz uwierzytelnić każdy z nich na każdej powierzchni Antigravity, ponieważ tokeny OAuth nie są scentralizowane.

Antigravity 2.0

1. W lewym dolnym rogu kliknij Ustawienia.
2. Otwórz Dostosowania.
3. W sekcji Zainstalowane serwery MCP kliknij Odśwież.

4. W przypadku każdego zainstalowanego serwera MCP:
   1. Kliknij Uwierzytelnij.
   
   2. Wykonaj proces uwierzytelniania w nowym oknie przeglądarki.
   3. Gdy skończysz, kliknij Kopiuj do schowka.
   
   4. Wklej skopiowany kod autoryzacji w polu tekstowym wyświetlanym w ustawieniach Antigravity 2.0 i kliknij Prześlij.
   
   5. Zamiast Uwierzytelnij wyświetla się teraz przycisk Wyloguj się.
   

Antigravity IDE

1. Otwórz Ustawienia użytkownika Antigravity za pomocą menu Ustawienia specyficzne dla edytora u góry okna.

2. Otwórz Dostosowania.
3. W sekcji Zainstalowane serwery MCP kliknij Odśwież.

4. W przypadku każdego zainstalowanego serwera MCP:
   1. Kliknij Uwierzytelnij.
   
   2. Wykonaj proces uwierzytelniania w nowym oknie przeglądarki.
   3. Gdy skończysz, kliknij Kopiuj do schowka.
   
   4. Wklej skopiowany kod autoryzacji w polu tekstowym wyświetlanym w ustawieniach Antigravity IDE i kliknij Prześlij.
   
   5. Zamiast Uwierzytelnij wyświetla się teraz przycisk Wyloguj się.
   

Antigravity CLI

1. Wpisz /mcp i naciśnij Enter.

2. W przypadku każdego serwera MCP:
   1. Wybierz go za pomocą klawiszy strzałek w górę i w dół , a następnie naciśnij Enter.
   2. Wybierz Uwierzytelnij za pomocą klawiszy strzałek w lewo i w prawo , a następnie naciśnij Enter.
   
   3. Otwórz adres URL wyświetlany w nowym oknie przeglądarki i wykonaj proces uwierzytelniania.
   
   4. Gdy skończysz, kliknij Kopiuj do schowka.
   
   5. Wklej skopiowany kod autoryzacji w polu tekstowym wyświetlanym w terminalu z uruchomionym interfejsem wiersza poleceń Antigravity i naciśnij Enter.
   
   6. Zamiast Wymagane uwierzytelnienie wyświetla się teraz stan Uwierzytelniono.
   

5. Narzędzia testowe

Teraz możesz wchodzić w interakcje z danymi Google Workspace za pomocą języka naturalnego. Oto kilka przykładowych promptów dla każdej usługi.

Uwaga: symbole zastępcze w nawiasach kwadratowych w promptach poniżej (np. [NAME], [FILE_NAME]) zastąp rzeczywistymi wartościami z danych Google Workspace.

Kalendarz Google

Spróbuj wyszukać swój harmonogram:

• „Jakie mam zaplanowane spotkania w tym tygodniu?”
• „Czy jutro po południu mam wolny czas?”

Antigravity 2.0

Antigravity IDE

Antigravity CLI

Google Chat

Spróbuj wyszukać wiadomości:

• „Poszukaj wiadomości zawierających słowo kluczowe „[KEYWORD]” w pokoju „[SPACE_NAME]””

Dysk Google

Spróbuj wyszukać lub odczytać pliki:

• „Wyszukaj na Dysku Google pliki zawierające słowo kluczowe „[KEYWORD]”.”
• „Wyświetl listę ostatnio edytowanych dokumentów.”
• „Przeczytaj zawartość dokumentu „[FILE_NAME]” i podsumuj główne cele.”

Gmail

Spróbuj wyszukać e-maile lub nimi zarządzać:

• „Podsumuj 5 ostatnich e-maili, które otrzymałem(-am).”
• „Utwórz wersję roboczą e-maila do „[EMAIL_ADDRESS]” z prośbą o aktualizację projektu „[PROJECT_NAME]”.”

People API

Spróbuj wyszukać swój profil lub kontakty:

• „Jakie jest moje imię i nazwisko w profilu Google?”
• "Znajdź informacje kontaktowe osoby „[NAME]”.”

Łączenie wielu usług

Prawdziwa moc protokołu MCP ujawnia się podczas koordynowania zadań w wielu usługach. Wypróbuj te prompty, które pokazują możliwości międzyusługowe:

• „Wyszukaj na Dysku pliki związane z „aktualizacjami kamieni milowych projektu [PROJECT_NAME]”, podsumuj ich zawartość, znajdź adres e-mail osoby „[NAME]” i utwórz wersję roboczą e-maila w Gmailu z podsumowaniem.”

Poznaj więcej narzędzi

To tylko kilka przykładów tego, co możesz zrobić. Aby zobaczyć pełną listę narzędzi dostępnych w każdej usłudze i je wypróbować, zapoznaj się z sekcją Obsługiwane usługi w oficjalnej dokumentacji.

6. Zwalnianie miejsca

Aby zwolnić miejsce w projekcie bez jego usuwania, możesz wyłączyć włączone interfejsy API i usługi MCP:

1. W konsoli Google Cloud otwórz Panel interfejsów API i usług.
2. Kliknij każdy włączony interfejs Google Workspace i MCP API (np. Kalendarz MCP, Chat MCP) i kliknij Wyłącz interfejs API.

Jeśli nie planujesz już używać danych logowania klienta OAuth, usuń je w konsoli Google Auth Platform.

7. Gratulacje

Gratulacje! Udało Ci się skonfigurować i przetestować oficjalne serwery Google Workspace MCP za pomocą Antigravity.

Dokumentacja źródłowa

• Wprowadzenie do protokołu Model Context Protocol (MCP)
• Konfigurowanie serwerów Google Workspace MCP
• Konfigurowanie zgody OAuth
• Antigravity