Serwery MCP Google Workspace w Antigravity

1. Wprowadzenie

Uwaga: korzystasz z interfejsu wiersza poleceń Gemini? Zamiast tego zapoznaj się z tym ćwiczeniem. Ten przewodnik dotyczy Antigravity.

Z tego ćwiczenia dowiesz się, jak używać protokołu Model Context Protocol (MCP) do łączenia Antigravity z danymi Google Workspace. 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,
• Konto Google Workspace
• Antigravity zainstalowany na komputerze lokalnym

Łatwy dostęp do tego ćwiczenia

2. Zanim zaczniesz

Program wersji przedpremierowej dla programistów Google Workspace: dostęp do serwerów MCP Google Workspace jest częścią programu wersji przedpremierowej dla programistów. Jeśli jeszcze tego nie zrobiono, 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 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łącz usługi 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 OAuth i klienta

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, w sekcji Odbiorcy 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 (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 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ła z tych punktów końcowych. Jeśli nie masz zainstalowanej aplikacji Antigravity, postępuj zgodnie z instrukcjami instalacji na stronie internetowej Antigravity.

Dodawanie niestandardowych serwerów MCP

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

4. Zmodyfikuj nowo otwarty plik mcp_config.json, dodając do niego 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>"
      }
    }
  }
}

5. Wróć do sekcji Zarządzaj serwerami MCP, a następnie kliknij Odśwież.

Uwierzytelnianie niestandardowych serwerów MCP

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

2. Kliknij Dostosowywanie.

3. W przypadku każdego serwera wymienionego w sekcji ZAINSTALOWANE SERWERY MCP:
   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. Zamknij okno przeglądarki.
5. Wklej skopiowany kod autoryzacji w polu tekstowym wyświetlanym w ustawieniach Antigravity.
6. Kliknij Prześlij.

5. Narzędzia testowe

Możesz teraz 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 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]”

Dysk Google

Spróbuj wyszukać lub odczytać pliki:

• „Wyszukaj na moim Dysku Google pliki zawierające 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 dotyczące 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

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