Настройте MCP-сервер Chat

Google Chat предлагает удаленный сервер Model Context Protocol (MCP), который позволяет ИИ-агентам безопасно взаимодействовать с данными Google Chat. Настроив MCP-сервер Google Chat, вы разрешите ИИ-приложениям, таким как Google Antigravity и Claude, выполнять действия в Google Chat.

MCP-сервер Google Chat предоставляет ИИ-агентам стандартизированный способ:

  • Чтение данных. Просмотр списка чатов, поиск по ним и чтение сообщений.
  • Безопасность. Gemini наследует те же разрешения и настройки управления данными, что и пользователь.

Требования

Как настроить MCP-сервер Google Chat

Чтобы использовать сервер MCP Google Chat, включите его в облачном проекте Google Cloud, а затем настройте клиент MCP для подключения к нему.

Включение API

Чтобы использовать сервер MCP для Google Chat, необходимо включить в облачном проекте Google Cloud следующие API:

  • Google Chat API

ИКС

gcloud services enable chat.googleapis.com --project=PROJECT_ID

Замените PROJECT_ID идентификатором проекта Google Cloud.

Консоль

Включите API в консоли Google Cloud:

Как включить API

Включите сервисы MCP

Чтобы включить компоненты MCP для Google Chat, необходимо включить в проекте Google Cloud следующий сервис:

  • Google Chat MCP API

ИКС

gcloud services enable chatmcp.googleapis.com --project=PROJECT_ID

Замените PROJECT_ID идентификатором проекта Google Cloud.

Консоль

Включите сервисы MCP в консоли Google Cloud:

Как включить сервисы MCP

Настройте приложение Chat

Чтобы использовать MCP-сервер Google Chat для выполнения операций только для чтения, например поиска чатов, необходимо включить API и создать клиент OAuth. Настраивать приложение Chat не требуется.

Чтобы выполнять операции записи, например отправлять сообщения, необходимо настроить приложение Chat в облачном проекте Google Cloud.

  1. В консоли Google Cloud найдите Google Chat API и нажмите Google Chat API > Manage (Управление) > Configuration (Конфигурация).

    Перейти к Google Chat API

  2. Настройте приложение Chat:

    1. В поле Название приложения введите Chat MCP.
    2. В поле Avatar URL (URL аватара) введите https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. В поле Description (Описание) введите Chat MCP server.
    4. В разделе Функциональность отключите интерактивные функции, установив переключатель Включить интерактивные функции в положение "Выключено".
    5. В разделе Журналы выберите Записывать ошибки в журнал.

  3. Нажмите Сохранить.

Подробнее о том, как создавать приложения для Chat, см. Как выбрать архитектуру приложения Google Chat.

MCP-сервер Google Chat использует OAuth 2.0 для аутентификации и авторизации. Прежде чем создавать идентификатор клиента OAuth, необходимо настроить окно запроса доступа OAuth.

  1. В консоли Google Cloud выберите Google Auth Platform (Платформа идентификации Google) > Branding (Брендинг).

    Перейти к брендингу

  2. Если вы уже настроили платформу идентификации Google, то можете задать следующие настройки окна запроса доступа OAuth: Брендинг, Аудитория и Доступ к данным. Если вы видите сообщение Google Auth Platform not configured yet (Платформа Google Auth ещё не настроена), нажмите Get Started (Начать).

    1. В разделе App Information (Информация о приложении) в поле App name (Название приложения) введите Chat MCP Server.
    2. В поле Электронный адрес службы поддержки выберите свой адрес электронной почты или адрес группы Google.
    3. Нажмите Далее.
    4. В разделе Аудитория выберите Внутренние. Если вы не можете выбрать Внутреннее, выберите Внешнее.
    5. Нажмите Далее.
    6. В разделе Контактная информация укажите адрес электронной почты, на который вы хотите получать уведомления об изменениях в проекте.
    7. Нажмите Далее.
    8. В разделе Finish (Завершение) ознакомьтесь с Правилами в отношении пользовательских данных сервисов API Google и, если вы согласны с ними, установите флажок I agree to the Google API Services: User Data Policy (Я принимаю Правила в отношении пользовательских данных сервисов API Google).
    9. Нажмите Продолжить.
    10. Нажмите Создать.
    11. Если вы выбрали тип пользователя Внешний, добавьте тестовых пользователей:
      1. Нажмите Аудитория.
      2. В разделе Тестовые пользователи нажмите Добавить пользователей.
      3. Введите свой адрес электронной почты и адреса других авторизованных тестовых пользователей, а затем нажмите Сохранить.

  3. Нажмите Доступ к данным > Добавить или удалить области действия. Появится панель со списком областей действия для каждого API, включенного в проекте Google Cloud.

    1. В разделе Добавить области действия вручную вставьте области действия для 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. Нажмите Добавить в таблицу.

    3. Нажмите Обновить.

    4. Выбрав области действия, необходимые для вашего приложения, на странице Доступ к данным нажмите Сохранить.

