Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Konfigurowanie serwerów MCP Google Workspace

Google Workspace oferuje zdalne serwery Model Context Protocol (MCP), które umożliwiają agentom AI bezpieczną interakcję z danymi Google Workspace. Konfigurując serwery MCP Google Workspace, umożliwiasz aplikacjom AI, takim jak Google Antigravity i Claude, wykonywanie działań w aplikacjach Google Workspace, takich jak Gmail, Dysk Google, Dokumenty Google, Arkusze Google, Prezentacje Google, Kalendarz Google, Google Chat i Google Classroom. Każda usługa Google Workspace ma własny serwer MCP.

Serwery MCP Google Workspace zapewniają agentom AI ustandaryzowany sposób:

Odczytywanie danych: wyszukiwanie e-maili, pobieranie plików i wyświetlanie listy wydarzeń w kalendarzu.
Podejmowanie działań: tworzenie wersji roboczych e-maili, przesyłanie plików i planowanie spotkań.
Przestrzeganie zabezpieczeń: dziedziczenie tych samych uprawnień i ustawień zarządzania danymi co użytkownik.

Wymagania wstępne

Uczestnictwo w programie wersji przedpremierowej Google Workspace dla deweloperów.
projekt Google Cloud, Aby dowiedzieć się, jak utworzyć projekt, przeczytaj artykuł Tworzenie projektu.
klienta MCP, takiego jak Google Antigravity;
Aby uruchomić polecenia na tej stronie, skonfiguruj gcloud CLI w lokalnym środowisku programistycznym, wykonując te czynności:
1. Zainstaluj Google Cloud CLI. Jeśli interfejs wiersza poleceń gcloud został już zainstalowany, upewnij się, że masz najnowszą wersję, uruchamiając polecenie gcloud components update.
2. Jeśli korzystasz z zewnętrznego dostawcy tożsamości, zaloguj się w gcloud CLI przy użyciu tożsamości sfederowanej. Więcej informacji znajdziesz w artykule na temat logowania się w gcloud CLI przy użyciu tożsamości sfederowanej.
3. Zainicjuj gcloud CLI.
Jeśli konfigurujesz serwer MCP Google Classroom, musisz mieć testowe zajęcia w Google Classroom z co najmniej 1 testowym kontem ucznia. Jeśli nie masz zajęć w Google Classroom, których możesz użyć do testowania, utwórz je w interfejsie i dodaj testowego ucznia.

Konfigurowanie serwerów MCP Google Workspace

Aby korzystać z serwerów MCP Google Workspace, musisz je włączyć w projekcie w chmurze Google, a następnie skonfigurować klienta MCP, aby się z nimi łączył.

Włączanie interfejsów API

Aby korzystać z serwerów MCP Google Workspace, musisz włączyć w projekcie w chmurze Google te interfejsy API:

Gmail API
Google Drive API
Google Docs API
Google Sheets API
Google Slides API
Google Calendar API
Interfejs API aplikacji Google Chat
People API
Google Classroom API

Interfejs wiersza poleceń

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.googleapis.com --project=PROJECT_ID

Zastąp PROJECT_ID identyfikatorem projektu Google Cloud.

Konsola

Włącz interfejsy API w konsoli Google Cloud:

Włączanie interfejsów API

Włączanie usług MCP

Aby włączyć komponenty MCP dla każdej usługi Google Workspace, musisz włączyć w projekcie Google Cloud te usługi:

Gmail MCP API
Google Drive MCP API
Google Docs MCP API
Google Sheets MCP API
Google Slides MCP API
Google Calendar MCP API
Google Chat MCP API
People MCP API
Google Classroom MCP API

Interfejs wiersza poleceń

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID

Zastąp PROJECT_ID identyfikatorem projektu Google Cloud.

Konsola

Włącz usługi MCP w konsoli Google Cloud:

Włączanie usług MCP

Konfigurowanie aplikacji Google Chat

Aby korzystać z serwera MCP Google Chat, musisz skonfigurować aplikację Google Chat w projekcie w chmurze Google.

W konsoli Google Cloud wyszukaj Google Chat API i kliknij Google Chat API > Zarządzaj > Konfiguracja.

