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

1. Wprowadzenie

Uwaga: czy nadal używasz interfejsu wiersza poleceń Gemini? Aby dowiedzieć się, jak skonfigurować serwery MCP Google Workspace za pomocą interfejsu wiersza poleceń Antigravity, zapoznaj się z tym ćwiczeniem. Więcej informacji o tym przejściu znajdziesz w tym oficjalnym poście na blogu.

Z tego ćwiczenia programistycznego 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. Będziesz używać interfejsu wiersza poleceń Gemini jako klienta 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ę, używając ciekawych i przydatnych promptów, które wchodzą w interakcję z danymi Google Workspace.

Czego potrzebujesz

• przeglądarkę internetową, np. Chrome;
• projekt Google Cloud,
• konto Google Workspace,
• interfejs wiersza poleceń Gemini zainstalowany na komputerze lokalnym,

Ukończenie tego ćwiczenia zajmie około 30 minut.

łatwy dostęp do tych ćwiczeń,

2. Zanim zaczniesz

Program wersji przedpremierowej Google Workspace dla programistów: dostęp do serwerów MCP Google Workspace jest częścią publicznego programu wersji przedpremierowej dla programistów. Jeśli jeszcze tego nie zrobiłeś(-aś), 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 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.
• People API obsługuje zarówno dostęp standardowy, jak i funkcje MCP, więc nie ma oddzielnej usługi MCP do włączenia.

Włączanie interfejsów API

Włączanie usług MCP

Następnie włącz dedykowane usługi MCP dla produktów.

Włączanie usług MCP

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. 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 Funkcje wyłącz opcję 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 MCP Google Workspace używają protokołu OAuth 2.0 do bezpiecznego uwierzytelniania. Musisz skonfigurować ekran zgody OAuth i utworzyć klienta aplikacji na komputer.

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 kliknij 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ć:
   • 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

Podczas konfigurowania klienta OAuth 2.0 dla serwerów MCP Google Workspace musisz włączyć ustawienie klasyfikacji agentowej (is_agentic), wybierając Używaj tego klienta w przypadku agenta opartego na AI. Klienci OAuth bez włączonego tego ustawienia nie mogą wywoływać punktów końcowych MCP Google Workspace.

1. Otwórz Google Auth Platform > Clients (Klienci) > Create Client (Utwórz klienta) (lub Interfejsy API i usługi > Dane logowania > Utwórz dane logowania > Identyfikator klienta OAuth).
2. Jako typ aplikacji wybierz Aplikacja komputerowa.
3. Nazwij go Gemini CLI.
4. Wybierz Używaj tego klienta w przypadku agenta opartego na AI, aby włączyć flagę klasyfikacji is_agentic na kliencie OAuth.
5. Kliknij Utwórz i skopiuj Identyfikator klienta oraz Tajny klucz klienta. Będą Ci potrzebne w następnym kroku.

4. Konfigurowanie interfejsu wiersza poleceń Gemini

Teraz skonfigurujmy interfejs wiersza poleceń Gemini, aby używał 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 przeglądarki lokalnej do uwierzytelniania OAuth. Użyj terminala komputera lokalnego. Więcej informacji znajdziesz w sekcji Wymagania dotyczące przekierowania przeglądarki.

Tworzenie pliku konfiguracji

Otwórz lub utwórz plik ~/.gemini/settings.json w katalogu domowym i dodaj tę konfigurację. Zastąp obiekty zastępcze swoimi 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 weryfikacja serwerów MCP

Zanim będzie można używać serwerów MCP, musisz je uwierzytelnić i potwierdzić, że są połączone.

Uruchom interfejs wiersza poleceń Gemini

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

gemini

Uwierzytelnij

Uwierzytelnij się w usługach, które chcesz przetestować, uruchamiając odpowiednie polecenie w interfejsie wiersza poleceń Gemini. Musisz uwierzytelnić się tylko w usługach, których zamierzasz używać 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ę.

Zweryfikuj połączenie

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

/mcp list

Powinny pojawić się dane wyjściowe wskazujące, że usługi są Ready, wraz z listą ich narzędzi.

6. Testowanie serwerów MCP

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: zastąp obiekty zastępcze w nawiasach w poniższych promptach (np. [NAME], [FILE_NAME]) rzeczywistymi wartościami z Twoich danych Google Workspace.

Kalendarz Google

Zapytaj Gemini o swój harmonogram:

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

Google Chat

Spróbuj zapytać Gemini o wyszukanie wiadomości:

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

Dysk Google

Spróbuj zapytać Gemini o znalezienie lub odczytanie plików:

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

Gmail

Spróbuj zapytać Gemini o wyszukanie e-maili lub zarządzanie nimi:

• „Podsumuj 5 ostatnich e-maili, które przyszły do mnie”.
• „Napisz e-maila do [EMAIL_ADDRESS] z prośbą o informacje o projekcie [PROJECT_NAME]”.

People API

Zapytaj Gemini o 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ę, 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 aktualizacjami kamieni milowych projektu [NAZWA_PROJEKTU], podsumuj ich zawartość, znajdź adres e-mail użytkownika [IMIĘ_I_NAZWISKO] 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.

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

8. Gratulacje

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

Czego się nauczysz

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

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