Pierwsze kroki z Google Workspace MCP i interfejsem wiersza poleceń Gemini

1. Wprowadzenie

Z tego ćwiczenia dowiesz się, jak używać protokołu Model Context Protocol (MCP) do łączenia interfejsu wiersza poleceń Gemini z danymi Google Workspace. MCP to otwarty standard, który umożliwia modelom AI bezpieczne korzystanie z narzędzi udostępnianych przez serwery zdalne. Interfejs wiersza poleceń Gemini będzie Twoim klientem do interakcji 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 interfejs wiersza poleceń Gemini, aby korzystać z 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
• Interfejs wiersza poleceń Gemini zainstalowany na komputerze lokalnym

Ukończenie tego laboratorium kodu zajmie około 30 minut.

Ł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 funkcje interaktywne, klikając 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 na komputery.

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 na komputery.
3. Nazwij go Gemini CLI.
4. Kliknij Utwórz i skopiuj identyfikator klienta oraz tajny klucz klienta. Będą one potrzebne w następnym kroku.

4. Konfigurowanie interfejsu wiersza poleceń Gemini

Teraz skonfigurujmy interfejs wiersza poleceń Gemini, aby korzystał z tych punktów końcowych. Jeśli nie masz zainstalowanego interfejsu wiersza poleceń Gemini, postępuj zgodnie z instrukcjami instalacji na stronie interfejsu wiersza poleceń Gemini.

Wymagane środowisko lokalne: nie używaj Cloud Shell w tym kroku. Interfejs wiersza poleceń Gemini wymaga lokalnej przeglądarki do uwierzytelniania OAuth. Użyj terminala na komputerze lokalnym. Więcej informacji znajdziesz w wymaganiach dotyczących przekierowań w przeglądarce.

Tworzenie pliku konfiguracji

Otwórz lub utwórz plik ~/.gemini/settings.json w katalogu domowym i dodaj tę konfigurację. Zastąp obiekty zastępcze danymi logowania OAuth.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. Uwierzytelnianie i weryfikowanie serwerów MCP

Zanim zaczniesz korzystać z serwerów MCP, musisz uwierzytelnić połączenie i sprawdzić, czy są połączone.

Uruchamianie interfejsu wiersza poleceń Gemini

Aby uruchomić interfejs wiersza poleceń Gemini, w terminalu wykonaj to polecenie:

gemini

Uwierzytelnij

Uwierzytelnij usługi, które chcesz przetestować, uruchamiając odpowiednie polecenie w interfejsie wiersza poleceń Gemini. Musisz uwierzytelnić się tylko w usługach, z których zamierzasz korzystać w tym ćwiczeniu.

Kalendarz

/mcp auth calendar

Czat

/mcp auth chat

Dysk

/mcp auth drive

Gmail

/mcp auth gmail

Osoby

/mcp auth people

Postępuj zgodnie z instrukcjami w przeglądarce, aby autoryzować każdą usługę.

Weryfikowanie połączenia

Sprawdź, czy narzędzia są załadowane i gotowe:

/mcp list

Powinny pojawić się dane wyjściowe wskazujące, że usługi są Ready, a ich narzędzia są wymienione.

6. Testowanie serwerów MCP

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

Zapytaj Gemini o swój harmonogram:

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

Google Chat

Poproś Gemini o wyszukanie wiadomości:

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

Dysk Google

Poproś Gemini o znalezienie lub odczytanie plików:

• „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

Poproś Gemini o wyszukanie e-maili lub zarządzanie nimi:

• „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

Zapytaj Gemini o 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ę, gdy Gemini koordynuje zadania 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.

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

8. Gratulacje

Gratulacje! Udało Ci się skonfigurować i przetestować oficjalne serwery MCP Google Workspace za pomocą interfejsu wiersza poleceń Gemini.

Czego się dowiedziałeś(-aś)

• Jak włączyć usługi MCP Google Workspace w Google Cloud.
• Jak skonfigurować klienta OAuth na potrzeby MCP.
• Jak używać interfejsu wiersza poleceń Gemini do interakcji z danymi Google Workspace za pomocą standardowych narzędzi.

Dokumentacja

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