Otwórz Google Chat API
Skonfiguruj aplikację Google Chat:
1. W polu Nazwa aplikacji wpisz Chat MCP.
2. W polu Avatar URL (Adres URL awatara) wpisz https://developers.google.com/chat/images/quickstart-app-avatar.png.
3. W polu Opis wpisz Chat MCP server.
4. W sekcji Funkcje wyłącz funkcje interaktywne, przełączając opcję Włącz funkcje interaktywne.
5. W sekcji Logi wybierz Loguj błędy w usłudze Logging.
Kliknij Zapisz.

Więcej informacji o tworzeniu aplikacji do Google Chat znajdziesz w artykule Wybieranie architektury aplikacji do Google Chat.

Serwery MCP Google Workspace używają protokołu OAuth 2.0 do uwierzytelniania i autoryzacji. Zanim utworzysz identyfikator klienta OAuth, musisz skonfigurować ekran zgody OAuth.

W konsoli Google Cloud otwórz Google Auth Platform > Marka.

Przejdź na stronę Elementy marki
Jeśli masz już skonfigurowaną platformę uwierzytelniania Google, możesz skonfigurować te ustawienia ekranu zgody OAuth w sekcjach Marka, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Platforma uwierzytelniania Google nie została jeszcze skonfigurowana, kliknij Rozpocznij:
1. W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz Workspace MCP Servers.
2. W polu Adres e-mail dla użytkowników potrzebujących pomocy wybierz swój adres e-mail lub odpowiednią grupę dyskusyjną Google.
3. Kliknij Dalej.
4. W sekcji Odbiorcy wybierz Wewnętrzny. Jeśli nie możesz wybrać opcji Wewnętrzny, wybierz Zewnętrzny.
5. Kliknij Dalej.
6. W sekcji Informacje kontaktowe wpisz adres e-mail, na który chcesz otrzymywać powiadomienia o zmianach w projekcie.
7. Kliknij Dalej.
8. W sekcji Finish (Zakończ) zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsów API Google i jeśli się z nimi zgadzasz, zaznacz pole I agree to the Google API Services: User Data Policy (Akceptuję zasady dotyczące danych użytkownika w usługach interfejsów API Google).
9. Kliknij Dalej.
10. Kliknij Utwórz.
11. Jeśli jako typ użytkownika wybrano Zewnętrzny, dodaj użytkowników testowych:
  1. Kliknij Odbiorcy.
  2. W sekcji Użytkownicy testowi kliknij Dodaj użytkowników.
  3. Wpisz swój adres e-mail i adresy innych autoryzowanych użytkowników testowych, a następnie kliknij Zapisz.
Kliknij Dostęp do danych > Dodaj lub usuń zakresy. Pojawi się panel z listą zakresów dla każdego interfejsu API włączonego w projekcie Google Cloud.
1. W sekcji Ręczne dodawanie zakresów wklej zakresy serwerów MCP, których chcesz używać:
  - 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
  - People API:
    - https://www.googleapis.com/auth/directory.readonly
    - https://www.googleapis.com/auth/userinfo.profile
    - https://www.googleapis.com/auth/contacts.readonly
  - Google Classroom:
    - https://www.googleapis.com/auth/classroom.announcements
    - https://www.googleapis.com/auth/classroom.courses.readonly
    - https://www.googleapis.com/auth/classroom.coursework.students
    - https://www.googleapis.com/auth/classroom.courseworkmaterials
    - https://www.googleapis.com/auth/classroom.rosters.readonly
    - https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
    - https://www.googleapis.com/auth/classroom.topics.readonly
2. Kliknij Dodaj do tabeli.
3. Kliknij Aktualizuj.
4. Po wybraniu zakresów wymaganych przez aplikację na stronie Dostęp do danych kliknij Zapisz.

Konfigurowanie klienta MCP

Aby dodać zdalny serwer MCP Google Workspace do klienta MCP, postępuj zgodnie z instrukcjami dotyczącymi klienta.

Antigravity

Aby dodać zdalne serwery MCP Google Workspace do Antigravity, dodaj konfigurację serwera do pliku mcp_config.json. Te instrukcje dotyczą Antigravity 2.0, Antigravity IDE i Antigravity CLI.

Utwórz identyfikator klienta i tajny klucz OAuth 2.0:
1. W konsoli Google Cloud otwórz Google Auth Platform > Klienci > Utwórz klienta.
  
  Otwórz stronę Utwórz klienta
