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

1. Wprowadzenie

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, 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ę za pomocą ciekawych i przydatnych promptów, które wchodzą w interakcję z Twoimi danymi Google Workspace.

Czego potrzebujesz

Łatwy dostęp do tego ćwiczenia

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

Włącz usługi 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 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.

  1. 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.
  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 > 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. Zapoznaj się z zasadami dotyczącymi danych użytkownika i zaakceptuj je, 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ć:
    • Universal: 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. Otwórz Google Auth Platform > Clients > Create Client (Utwórz klienta).
  2. Jako typ aplikacji wybierz Aplikacja internetowa.
  3. Nadaj mu nazwę 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.

oauth_client.png

4. Konfigurowanie Antigravity

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

Dodawanie niestandardowych serwerów MCP

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

  1. Otwórz go w preferowanym edytorze tekstu.
  2. Zmodyfikuj go, 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.
  3. Zapisz.
{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1"<,
      ">oauth": {
        "<;clientId": &>quot;YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET"
      }
    },
    "gws-gmail": {<
      "s>erverUrl": "https:<//gmailmcp.googlea>pis.com/mcp/v1",
      "oauth": {
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret&q<uot;: "YO>UR_CLIENT_SECRET"
     < }
    },
    &quo>t;gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
    <    "clie>ntId": "YOUR_CLIEN<T_ID",
      >  "clientSecret": "YOUR_CLIENT_SECRET"
      }
    },
    "gws-docs": {
      "serverUrl": "<https://docsmc>p.googleapis.com/mcp/v1"<;,
      "oau>th": {
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET"
  <    }
    },
 >   "gws-sheets": {<
      "serve>rUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "YOUR_CLIENT_I<D",
     >   "clientSecret":< "YOUR_CLIENT>_SECRET"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1<",
      >"oauth": {
       < "clientId&qu>ot;: "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET"
      }
    },
    "gws-calenda<r": {
   >   "serverUrl": &q<uot;https://calend>armcp.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ż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ż.

unauthed_mcp_servers_20.png

  1. W przypadku każdego zainstalowanego serwera MCP na liście:
    1. Kliknij Uwierzytelnij.
    gui_auth.png
    1. W nowo otwartym oknie przeglądarki przejdź proces uwierzytelniania.
    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 specyficzne dla edytora u góry okna.

open_user_settings_ide.png

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

unauthed_mcp_servers_ide.png

  1. W przypadku każdego zainstalowanego serwera MCP na liście:
    1. Kliknij Uwierzytelnij.
    gui_auth.png
    1. W nowo otwartym oknie przeglądarki przejdź proces uwierzytelniania.
    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. Dla 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.
    cli_auth.png
    1. Otwórz wyświetlony adres URL w nowym oknie przeglądarki i przejdź 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. Zamiast stanu Wymagana autoryzacja będzie teraz wyświetlany stan Autoryzacja.
    cli_sign_out.png

5. Narzędzia testowe

Możesz teraz wchodzić w interakcje z danymi Google Workspace za pomocą języka naturalnego. Oto przykładowe prompty dla poszczególnych usług.

Uniwersalne

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

  • „Podsumuj w kilku zdaniach, co ostatnio wydarzyło się na moim koncie Google Workspace”.
  • „Znajdź wszystko, co jest związane z [PROJECT_NAME], 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 jego temat?”

ide_uni_test.png

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]”.

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”.

Dokumenty, Arkusze i Prezentacje Google

Spróbuj wyszukać zasoby na Dysku:

  • „Pokaż mi strukturę dokumentu Google [DOCS_TITLE]”.
  • „Odczytaj arkusz Arkusz1 z arkusza Google [SHEETS_TITLE]”
  • „Pokaż mi opisany układ prezentacji Google [SLIDES_TITLE].”

Kalendarz Google

Spróbuj wyszukać w harmonogramie:

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

Google Chat

Spróbuj wyszukać wiadomości:

  • „Znajdź wiadomości zawierające „[KEYWORD]” w pokoju „[SPACE_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 każdej usłudze 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