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 Antigravity CLI. 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, Dokumentami Google, Arkuszami Google, Prezentacjami Google, Kalendarzem Google, Google Chat i People API bez pisania kodu.

Jakie zadania wykonasz

• Włączysz usługi Google Workspace MCP w projekcie Google Cloud.
• Skonfigurujesz Antigravity tak, aby miała dostęp do tych usług MCP.
• Przetestujesz 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 zarejestrowany w programie Google Workspace Developer Preview Program.
• 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

Google Workspace Developer Preview Program: dostęp do serwerów Google Workspace MCP jest częścią programu Public Developer Preview Program. 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.

Utwórz lub wybierz projekt 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.

Włącz API

Włączanie usług MCP

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

Włącz usługi MCP

Konfigurowanie aplikacji Google Chat

Aby korzystać z serwera MCP Google Chat, musisz skonfigurować aplikację 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ę Google 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 i autoryzacji. Musisz skonfigurować ekran zgody OAuth i utworzyć klienta aplikacji internetowej.

Konfigurowanie ekranu zgody OAuth

Najpierw musisz skonfigurować ekran zgody.

1. W konsoli Google Cloud otwórz Google Auth Platform > Elementy marki. Jeśli nie jest skonfigurowany, 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ętrzni (lub Zewnętrzni, jeśli opcja Wewnętrzni 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ętrzni, 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ć:
   • 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 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. Nadaj mu nazwę 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ń korzystają z centralnej konfiguracji MCP w pliku ~/.gemini/config/mcp_config.json.

1. Otwórz go w preferowanym edytorze tekstu.

   Uwaga: jeśli masz zainstalowany Antigravity IDE, możesz otworzyć plik bezpośrednio z niego, 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 surowej.
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.
3. Zapisz go.

{
  "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 skonfigurowane serwery MCP 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 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 na liście:
   1. Kliknij Uwierzytelnij.
   
   2. Wykonaj proces uwierzytelniania w nowym oknie przeglądarki.
   3. Gdy skończysz, kliknij Kopiuj do schowka.
   
   4. Wklej kod autoryzacji, który właśnie skopiowano, w polu tekstowym wyświetlanym w ustawieniach Antigravity 2.0 i kliknij Prześlij.
   
   5. Zamiast Uwierzytelnij pojawi 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 na liście:
   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 pojawi 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ą 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 Antigravity CLI i naciśnij Enter.
   
   6. Zamiast Wymagane uwierzytelnienie pojawi 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.

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 oraz wiadomości na czacie na ten temat?”

Gmail

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

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

Dysk Google

Spróbuj wyszukać lub odczytać pliki:

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

Dokumenty, Arkusze i Prezentacje Google

Spróbuj wyszukać zasoby na Dysku:

• „Pokaż mi strukturę dokumentu Google [DOCS_TITLE]”.
• „Przeczytaj arkusz Arkusz1 z Arkusza Google [SHEETS_TITLE]”
• „Pokaż mi opisany układ Prezentacji Google [SLIDES_TITLE]”.

Kalendarz Google

Spróbuj wyszukać w harmonogramie:

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

Google Chat

Spróbuj wyszukać wiadomości:

• „Wyszukaj w pokoju „[SPACE_NAME]” wiadomości zawierające „[KEYWORD]””.

People API

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

• „Jak mam na imię według mojego profilu Google?”
• „Znajdź informacje kontaktowe dla „[NAME]””.

Łą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 międzyusługowe:

• „Wyszukaj na Dysku pliki związane z „aktualizacjami kamieni milowych [PROJECT_NAME]”, podsumuj ich zawartość, znajdź adres e-mail „[NAME]” i utwórz roboczą wersję 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, Google 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