Konfigurowanie serwera MCP czatu

Google Chat oferuje zdalny serwer Model Context Protocol (MCP) , który umożliwia agentom AI bezpieczne interakcje z danymi Google Chat. Konfigurując serwer MCP Google Chat, umożliwiasz aplikacjom AI, takim jak Google Antigravity i Claude, wykonywanie działań w Google Chat.

Serwer MCP Google Chat zapewnia agentom AI standardowy sposób na:

  • odczytywanie danych: wyświetlanie i wyszukiwanie rozmów oraz odczytywanie wiadomości;
  • przestrzeganie zasad bezpieczeństwa: dziedziczenie tych samych uprawnień i kontroli 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 Google Cloud, a następnie skonfigurować klienta MCP, aby się z nim połączyć.

Włączanie interfejsów API

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

  • Google Chat API

CLI

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łącz interfejsy 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

CLI

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łącz usługi 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 Google Chat nie jest wymagana.

Aby wykonywać operacje zapisu, takie jak wysyłanie wiadomości, musisz skonfigurować aplikację Google Chat w projekcie w chmurze Google.

  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 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, klikając Włącz funkcje interaktywne.
    5. W sekcji Dzienniki kliknij Loguj błędy w usłudze Logging.

  3. Kliknij Zapisz.

Więcej informacji o tworzeniu aplikacji Google Chat znajdziesz w artykule Wybieranie architektury aplikacji 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 akceptacji OAuth.

  1. W konsoli Google Cloud otwórz Platforma uwierzytelniania Google > Elementy marki.

    Przejdź na stronę Elementy marki

  2. Jeśli Platforma uwierzytelniania Google została już skonfigurowana, możesz skonfigurować te ustawienia ekranu akceptacji OAuth w sekcjach Elementy marki, 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 E-mail do pomocy dla użytkowników wybierz swój adres e-mail lub odpowiednią grupę dyskusyjną Google.
    3. Kliknij Dalej.
    4. W sekcji Odbiorcy kliknij Wewnętrzny. Jeśli nie możesz wybrać opcji Wewnętrzny, kliknij Zewnętrzny.
    5. Kliknij Dalej.
    6. W sekcji Dane kontaktowe wpisz Adres e-mail, na który chcesz otrzymywać powiadomienia o zmianach w projekcie.
    7. Kliknij Dalej.
    8. W sekcji Zakończ zapoznaj się z Zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google i jeśli je akceptujesz, kliknij Akceptuję zasady dotyczące danych użytkownika w usługach interfejsu API Google.
    9. Kliknij Dalej.
    10. Kliknij Utwórz.
    11. Jeśli jako typ użytkownika wybierzesz 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 e-mail 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ęcznie dodaj zakresy wklej zakresy dla 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.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 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 i tajny klucz klienta OAuth 2.0:

    1. W konsoli Google Cloud otwórz Platforma uwierzytelniania Google > 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. Kliknij Utwórz i skopiuj Identyfikator klienta oraz Tajny klucz klienta.

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

  3. Dodaj konfigurację mcpServers do pliku 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 identyfikator klienta.
    • OAUTH_CLIENT_SECRET: utworzony tajny klucz klienta.

  4. Zapisz plik mcp_config.json.

  5. Uwierzytelnij serwer MCP. Możesz uwierzytelnić się 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. Otwórz Dostosowania.
      3. W sekcji Zainstalowane serwery MCP kliknij Odśwież.
      4. Znajdź chat na liście, kliknij Uwierzytelnij, zaloguj się na 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:

        /mcp

      3. Za pomocą klawiszy strzałek wybierz chat, przejdź do działania Uwierzytelnij i naciśnij Enter. Zakoń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 działa:

    • W przypadku Antigravity IDE lub GUI: obok serwera w sekcji Dostosowania > Zainstalowane serwery MCP wyświetla się przycisk Wyloguj się.
    • W przypadku Antigravity CLI: otwórz panel /mcp, aby wyświetlić skonfigurowane serwery MCP. Zweryfikowane i uwierzytelnione serwery wyświetlają obok swoich nazw w interaktywnym panelu TUI napis Authed. Aby sprawdzić stan serwera i wyświetlić listę wszystkich dostępnych narzędzi, możesz wybrać dowolny serwer w widoku panelu.

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

