Konfigurowanie serwera MCP czatu

Google Chat oferuje zdalny serwer Model Context Protocol (MCP), który umożliwia agentom AI bezpieczną interakcję z danymi Google Chat. Skonfigurowanie serwera MCP Google Chat umożliwia aplikacjom AI, takim jak Google Antigravity i Claude, wykonywanie działań w Google Chat.

Serwer MCP Google Chat zapewnia agentom AI ustandaryzowany sposób:

  • Odczytywanie danych: wyświetlanie i wyszukiwanie rozmów oraz odczytywanie wiadomości.
  • Przestrzeganie zabezpieczeń: dziedziczenie tych samych uprawnień i ustawień zarządzania danymi co użytkownik.

Wymagania wstępne

Konfigurowanie serwera MCP Google Chat

Aby korzystać z serwera MCP Google Chat, musisz go włączyć w projekcie w chmurze Google, a następnie skonfigurować klienta MCP, aby się z nim łączył.

Włączanie interfejsów API

Aby korzystać z serwera MCP Google Chat, musisz włączyć w projekcie Google Cloud te interfejsy API:

  • Interfejs API aplikacji Google Chat

Interfejs wiersza poleceń

gcloud services enable chat.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 w Google Chat, musisz włączyć tę usługę w projekcie Google Cloud:

  • Google Chat MCP API

Interfejs wiersza poleceń

gcloud services enable chatmcp.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 używać serwera MCP Google Chat do wykonywania operacji tylko do odczytu, takich jak wyszukiwanie rozmów, musisz włączyć interfejs API i utworzyć klienta OAuth. Skonfigurowana aplikacja do Google Chat nie jest wymagana.

Aby wykonywać operacje zapisu, takie jak wysyłanie wiadomości, musisz skonfigurować aplikację do obsługi czatu 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:

    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.

  3. Kliknij Zapisz.

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

Serwer MCP Google Chat używa protokołu OAuth 2.0 do uwierzytelniania i autoryzacji. Zanim utworzysz identyfikator klienta OAuth, musisz skonfigurować ekran zgody OAuth.

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

    Przejdź na stronę Elementy marki

  2. 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 Chat MCP Server.
    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.

  3. 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 serwera MCP 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
      • https://www.googleapis.com/auth/chat.users.spacesettings

    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 Chat do klienta MCP, postępuj zgodnie z instrukcjami dotyczącymi klienta.

Antigravity

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

  1. Utwórz identyfikator klienta OAuth 2.0 i klucz tajny:

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

  2. Otwórz lub utwórz plik konfiguracji ~/.gemini/config/mcp_config.json.

  3. Dodaj konfigurację mcpServers do mcp_config.json:

    {
  "mcpServers": {
    "chat": {
      "serverUrl": "https://chatmcp.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.

  4. Zaoszczędź mcp_config.json.

  5. Uwierzytelnij serwer 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. Znajdź chat na liście, kliknij Uwierzytelnij, zaloguj się na swoje konto Google, skopiuj kod autoryzacji, wklej go w oknie dialogowym i kliknij 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. Użyj klawiszy strzałek, aby wybrać chat, przejdź do działania Uwierzytelnij i naciśnij Enter. Dokończ proces logowania w przeglądarce, skopiuj kod autoryzacji, wklej go w wierszu poleceń terminala i naciśnij Enter.

  6. Sprawdź, czy serwer jest prawidłowo skonfigurowany i czy działa:

    • W przypadku Antigravity IDE lub GUI: przycisk Wyloguj się jest wyświetlany obok 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.

Zdalny serwer MCP jest gotowy do użycia w Antigravity.

Claude

Aby korzystać ze zdalnego serwera MCP Google Chat z Claude.ai lub Claude Desktop, musisz mieć abonament Claude Enterprise, Pro, Max lub Team.

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

  1. Utwórz identyfikator klienta OAuth 2.0 i klucz tajny:

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

  2. 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 Chat:
      • Nazwa serwera: Google Chat.
      • URL zdalnego serwera MCP: https://chatmcp.googleapis.com/mcp/v1
    4. W Ustawieniach zaawansowanych wpisz identyfikator klienta OAuth i tajny klucz klienta OAuth.
    5. Kliknij Dodaj.

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 zdalnego serwera MCP Google Chat wpisz:

  • Nazwa serwera: chat

  • URL serwera: https://chatmcp.googleapis.com/mcp/v1

  • Transport: Streamable HTTP

  • Uwierzytelnianie: zdalny serwer MCP Google Chat 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.

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

Testowanie serwera MCP Google Chat

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

Zadaj klientowi korzystającemu z MCP te pytania:

  • „Jaka była ostatnia wiadomość w pokoju Projekt X?”

    Klient znajduje pokój za pomocą search_conversations, a następnie pobiera wiadomości za pomocą list_messages.

Jeśli narzędzia zostaną wykonane prawidłowo i otrzymasz odpowiednie odpowiedzi, serwer MCP Google Chat jest prawidłowo skonfigurowany.

Rozwiązywanie problemów

Jeśli masz problemy z połączeniem z serwerem 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 żądania wysyłane do serwera MCP są odrzucane, sprawdź, czy klient OAuth 2.0 ma zaznaczoną opcję Używaj tego klienta w przypadku agenta opartego na AI w sekcji Google Auth Platform > Klienci. 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 co godzinę pojawia się prośba o ponowne zalogowanie, klient MCP nie otrzymuje tokena odświeżania. Serwer autoryzacji Google wydaje tokeny odświeżania tylko wtedy, gdy żądanie autoryzacji zawiera access_type=offline. Samo żądanie zakresu OIDC offline_access nie wystarczy. 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.

Dokumentacja narzędzia

W przypadku serwera MCP Google Chat dostępne są te narzędzia:

  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
  • get_notification_settings
  • update_notification_settings

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. Ponieważ hosty MCP, takie jak Google Antigravity, mają dostęp do zaawansowanych narzędzi i interfejsów API za pośrednictwem serwera MCP Google Chat, mogą odczytywać, modyfikować i usuwać dane na Twoim koncie Google.

Aby ograniczyć te zagrożenia, musisz sprawdzać prompty i odpowiedzi pod kątem szkodliwych treści lub ataków typu „wstrzykiwanie promptów”. Możesz użyć dostarczonego przez Google rozwiązania Model Armor lub własnego rozwiązania, jeśli je udokumentujesz, aby użytkownicy mogli zaakceptować ryzyko. Więcej informacji znajdziesz w artykule Konfigurowanie zabezpieczeń serwerów MCP Google Workspace.

Zastosuj te sprawdzone metody:

  • Korzystaj tylko z zaufanych narzędzi. Nigdy nie łącz serwera MCP Google Chat z niezaufanymi lub niezweryfikowanymi aplikacjami.
  • Zachowaj ostrożność w przypadku niezaufanych danych wejściowych. Unikaj proszenia klienta MCP o przetwarzanie wiadomości lub 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.