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

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

Сервер Google Chat MCP предоставляет стандартизированный способ для агентов искусственного интеллекта:

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

Предварительные требования

Настройте сервер Google Chat MCP.

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

Включите API

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

  • API чата Google

CLI 

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

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

Консоль

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

Включите API

Включите службы MCP.

Для включения компонентов MCP для Google Chat необходимо активировать следующую службу в вашем проекте Google Cloud:

  • API Google Chat MCP

CLI 

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

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

Консоль

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

Включите службы MCP.

Настройте приложение «Чат».

Для использования сервера Google Chat MCP необходимо настроить приложение чата в вашем проекте Google Cloud.

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

    Перейдите на Google Chat API

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

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

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

Чтобы узнать больше о создании приложения для чата, см. раздел «Выбор архитектуры приложения Google Chat» .

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

  1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Брендинг .

    Перейти к разделу «Брендинг»

  2. Если вы уже настроили платформу аутентификации Google , вы можете настроить следующие параметры экрана согласия OAuth в разделах «Брендинг» , «Аудитория» и «Доступ к данным» . Если вы видите сообщение о том, что платформа аутентификации Google еще не настроена , нажмите «Начать» :

    1. В разделе «Информация о приложении» в поле «Название приложения» введите Chat MCP Server .
    2. В разделе «Электронная почта службы поддержки пользователей» выберите свой адрес электронной почты или соответствующую группу Google.
    3. Нажмите «Далее» .
    4. В разделе «Аудитория» выберите «Внутренняя» . Если выбрать «Внутренняя» невозможно, выберите «Внешняя» .
    5. Нажмите «Далее» .
    6. В поле «Контактная информация» укажите адрес электронной почты , на который вы сможете получать уведомления об изменениях в вашем проекте.
    7. Нажмите «Далее» .
    8. В разделе «Завершить» ознакомьтесь с Политикой использования пользовательских данных сервисов Google API и, если вы согласны, выберите «Я согласен с Политикой использования пользовательских данных сервисов Google API» .
    9. Нажмите «Продолжить» .
    10. Нажмите «Создать» .
    11. Если для типа пользователя выбран «Внешний» , добавьте тестовых пользователей:
      1. Нажмите «Аудитория» .
      2. В разделе «Проверка пользователей» нажмите «Добавить пользователей» .
      3. Введите свой адрес электронной почты и имена других авторизованных пользователей, участвующих в тестировании, затем нажмите «Сохранить» .

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

    1. В разделе «Добавить области действия вручную» вставьте области действия для сервера Google Chat MCP:

      • 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. Нажмите «Добавить в таблицу» .

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

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

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

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

Антигравитация

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

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

    1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Клиенты > Создать клиент

      Перейдите в раздел «Создать клиента».

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

    3. Введите имя .

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

    5. Нажмите «Создать» и скопируйте свой идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret) .

  2. Откройте или создайте конфигурационный файл ~/.gemini/antigravity/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 в списке, нажмите «Аутентифицировать» , войдите в свою учетную запись Google, скопируйте код авторизации, вставьте его в диалоговое окно ввода и нажмите «Отправить» .

    • Для интерфейса командной строки Antigravity:

      1. Запуск интерфейса командной строки Antigravity:

        agy

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

        /mcp

      3. Используйте клавиши со стрелками, чтобы выбрать chat , перейдите к действию «Аутентификация» и нажмите Enter . Завершите процесс входа в систему в браузере, скопируйте код авторизации, вставьте его в командную строку терминала и нажмите Enter .

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

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

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

Клод

Для использования удаленного сервера Google Chat MCP с Claude.ai или Claude Desktop вам необходим тарифный план Claude Enterprise, Pro, Max или Team.

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

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

    1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Клиенты > Создать клиент

      Перейдите в раздел «Создать клиента».

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

    3. Введите имя .

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

    5. Нажмите «Создать» и скопируйте свой идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret) .

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

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

Другие

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

Для получения более подробной информации о подключении различных типов клиентов см. раздел «Настройка MCP в приложении ИИ» .

Протестируйте сервер Google Chat MCP.

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

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

  • «Какое последнее сообщение было размещено в пространстве „Проекта X“?»

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

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

Поиск неисправностей

Если у вас возникли проблемы с подключением к серверу MCP, вы можете проверить наличие ошибок в журналах OAuth. Попросите вашего администратора проверить события журнала OAuth в инструменте анализа безопасности .

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

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

  • search_conversations
  • list_messages
  • search_messages
  • send_message

Важный аспект безопасности: непрямая инъекция подсказки.

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

Для снижения этих рисков следуйте этим передовым методам:

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