Claude

Aby używać zdalnego serwera MCP Google Chat z Claude.ai lub Claude Desktop, musisz mieć plan Claude Enterprise, Pro, Max lub Team.

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

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

    1. W konsoli Google Cloud otwórz Platforma uwierzytelniania Google > 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. Kliknij Utwórz i skopiuj Identyfikator klienta oraz Tajny klucz klienta.

  2. Skonfiguruj serwer MCP w Claude:

    1. W Claude.ai lub Claude Desktop otwórz Ustawienia (lub Ustawienia administratora) > Oprogramowanie sprzęgające.
    2. Kliknij Dodaj niestandardowe oprogramowanie sprzęgające.
    3. Wpisz szczegóły połączenia z Google Chat:
      • Nazwa serwera: Google Chat.
      • URL zdalnego serwera MCP: https://chatmcp.googleapis.com/mcp/v1
    4. W sekcji Ustawienia zaawansowane wpisz Identyfikator klienta OAuth i Tajny klucz klienta OAuth.
    5. Kliknij Dodaj.

Inne

Wiele aplikacji AI ma sposoby łączenia się ze zdalnym serwerem MCP. Zazwyczaj musisz wpisać 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 te informacje:

  • Nazwa serwera: chat

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

  • Transport: HTTP

  • Uwierzytelnianie: zdalny serwer MCP Google Chat używa protokołu OAuth 2.0. 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 testowych promptów.

Spróbuj zadać klientowi MCP te pytania:

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

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

Jeśli narzędzia działają prawidłowo i otrzymujesz 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 dziennikach OAuth nie ma błędów. Poproś administratora, aby sprawdził zdarzenia z dziennika OAuth w narzędziu do analizy zagrożeń.

Informacje o narzędziach

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

  • search_conversations
  • list_messages
  • search_messages
  • send_message

Ważna kwestia związana z bezpieczeństwem: pośrednie wstrzykiwanie promptów

Gdy model językowy jest narażony na niezaufane dane, istnieje ryzyko pośredniego ataku polegającego na wstrzykiwaniu promptów. Ponieważ hosty MCP, takie jak Google Antigravity, mają dostęp do zaawansowanych narzędzi i interfejsów API za pomocą serwera MCP Google Chat, mogą odczytywać, modyfikować i usuwać dane na Twoim koncie Google.

Aby zmniejszyć to ryzyko, musisz sprawdzać prompty i odpowiedzi pod kątem złośliwych treści lub ataków polegających na wstrzykiwaniu promptów. Możesz użyć dostarczonego przez Google narzędzia Model Armor lub własnego rozwiązania, jeśli udokumentujesz je tak, aby użytkownicy mogli zaakceptować to ryzyko. Więcej informacji znajdziesz w artykule Konfigurowanie zabezpieczeń serwerów MCP Google Workspace.

Postępuj zgodnie z tymi sprawdzonymi metodami:

  • Używaj tylko zaufanych narzędzi. Nigdy nie łącz serwera MCP Google Chat z niezaufanymi lub niezweryfikowanymi aplikacjami.
  • Zachowaj ostrożność w przypadku niezaufanych danych wejściowych. Nie proś klienta MCP o przetwarzanie wiadomości 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 usuwanie danych.
  • Sprawdzaj wszystkie działania. Zawsze dokładnie sprawdzaj działania podejmowane przez klienta AI w Twoim imieniu, aby upewnić się, że są one prawidłowe i zgodne z Twoimi intencjami.