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 nową wersję, 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 wchodzić w interakcje z Gmailem, Dyskiem Google, Kalendarzem Google, Google Chat i interfejsem People API bez pisania kodu.

Jakie zadania wykonasz

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

Czego potrzebujesz

• przeglądarka, np. Chrome;
• Projekt Google Cloud zarejestrowany w Programie Google Workspace w wersji przedpremierowej dla deweloperów.
• Konto Google Workspace
• Antigravity 2.0, IDE lub interfejs wiersza poleceń zainstalowany na komputerze lokalnym. Więcej informacji i wskazówki dotyczące instalacji znajdziesz na oficjalnej stronie.

Łatwy dostęp do tego ćwiczenia

2. Zanim zaczniesz

Program testów Google Workspace dla deweloperów: dostęp do serwerów MCP Google Workspace jest częścią programu testów publicznych dla deweloperów. Jeśli jeszcze tego nie zrobiono, zarejestruj się i upewnij się, że Twoje konto zostało zaakceptowane w programie pod adresem 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 MCP Google Workspace, 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 Google 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.
• Interfejs 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 produktów.

Włącz usługi MCP

Konfigurowanie aplikacji do obsługi czatu

Aby korzystać z serwera MCP Google Chat, musisz skonfigurować aplikację do obsługi Google Chat w projekcie Google Cloud.

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ę Google Chat:
   • W polu Nazwa aplikacji wpisz Chat MCP.
   • W polu Avatar URL (Adres URL awatara) wpisz https://developers.google.com/chat/images/quickstart-app-avatar.png.
   • W polu Opis wpisz Chat MCP server.
   • W sekcji Funkcjonalność wyłącz opcję 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 MCP Google Workspace 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 MCP Google Workspace używają protokołu OAuth 2.0 do uwierzytelniania. Najpierw musisz skonfigurować ekran zgody.

1. W konsoli Google Cloud otwórz Google Auth Platform > Branding. Jeśli nie masz skonfigurowanej tej funkcji, 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. Przeczytaj i zaakceptuj zasady dotyczące danych użytkownika, a potem kliknij Utwórz.
6. Jeśli wybierzesz opcję Zewnętrzni, kliknij Odbiorcy i dodaj swój adres e-mail w sekcji Użytkownicy testowi.
7. Kliknij Dostęp do danych > Dodaj lub usuń zakresy. W sekcji Ręczne dodawanie zakresów dodaj te informacje o serwerach, 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 kolejno Dodaj do tabeli, Aktualizuj i Zapisz.

Tworzenie identyfikatora klienta OAuth

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

4. Konfigurowanie Antigravity

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

Dodawanie niestandardowych serwerów MCP

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

1. Otwórz go w preferowanym edytorze tekstu.

   Uwaga: jeśli masz zainstalowane środowisko Antigravity IDE, możesz uzyskać dostęp do pliku bezpośrednio z niego, wykonując te czynności:

   1. Otwórz Serwery MCP, klikając menu … u góry panelu agenta edytora.
   2. Kliknij Zarządzaj serwerami MCP, a potem Wyświetl konfigurację w formacie nieprzetworzonym.
2. Zmodyfikuj ją, aby uzyskać tę niestandardową konfigurację 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.

Uwierzytelnianie niestandardowych serwerów MCP

W Antigravity powinny być widoczne wszystkie skonfigurowane serwery MCP: gws-calendar, gws-chat, gws-drive, gws-gmail i gws-people. Musisz uwierzytelnić każde z nich na każdej platformie Antigravity, ponieważ tokeny OAuth nie są scentralizowane.

Antigravity 2.0

1. W lewym dolnym rogu kliknij Ustawienia.
2. Kliknij Dostosowywanie.
3. W sekcji Zainstalowane serwery MCP kliknij Odśwież.

4. W przypadku każdego zainstalowanego serwera MCP na liście:
   1. Kliknij Uwierzytelnij.
   
   2. Przeprowadź proces uwierzytelniania w nowym oknie przeglądarki, które się otworzy.
   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 przycisku Uwierzytelnij wyświetla się teraz przycisk Wyloguj się.
   

Antigravity IDE

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

2. Kliknij Dostosowywanie.
3. W sekcji Zainstalowane serwery MCP kliknij Odśwież.

4. W przypadku każdego zainstalowanego serwera MCP na liście:
   1. Kliknij Uwierzytelnij.
   
   2. Przeprowadź proces uwierzytelniania w nowym oknie przeglądarki, które się otworzy.
   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 przycisku Uwierzytelnij wyświetla się teraz przycisk Wyloguj się.
   

Antigravity CLI

1. Wpisz /mcp i naciśnij Enter.

2. W przypadku każdego serwera MCP na liście:
   1. Wybierz go za pomocą 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 wyświetlony adres URL w nowym oknie przeglądarki i przejdź proces uwierzytelniania.
   
   4. Gdy skończysz, kliknij Kopiuj do schowka.
   
   5. Wklej skopiowany kod autoryzacji w polu tekstowym wyświetlonym w terminalu z uruchomionym interfejsem Antigravity CLI i naciśnij Enter.
   
   6. Zamiast stanu Wymagana autoryzacja wyświetla się teraz stan Autoryzacja.
   

5. Narzędzia testowe

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

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

Kalendarz Google

Spróbuj wyszukać w harmonogramie:

• „Jakie spotkania mam zaplanowane 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:

• „Znajdź wiadomości zawierające „[KEYWORD]” w pokoju „[SPACE_NAME]”

Dysk Google

Spróbuj wyszukać lub odczytać pliki:

• „Wyszukaj na moim Dysku Google pliki, które zawierają słowo „[SŁOWO KLUCZOWE]”.
• „Wyświetl listę ostatnio edytowanych dokumentów”.
• „Przeczytaj zawartość dokumentu „[FILE_NAME]” i streść główne cele”.

Gmail

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

• „Podsumuj 5 ostatnich e-maili, które do mnie przyszły”.
• „Napisz e-maila do „[EMAIL_ADDRESS]” z prośbą o informacje o stanie projektu „[PROJECT_NAME]”.

People API

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

• „Jak mam na imię według mojego profilu Google?”
• „Znajdź informacje kontaktowe do [IMIĘ I NAZWISKO]”.

Łączenie wielu usług

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

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

Poznaj więcej narzędzi

To tylko kilka przykładów tego, co możesz zrobić. Pełną listę narzędzi dostępnych w poszczególnych usługach znajdziesz w sekcji Obsługiwane usługi w oficjalnej dokumentacji.

6. Czyszczenie danych

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 Interfejsy API i usługi.
2. Kliknij każdy włączony interfejs API Google Workspace i MCP (np. Calendar MCP, Chat MCP) i kliknij Wyłącz interfejs API.

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

7. Gratulacje

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

Dokumentacja

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