Настройте MCP-клиент

Чтобы добавить удаленный MCP-сервер Google Chat в MCP-клиент, следуйте инструкциям для вашего клиента.

Для идентификаторов клиентов OAuth 2.0, делегированных пользователями и вызывающих MCP-сервер Chat, должен быть установлен флажок Использовать этот клиент для агента на основе искусственного интеллекта в разделе Google Auth Platform > Clients (Клиенты). Чтобы обновить существующий идентификатор клиента OAuth 2.0, выберите этот параметр в разделе Google Auth Platform > Clients (Клиенты), как описано в статье Как управлять клиентами OAuth. Если вы не можете изменить эту настройку для существующего клиента или клиент также поддерживает функции, не связанные с агентами, создайте новый идентификатор клиента OAuth 2.0 для ИИ-агента. Если запрос отклонен, вы используете сервисные аккаунты с делегированием доступа к данным в домене или Google Apps Script, ознакомьтесь с разделом Устранение неполадок.

Antigravity

Чтобы добавить удаленный MCP-сервер Google Chat в Antigravity, добавьте конфигурацию сервера в файл mcp_config.json. Эти инструкции подходят для Antigravity 2.0, Antigravity IDE и Antigravity CLI.

  1. Создайте идентификатор клиента и секретный код OAuth 2.0:

    1. В консоли Google Cloud выберите Google Auth Platform (Платформа идентификации Google) > Clients (Клиенты) > Create Client (Создать клиента).

      Перейти к созданию клиента

    2. В качестве типа приложения выберите Веб-приложение.

    3. Укажите название.

    4. В разделе Разрешенные URI перенаправления нажмите + Добавить URI и введите https://antigravity.google/oauth-callback в поле URI.

    5. Выберите Использовать этого клиента для агента на основе искусственного интеллекта.

    6. Нажмите Создать и скопируйте идентификатор клиента и секретный код клиента.

  2. Откройте или создайте файл конфигурации ~/.gemini/config/mcp_config.json.

  3. Добавьте конфигурацию mcpServers в mcp_config.json:

    {
  "mcpServers": {
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    Замените следующее:

    • OAUTH_CLIENT_ID – созданный вами идентификатор клиента.
    • OAUTH_CLIENT_SECRET: секретный код клиента, который вы создали.

  4. Экономите mcp_config.json.

  5. Выполните аутентификацию MCP-сервера. Вы можете выполнить аутентификацию с помощью графического интерфейса пользователя или интерфейса командной строки.

    • Для Antigravity IDE или GUI (Antigravity 2.0):

      1. Откройте экран настроек (например, нажмите Настройки в левом нижнем углу или откройте Пользовательские настройки Antigravity).
      2. Перейдите в раздел Настройки.
      3. В разделе Установленные MCP-серверы нажмите Обновить.
      4. Найдите в списке chat, нажмите Authenticate (Аутентификация), войдите в аккаунт Google, скопируйте код авторизации, вставьте его в диалоговое окно и нажмите Submit (Отправить).

    • Для Antigravity CLI:

      1. Запустите Antigravity CLI:

        agy

      2. Откройте интерактивную панель управления MCP, выполнив следующую команду:

        /mcp

      3. С помощью клавиш со стрелками выберите chat, перейдите к действию Аутентификация и нажмите Ввод. Выполните вход в браузере, скопируйте код авторизации, вставьте его в командную строку терминала и нажмите Ввод.

  6. Убедитесь, что сервер правильно настроен и работает:

    • Для Antigravity IDE или графического интерфейса пользователя. Кнопка Выйти показывается рядом с сервером в разделе Настройки > Установленные MCP-серверы.
    • Для Antigravity CLI. Откройте панель /mcp, чтобы посмотреть настроенные серверы MCP. Рядом с названиями проверенных и аутентифицированных серверов на интерактивной панели TUI отображается надпись Authed. Вы можете выбрать любой сервер на панели управления, чтобы проверить его статус и посмотреть список доступных инструментов.

Удаленный MCP-сервер готов к использованию в Antigravity.

Claude

Чтобы использовать удаленный MCP-сервер Google Chat с Claude.ai или Claude Desktop, у вас должен быть тарифный план Claude Enterprise, Pro, Max или Team.

Чтобы добавить удаленный MCP-сервер Google Chat в Claude, настройте собственный коннектор с идентификатором и секретным кодом клиента OAuth.

  1. Создайте идентификатор клиента и секретный код OAuth 2.0:

    1. В консоли Google Cloud выберите Google Auth Platform (Платформа идентификации Google) > Clients (Клиенты) > Create Client (Создать клиента).

      Перейти к созданию клиента

    2. В качестве типа приложения выберите Веб-приложение.

    3. Укажите название.

    4. В разделе Разрешенные URI перенаправления нажмите + Добавить URI и введите https://claude.ai/api/mcp/auth_callback в поле URI.

    5. Выберите Использовать этого клиента для агента на основе искусственного интеллекта.

    6. Нажмите Создать и скопируйте идентификатор клиента и секретный код клиента.

  2. Настройте MCP-сервер в Claude:

    1. В Claude.ai или Claude Desktop перейдите в Settings (Настройки) > Connectors (Коннекторы) или Admin settings (Настройки администратора) > Connectors (Коннекторы).
    2. Нажмите Добавить собственный коннектор.
    3. Укажите сведения о подключении для Google Chat:
      • Имя сервера: Google Chat.
      • URL удаленного MCP-сервера: https://chatmcp.googleapis.com/mcp/v1
    4. В разделе Расширенные настройки введите идентификатор клиента OAuth и секретный код клиента OAuth.
    5. Нажмите Добавить.

Другое

Многие ИИ-приложения могут подключаться к удаленному MCP-серверу. Обычно требуется ввести сведения о сервере, например его название, конечные точки, транспортный протокол и способ аутентификации. Для удаленного сервера MCP Google Chat введите следующее:

  • Имя сервера: chat.

  • URL сервера: https://chatmcp.googleapis.com/mcp/v1

  • Транспорт: Streamable HTTP.

  • Аутентификация. Удаленный MCP-сервер Google Chat использует OAuth 2.0. При создании клиента OAuth 2.0 выберите Использовать этот клиент для агента на основе искусственного интеллекта. Подробнее об аутентификации и авторизации…

Подробнее о том, как подключать разные типы клиентов, рассказывается в статье Как настроить MCP в ИИ-приложении.

Как протестировать MCP-сервер Google Chat

После настройки MCP-клиента вы можете проверить подключение, выполнив несколько тестовых запросов.

Попробуйте задать MCP-клиенту следующие вопросы:

  • "Какое последнее сообщение в чат-группе 'Проект X'?"

    Клиент находит чат-группу с помощью search_conversations, а затем получает сообщения с помощью list_messages.

Если инструменты выполняются успешно и вы получаете релевантные ответы, значит MCP-сервер Google Chat настроен правильно.

Устранение неполадок

В разделах ниже описано, как устранить распространенные проблемы с аутентификацией и подключением к MCP-серверу Chat.

Как посмотреть события в журнале OAuth

Если у вас возникли проблемы с подключением к MCP-серверу, проверьте журналы OAuth на наличие ошибок. Попросите администратора Google Workspace проверить события в журнале OAuth с помощью инструмента "Анализ безопасности".

Отклоненные запросы от клиентов OAuth, делегированных пользователями

Если запросы к MCP-серверу отклоняются, убедитесь, что для идентификатора клиента OAuth 2.0, делегированного пользователем, в трехстороннем потоке OAuth выбран параметр Использовать этот клиент для агента на основе ИИ в Google Auth Platform > Клиенты.

  • Существующий клиент поддерживает настройку. Выберите Использовать этот клиент для агента на основе искусственного интеллекта в существующем клиенте OAuth.
  • Существующий клиент нельзя обновить. Создайте новый клиент OAuth, выбрав Использовать этот клиент для агента на основе искусственного интеллекта, и обновите приложение, чтобы использовать его.
  • Существующий клиент также поддерживает функции, не связанные с агентом. Создайте отдельный клиент OAuth для ИИ-агента и сохраните существующий клиент для функций, не связанных с агентом.

Инструкции приведены в статьях Как настроить клиент MCP и Как управлять клиентами OAuth.

Сервисные аккаунты с делегированием доступа к данным в домене

Если в вашем приложении используется сервисный аккаунт с делегированием доступа к данным в домене для двухстороннего протокола OAuth, вы не можете выбрать Использовать этот клиент для агента на основе искусственного интеллекта, поскольку сервисные аккаунты не управляются в Google Auth Platform > Клиенты.

  • Контроль доступа. Запросы к MCP-серверу от этих сервисных аккаунтов не отклоняются из-за отсутствия настройки агента. Вместо этого доступ регулируется настройками делегирования доступа к данным в домене, которыми управляет администратор Google Workspace. Подробные сведения о настройках администратора приведены в статье Как управлять доступом к API, используя делегирование доступа к данным в домене.
  • Действия, связанные с безопасностью. MCP-серверы Google Workspace по-прежнему возвращают запросы на заполнение форм для подтверждения человеком в контуре конфиденциальных вызовов инструментов, выполняемых через вход под чужим именем с делегированием доступа к данным в домене.

Запросы из Apps Script

Если вы вызываете сервер MCP из Apps Script, вы не можете выбрать Использовать этот клиент для агента на основе искусственного интеллекта в клиенте OAuth по умолчанию, который Apps Script создает для вашего скрипта и которым управляет. Это правило действует, даже если в скрипте используется стандартный проект Google Cloud.

Чтобы вызвать MCP-сервер из Apps Script, сделайте следующее:

  1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Clients (Клиенты), создайте клиент OAuth и выберите Use this client for an AI-powered agent (Использовать этот клиент для агента на основе искусственного интеллекта).
  2. В скрипте используйте библиотеку OAuth2 для Apps Script, чтобы авторизовать пользователей с помощью этого клиента OAuth.
  3. При вызове MCP-сервера отправьте токен доступа, возвращенный библиотекой, а не токен из ScriptApp.getOAuthToken.

Проекты Apps Script, которые не вызывают MCP-серверы Google Workspace, не будут затронуты.

Повторяющиеся ежечасные запросы на вход в аккаунт

Если вам приходится входить в систему примерно каждый час, значит клиент MCP не получает токен обновления. Сервер OAuth 2.0 от Google выдает токен обновления, только если запрос авторизации содержит access_type=offline. Если запрашивается только область действия offline_access OpenID Connect (OIDC), то токен не возвращается.

Проверьте, поддерживает ли MCP-клиент специальные параметры авторизации.

  • Клиент поддерживает специальные параметры авторизации. Добавьте в запрос авторизации access_type=offline. Чтобы получить новый токен обновления для пользователя, который уже предоставил доступ, также добавьте prompt=consent.
  • Клиент не поддерживает специальные параметры авторизации. Выполняйте вход каждый раз, когда истекает срок действия токена доступа.

Подробнее о том, как обновить токен доступа…

Справочник по инструментам

Для сервера MCP Google Chat доступны следующие инструменты:

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

Важная информация о безопасности: косвенное внедрение запроса

Если языковая модель получает доступ к ненадежным данным, возникает риск косвенной атаки с внедрением запроса. Поскольку у хостов MCP, таких как Google Antigravity, есть доступ к мощным инструментам и API через MCP-сервер Google Chat, они могут читать, изменять и удалять данные в вашем аккаунте Google.

Чтобы снизить эти риски, необходимо проверять запросы и ответы на наличие вредоносного контента или атак с внедрением запросов. Вы можете использовать Model Armor от Google или собственное решение, если вы задокументируете его, чтобы пользователи могли принять этот риск. Подробнее о том, как настроить безопасность для MCP-серверов Google Workspace…

Следуйте этим рекомендациям:

  • Используйте только надежные инструменты. Никогда не подключайте MCP-сервер Google Chat к ненадежным или непроверенным приложениям.
  • Будьте осторожны с ненадежными входными данными. Не просите MCP-клиента обрабатывать сообщения или другие ресурсы из непроверенных источников. Эти входные данные могут содержать скрытые инструкции, которые могут перехватить ваш сеанс, позволяя злоумышленнику изменять, красть или удалять ваши данные.
  • Проверьте все действия. Всегда внимательно проверяйте действия, которые ИИ-клиент выполняет от вашего имени, чтобы убедиться, что они правильные и соответствуют вашим намерениям.