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

1. Wprowadzenie

Z tego ćwiczenia programistycznego 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 do interakcji z Gmailem, Dyskiem Google, Dokumentami Google, Arkuszami Google, Prezentacjami Google, Kalendarzem Google, Google Chat i interfejsem People API bez pisania kodu.

google_workspace_mcp_antigravity_arch_2.png

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ę, używając ciekawych i przydatnych promptów, które wchodzą w interakcję z danymi Google Workspace.

Czego potrzebujesz

łatwy dostęp do tych ćwiczeń,

qr_code.png

2. Zanim zaczniesz

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 API Google Workspace.

Włączanie usług MCP

Następnie włącz usługi MCP Google Workspace.

Konfigurowanie aplikacji do obsługi czatu

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

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

  1. Skonfiguruj aplikację Google Chat:
    • W polu Nazwa aplikacji wpisz Chat MCP.
    • W polu Avatar URL (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 opcję Włącz funkcje interaktywne.
    • W sekcji Logi wybierz Loguj błędy w usłudze Logging.
  2. Kliknij Zapisz.

chat_app.png

3. Konfigurowanie zgody i klienta OAuth

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

Najpierw musisz skonfigurować ekran zgody.

  1. W konsoli Google Cloud otwórz Google Auth Platform > Marka. 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, przejdź do sekcji 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 zakresy dla serwerów, których chcesz używać:
    • Uniwersalne: 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
    • Gmail https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
    • Dysk Google: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
    • Dokumenty Google: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/documents.readonly, https://www.googleapis.com/auth/documents
    • Arkusze Google: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/spreadsheets.readonly, https://www.googleapis.com/auth/spreadsheets
    • Prezentacje Google: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/presentations.readonly, https://www.googleapis.com/auth/presentations
    • 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.messages.create, https://www.googleapis.com/auth/chat.users.readstate.readonly
    • 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.

oauth_consent_screen_1.pngoauth_consent_screen_2.pngoauth_consent_screen_3.png

Tworzenie identyfikatora klienta OAuth

  1. Kliknij Google Auth Platform (Platforma uwierzytelniania Google) > Clients (Klienci) > 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 URI, a następnie wpisz https://antigravity.google/oauth-callback.
  5. Wybierz Używaj tego klienta w przypadku agenta opartego na AI.
  6. Kliknij Utwórz i skopiuj Identyfikator klienta oraz Tajny klucz klienta. Będą Ci potrzebne w następnym kroku.

oauth_client.png

4. Konfigurowanie Antigravity

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

Dodawanie niestandardowych serwerów MCP

Antigravity 2.0, IDE i interfejs wiersza poleceń korzystają z centralnej konfiguracji MCP w pliku ~/.gemini/config/mcp_config.json.

  1. Otwórz go w preferowanym edytorze tekstu.
  2. Zmodyfikuj konfigurację niestandardowego serwera MCP. Zanim to zrobisz, zastąp obiekty zastępcze <YOUR_CLIENT_ID> i <YOUR_CLIENT_SECRET> identyfikatorem i tajnym kluczem klienta OAuth utworzonymi w poprzednich krokach.
  3. Zapisz.
{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.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-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

Uwierzytelnianie niestandardowych serwerów MCP

Powinny być widoczne wszystkie serwery MCP skonfigurowane jako zainstalowane w Antigravity: gws-universal, gws-gmail, gws-drive, gws-docs, gws-sheets, gws-slides, gws-calendar, gws-chat i gws-people. Musisz uwierzytelnić każdy 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 Dostosowania.
  3. W sekcji Zainstalowane serwery MCP kliknij Odśwież.

unauthed_mcp_servers_20.png

  1. W przypadku każdego zainstalowanego serwera MCP:
    1. Kliknij Uwierzytelnij.
    gui_auth.png
    1. Przejdź przez proces uwierzytelniania w nowym oknie przeglądarki, które się otworzy.
    2. Gdy skończysz, kliknij Kopiuj do schowka.
    copy_auth_code.png
    1. Wklej skopiowany kod autoryzacji w polu tekstowym wyświetlanym w ustawieniach Antigravity 2.0 i kliknij Prześlij.
    gui_paste_auth_code.png
    1. Zamiast przycisku Uwierzytelnij wyświetla się teraz przycisk Wyloguj się.
    gui_sign_out.png

Antigravity IDE

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

open_user_settings_ide.png

  1. Kliknij Dostosowania.
  2. W sekcji Zainstalowane serwery MCP kliknij Odśwież.

unauthed_mcp_servers_ide.png

  1. W przypadku każdego zainstalowanego serwera MCP:
    1. Kliknij Uwierzytelnij.
    gui_auth.png
    1. Przejdź przez proces uwierzytelniania w nowym oknie przeglądarki, które się otworzy.
    2. Gdy skończysz, kliknij Kopiuj do schowka.
    copy_auth_code.png
    1. Wklej skopiowany kod autoryzacji w polu tekstowym wyświetlanym w ustawieniach Antigravity IDE i kliknij Prześlij.
    gui_paste_auth_code.png
    1. Zamiast przycisku Uwierzytelnij wyświetla się teraz przycisk Wyloguj się.
    gui_sign_out.png

Antigravity CLI

  1. Wpisz /mcp i naciśnij Enter.

unauthed_mcp_servers_cli.png

  1. W przypadku każdego serwera MCP na liście:
    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.
    cli_auth.png
    1. Otwórz wyświetlony adres URL w nowym oknie przeglądarki i przejdź przez proces uwierzytelniania.
    cli_auth_url.png
    1. Gdy skończysz, kliknij Kopiuj do schowka.
    copy_auth_code.png
    1. Wklej skopiowany kod autoryzacji w polu tekstowym wyświetlanym w terminalu z uruchomionym interfejsem wiersza poleceń Antigravity i naciśnij Enter.
    cli_paste_auth_code.png
    1. Stan Wymagana autoryzacja zostanie zastąpiony stanem Autoryzowano.
    cli_sign_out.png

5. Narzędzia do testowania

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.

Uniwersalne

Spróbuj wyszukać w różnych usługach:

  • „Streść w kilku zdaniach, co ostatnio działo się na moim koncie Google Workspace”.
  • „Znajdź wszystko, co jest związane z [NAZWA_PROJEKTU] 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?”

ide_uni_test.png

Gmail

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

  • „Podsumuj 5 ostatnich e-maili”.
  • „Napisz e-maila do ‘[EMAIL_ADDRESS]' z prośbą o informacje o projekcie ‘[PROJECT_NAME]'”.

Dysk Google

Spróbuj wyszukać lub odczytać pliki:

  • „Wyszukaj na Dysku Google pliki zawierające słowo kluczowe [SŁOWO KLUCZOWE]”.
  • „Pokaż listę ostatnio edytowanych przeze mnie dokumentów”.
  • „Przeczytaj treść dokumentu [NAZWA_PLIKU] i streść główne cele”.

Dokumenty, Arkusze i Prezentacje Google

Spróbuj wyszukać zasoby na Dysku:

  • „Pokaż mi zawartość strukturalną dokumentu Google [DOCS_TITLE]”.
  • „Przeczytaj arkusz Arkusz1 z Arkusza Google [SHEETS_TITLE]”
  • „Pokaż mi układ słowny prezentacji Google [SLIDES_TITLE]”.

Kalendarz Google

Spróbuj wyszukać harmonogram:

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

Google Chat

Spróbuj wyszukać wiadomości:

  • „Znajdź wiadomości zawierające „[SŁOWO KLUCZOWE]” w pokoju „[NAZWA POKOJU]””

People API

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

  • „Jak się nazywam według mojego profilu Google?”
  • „Znajdź informacje kontaktowe [IMIĘ]”.

Łą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 aktualizacjami kamieni milowych projektu [NAZWA_PROJEKTU], podsumuj ich treść, znajdź adres e-mail użytkownika [NAZWA_UŻYTKOWNIKA] i utwórz wersję roboczą e-maila w Gmailu z podsumowaniem”.

Odkryj więcej narzędzi

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

6. Czyszczenie danych

Aby wyczyścić projekt bez usuwania go, 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 z włączonych interfejsów API Google Workspace i MCP (np. Calendar MCP, Chat MCP), a następnie 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 MCP Google Workspace za pomocą Antigravity.

Dokumentacja referencyjna