2. Jako typ aplikacji wybierz Aplikacja internetowa.
3. Wpisz nazwę.
4. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie dodaj https://antigravity.google/oauth-callback w polu Identyfikatory URI.
5. Wybierz Używaj tego klienta w przypadku agenta opartego na AI.
6. Kliknij Create (Utwórz) i skopiuj Client ID (Identyfikator klienta) oraz Client Secret (Tajny klucz klienta).
Otwórz lub utwórz plik konfiguracji ~/.gemini/config/mcp_config.json.

Dodaj konfigurację mcpServers do mcp_config.json:

{
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "classroom": {
      "serverUrl": "https://classroommcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

Zastąp te elementy:

OAUTH_CLIENT_ID: utworzony przez Ciebie identyfikator klienta.
OAUTH_CLIENT_SECRET: utworzony tajny klucz klienta.

Zaoszczędź mcp_config.json.
Uwierzytelnij serwery MCP. Uwierzytelnianie możesz przeprowadzić za pomocą ustawień GUI lub interfejsu wiersza poleceń:
- W przypadku Antigravity IDE lub GUI (Antigravity 2.0):
  1. Otwórz ekran ustawień (np. kliknij Ustawienia w lewym dolnym rogu lub otwórz Ustawienia użytkownika Antigravity).
  2. Kliknij Dostosowania.
  3. W sekcji Zainstalowane serwery MCP kliknij Odśwież.
  4. Dla każdego serwera na liście (gmail, drive, docs, sheets, slides, calendar, chat, people i classroom) kliknij Authenticate (Uwierzytelnij), zaloguj się na swoje konto Google, skopiuj kod autoryzacji, wklej go w oknie dialogowym i kliknij Submit (Prześlij).
- W przypadku Antigravity CLI:
  1. Uruchom Antigravity CLI:
```
agy
```
  2. Otwórz interaktywny panel zarządzania MCP, uruchamiając to polecenie:
```
/mcp
```
  3. Uwierzytelnij każdy serwer MCP:
    1. Użyj klawiszy strzałek, aby wybrać serwer, przejdź do działania Authenticate (Uwierzytelnij) i naciśnij Enter. Dokończ proces logowania w przeglądarce, skopiuj kod autoryzacji, wklej go w wierszu poleceń w terminalu i naciśnij Enter.
    2. Powtórz te czynności dla każdego skonfigurowanego serwera (gmail, drive, docs, sheets, slides, calendar, chat, people i classroom).
Sprawdź, czy serwery są prawidłowo skonfigurowane i działają:
- W przypadku Antigravity IDE lub GUI: przycisk Wyloguj się jest wyświetlany obok każdego serwera w sekcji Dostosowania > Zainstalowane serwery MCP.
- W przypadku Antigravity CLI: otwórz panel /mcp, aby wyświetlić skonfigurowane serwery MCP. Zweryfikowane i uwierzytelnione serwery mają obok nazwy w interaktywnym panelu TUI oznaczenie Authed (Uwierzytelniony). Możesz wybrać dowolny serwer w widoku panelu, aby sprawdzić jego stan i wyświetlić listę wszystkich dostępnych narzędzi.

Zdalne serwery MCP są gotowe do użycia w Antigravity.

Claude

Aby korzystać ze zdalnych serwerów MCP Google Workspace z Claude.ai lub Claude Desktop, musisz mieć abonament Claude Enterprise, Pro, Max lub Team.

Aby dodać zdalne serwery MCP Google Workspace do Claude, skonfiguruj niestandardowe oprogramowanie sprzęgające z identyfikatorem i tajnym kluczem klienta OAuth.

Utwórz identyfikator klienta i tajny klucz OAuth 2.0:
1. W konsoli Google Cloud otwórz Google Auth Platform > Klienci > Utwórz klienta.
  
  Otwórz stronę Utwórz klienta
2. Jako typ aplikacji wybierz Aplikacja internetowa.
3. Wpisz nazwę.
4. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie dodaj https://claude.ai/api/mcp/auth_callback w polu Identyfikatory URI.
5. Wybierz Używaj tego klienta w przypadku agenta opartego na AI.
6. Kliknij Create (Utwórz) i skopiuj Client ID (Identyfikator klienta) oraz Client Secret (Tajny klucz klienta).
Skonfiguruj serwer MCP w Claude:
1. W Claude.ai lub Claude Desktop kliknij Ustawienia (lub Ustawienia administratora) > Oprogramowanie sprzęgające.
2. Kliknij Dodaj oprogramowanie sprzęgające.
3. Wpisz szczegóły połączenia dla usługi Google Workspace, którą chcesz dodać:
  - Nazwa serwera: nazwa serwera, np. Gmail.
  - Remote MCP server URL (URL zdalnego serwera MCP): URL usługi Google Workspace, np.:
    - Gmail: https://gmailmcp.googleapis.com/mcp/v1
    - Dysk Google: https://drivemcp.googleapis.com/mcp/v1
    - Dokumenty Google: https://docsmcp.googleapis.com/mcp/v1
    - Arkusze Google: https://sheetsmcp.googleapis.com/mcp/v1
    - Prezentacje Google: https://slidesmcp.googleapis.com/mcp/v1
    - Kalendarz Google: https://calendarmcp.googleapis.com/mcp/v1
    - Google Chat: https://chatmcp.googleapis.com/mcp/v1
    - People API: https://people.googleapis.com/mcp/v1
    - Google Classroom: https://classroommcp.googleapis.com/mcp/v1
4. W Ustawieniach zaawansowanych wpisz identyfikator klienta OAuth i tajny klucz klienta OAuth.
5. Kliknij Dodaj.
6. Powtórz te czynności w przypadku każdej usługi Google Workspace, którą chcesz dodać.

Inne

Wiele aplikacji AI ma sposoby łączenia się ze zdalnym serwerem MCP. Zwykle musisz podać szczegóły dotyczące serwera, takie jak jego nazwa, punkty końcowe, protokół transportowy i metoda uwierzytelniania. W przypadku zdalnych serwerów MCP Google Workspace wpisz te informacje:

Nazwa serwera: googleworkspace
Serwery: każda usługa Google Workspace ma własny adres URL serwera:
- Gmail: https://gmailmcp.googleapis.com/mcp/v1
- Dysk Google: https://drivemcp.googleapis.com/mcp/v1
- Dokumenty Google: https://docsmcp.googleapis.com/mcp/v1
- Arkusze Google: https://sheetsmcp.googleapis.com/mcp/v1
- Prezentacje Google: https://slidesmcp.googleapis.com/mcp/v1
- Kalendarz Google: https://calendarmcp.googleapis.com/mcp/v1
- Google Chat: https://chatmcp.googleapis.com/mcp/v1
- People API: https://people.googleapis.com/mcp/v1
- Google Classroom: https://classroommcp.googleapis.com/mcp/v1
Transport: Streamable HTTP
Uwierzytelnianie: zdalny serwer MCP Google Workspace używa protokołu OAuth 2.0. Podczas tworzenia klienta OAuth 2.0 wybierz Używaj tego klienta w przypadku agenta opartego na AI. Więcej informacji znajdziesz w artykule Informacje o uwierzytelnianiu i autoryzacji.

Klient MCP potrzebuje tokena odświeżania, aby użytkownicy nie musieli logować się ponownie mniej więcej co godzinę. Serwer OAuth 2.0 Google wydaje token odświeżania tylko wtedy, gdy żądanie autoryzacji zawiera parametr access_type=offline. Jeśli poprosisz tylko o zakres OpenID Connect (OIDC) offline_access, nie otrzymasz takiego tokena. Jeśli Twój klient MCP obsługuje niestandardowe parametry autoryzacji, dodaj access_type=offline do żądania autoryzacji. Aby uzyskać nowy token odświeżania dla użytkownika, który już przyznał dostęp, dodaj też prompt=consent. Jeśli Twój klient MCP nie obsługuje niestandardowych parametrów autoryzacji, użytkownicy muszą logować się ponownie za każdym razem, gdy token dostępu wygaśnie. Więcej informacji znajdziesz w artykule o odświeżaniu tokena dostępu.

Więcej informacji o łączeniu różnych typów klientów znajdziesz w artykule Konfigurowanie MCP w aplikacji AI.

Testowanie serwerów MCP Google Workspace

Po skonfigurowaniu klienta MCP możesz sprawdzić połączenie, uruchamiając kilka promptów testowych.

Zadaj klientowi korzystającemu z MCP te pytania:

„Co Ariel napisała w ostatnim e-mailu o naszym planie marketingowym?”

Klient filtruje e-maile od Ariel za pomocą gmail.search_threads, pobiera treść najnowszego wątku za pomocą gmail.get_thread, a następnie podsumowuje ją dla Ciebie.
„Napisz e-maila do ariel@example.com z informacją, że zatwierdzam plan marketingowy”.

Klient używa gmail.create_draft, aby utworzyć e-maila w folderze wersji roboczych, dzięki czemu możesz go sprawdzić i wysłać z Gmaila.
„Podsumuj plik Plan marketingowy”.

Klient wywołuje drive.search_files, aby znaleźć „Plan marketingowy”, a następnie używa drive.read_file_content, aby pobrać i podsumować jego treść.
„Pokaż mi strukturę notatek ze spotkania w dokumencie Google”.

Klient pobiera strukturę i zawartość dokumentu za pomocą docs.read_doc.
„Przeczytaj arkusz Arkusz1 z Arkusza Google Sprzedaż kwartalna”.

Klient pobiera wartości siatki za pomocą sheets.get_values.
„Pokaż mi układ prezentacji Google Przegląd produktu w formie słownej”.

Klient pobiera struktury układu wizualnego prezentacji za pomocą slides.read_presentation.
„Kiedy mam następne spotkanie z Arielem?”

Klient sprawdza Twój harmonogram za pomocą calendar.list_events i podaje szczegóły następnego spotkania z Ariel.
„Jak się nazywam według mojego profilu Google?”

Klient używa people.get_user_profile do pobierania informacji z Twojego profilu Google Workspace.
„Jakie zajęcia obecnie prowadzę?”

Klient sprawdza Twój harmonogram za pomocą classroom.list_course_summaries i podsumowuje aktywne kursy, w których masz rolę nauczyciela.
„Napisz ogłoszenie o nadchodzącej wycieczce terenowej dla moich uczniów geologii”.

Klient używa classroom.create_announcement do tworzenia wersji roboczej ogłoszenia, które możesz sprawdzić i opublikować w aplikacji Google Classroom.

Jeśli narzędzia zostaną wykonane prawidłowo i otrzymasz odpowiednie odpowiedzi, serwery MCP Google Workspace są skonfigurowane poprawnie.

Rozwiązywanie problemów

Jeśli masz problemy z połączeniem z serwerami MCP, możesz sprawdzić, czy w logach OAuth nie ma błędów. Poproś administratora o sprawdzenie zdarzeń z dziennika OAuth w narzędziu do analizy zagrożeń.

Jeśli Twoje żądania do serwerów MCP są odrzucane, sprawdź, czy w przypadku klienta OAuth 2.0 w Google Auth Platform > Clients (Klienci) jest zaznaczona opcja Use this client for an AI-powered agent (Używaj tego klienta w przypadku agenta opartego na AI). Jeśli nie możesz zmienić tego ustawienia w przypadku istniejącego klienta OAuth, utwórz nowego klienta OAuth z zaznaczoną opcją Używaj tego klienta w przypadku agenta opartego na AI i zaktualizuj aplikację, aby go używała. Jeśli istniejący klient OAuth jest używany zarówno do funkcji agenta AI, jak i funkcji innych niż agent, utwórz osobnego klienta OAuth dla agenta AI i zachowaj istniejącego klienta dla funkcji innych niż agent. Instrukcje znajdziesz w artykułach Konfigurowanie klienta MCP i Zarządzanie klientami OAuth.

Jeśli Twoja aplikacja używa konta usługi z przekazywaniem dostępu w całej domenie, nie możesz wybrać opcji Użyj tego klienta w przypadku agenta opartego na AI, ponieważ konta usługi nie są zarządzane w sekcji Platforma uwierzytelniania Google > Klienci. Żądania wysyłane do serwerów MCP z kont usługi, które korzystają z przekazywania dostępu w całej domenie, nie są odrzucane z tego powodu. Dostęp jest kontrolowany przez ustawienia przekazywania dostępu w całej domenie, którymi zarządza administrator Google Workspace. Szczegółowe informacje znajdziesz w artykule Kontrola dostępu do interfejsów API przy użyciu przekazywania dostępu w całej domenie.

Jeśli wywołujesz serwery MCP z Google Apps Script, Apps Script tworzy domyślnego klienta OAuth dla skryptu i nim zarządza, ale nie możesz wybrać dla niego opcji Użyj tego klienta w przypadku agenta opartego na AI. Dotyczy to również sytuacji, gdy skrypt używa standardowego projektu Google Cloud. Zamiast tego wykonaj te czynności:

W konsoli Google Cloud otwórz Google Auth Platform > Klienci, utwórz klienta OAuth i wybierz Użyj tego klienta na potrzeby agenta opartego na AI.
W skrypcie użyj biblioteki OAuth2 dla Apps Script, aby autoryzować użytkowników za pomocą tego klienta OAuth.
Gdy wywołujesz serwery MCP, wysyłaj token dostępu zwracany przez bibliotekę, a nie token z ScriptApp.getOAuthToken.

Nie dotyczy to projektów Apps Script, które nie wywołują serwerów MCP.

Jeśli co godzinę pojawia się prośba o ponowne zalogowanie, klient MCP nie otrzymuje tokena odświeżania. Serwer OAuth 2.0 Google wydaje token odświeżania tylko wtedy, gdy żądanie autoryzacji zawiera parametr access_type=offline. Żądanie tylko zakresu OpenID Connect (OIDC) offline_access nie zwraca identyfikatora. Jeśli klient MCP obsługuje niestandardowe parametry autoryzacji, dodaj do żądania autoryzacji parametr access_type=offline. Aby uzyskać nowy token odświeżania dla użytkownika, który już przyznał dostęp, dodaj też prompt=consent. Jeśli Twój klient MCP nie obsługuje niestandardowych parametrów autoryzacji, musisz logować się ponownie za każdym razem, gdy token dostępu wygaśnie. Więcej informacji znajdziesz w artykule o odświeżaniu tokena dostępu.

Usługi objęte pomocą

Te usługi Google Workspace obsługują serwery MCP Google Workspace i oferują te narzędzia:

Ważna kwestia dotycząca bezpieczeństwa: pośrednie wstrzykiwanie promptów

Gdy udostępniasz modelowi językowemu niezaufane dane, istnieje ryzyko pośredniego ataku typu wstrzykiwanie promptów. Klienci MCP, tacy jak Google Antigravity, mają dostęp do zaawansowanych narzędzi i interfejsów API za pośrednictwem serwerów MCP Google Workspace, dzięki czemu mogą odczytywać, modyfikować i usuwać dane na Twoim koncie Google.

Aby ograniczyć te zagrożenia, postępuj zgodnie z tymi sprawdzonymi metodami:

Korzystaj tylko z zaufanych narzędzi. Nigdy nie łącz serwerów MCP Google Workspace z niezaufanymi lub niezweryfikowanymi aplikacjami.
Zachowaj ostrożność w przypadku niezaufanych danych wejściowych. Nie proś klienta MCP o przetwarzanie e-maili, dokumentów ani innych zasobów z niezweryfikowanych źródeł. Te dane wejściowe mogą zawierać ukryte instrukcje, które mogą przejąć sesję, umożliwiając atakującemu modyfikowanie, kradzież lub usunięcie danych.
Sprawdź wszystkie działania. Zawsze dokładnie sprawdzaj działania podejmowane przez klienta AI w Twoim imieniu, aby upewnić się, że są prawidłowe i zgodne z Twoimi intencjami.

Konfigurowanie serwerów MCP Google Workspace Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Wymagania wstępne

Konfigurowanie serwerów MCP Google Workspace

Włączanie interfejsów API

Interfejs wiersza poleceń

Konsola

Włączanie usług MCP

Interfejs wiersza poleceń

Konsola

Konfigurowanie aplikacji Google Chat

Konfigurowanie ekranu zgody OAuth

Konfigurowanie klienta MCP

Antigravity

Claude

Inne

Testowanie serwerów MCP Google Workspace

Rozwiązywanie problemów

Usługi objęte pomocą

Ważna kwestia dotycząca bezpieczeństwa: pośrednie wstrzykiwanie promptów

Powiązane artykuły

Konfigurowanie serwerów MCP Google Workspace