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

Как разрешить ИИ-агентам выполнять поиск в Workspace с помощью MCP-сервера Universal Search для Workspace

MCP-сервер универсального поиска для Google Workspace использует стандарт Model Context Protocol (MCP), чтобы ИИ-агенты могли выполнять поиск по вашим артефактам Workspace. Этот сервер позволяет выполнять поиск по нескольким продуктам Google Workspace, включая письма Gmail, файлы на Google Диске, мероприятия Google Календаря, а также чат-группы и сообщения Google Chat, с помощью одного инструмента.

MCP-сервер Universal Search предоставляет ИИ-агентам стандартизированный способ поиска информации во всем аккаунте Google Workspace без необходимости вызывать отдельные инструменты для конкретных продуктов.

Требования

Участие в программе предварительной версии для разработчиков Google Workspace.
Проект Google Cloud. Подробнее о том, как создать проект…
MCP-клиент, например Google Antigravity.
Чтобы запустить команды, указанные на этой странице, настройте gcloud CLI в одной из следующих сред разработки:
Cloud Shell
Чтобы использовать онлайн-терминал с уже настроенным gcloud CLI, активируйте Cloud Shell:

Активировать Cloud Shell
Локальная оболочка
Чтобы использовать локальную среду разработки, выполните следующие действия:
1. Установите Google Cloud CLI. Если вы уже установили gcloud CLI, убедитесь, что у вас последняя версия, выполнив команду gcloud components update.
2. Если вы используете внешнего поставщика идентификационной информации, войдите в gcloud CLI с помощью федеративной идентификационной информации. Подробнее о том, как войти в gcloud CLI с помощью федеративной идентификационной информации…
3. Инициализируйте gcloud CLI.

Как настроить MCP-сервер универсального поиска

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

Включение API

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

ИКС

gcloud services enable workspacemcp.googleapis.com \
  --project=PROJECT_ID

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

Консоль

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

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

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

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

При аутентификации на MCP-сервере универсального поиска вы можете выбрать, для каких областей действия она будет выполняться – для всех или только для некоторых. Сервер учитывает эти настройки и выполняет поиск только по тем продуктам, к которым предоставлен доступ.

Например, если вы выполните аутентификацию со всеми следующими областями действия:

https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.memberships.readonly

Сервер MCP универсального поиска будет выполнять поиск в Gmail, Google Диске, Google Календаре и Google Chat.

Однако если вы не укажете https://www.googleapis.com/auth/gmail.readonly и предоставите доступ только к https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.spaces.readonly и https://www.googleapis.com/auth/chat.memberships.readonly, универсальный поиск будет возвращать результаты только из Google Диска, Google Календаря и Google Chat. Он не ищет по вашей почте и не возвращает результаты из Gmail.

В консоли Google Cloud перейдите в раздел Google Auth Platform (Платформа Google Auth) > Data Access (Доступ к данным).
Нажмите Добавить или удалить области действия.
Добавьте одну или несколько из следующих областей действия:
- https://www.googleapis.com/auth/gmail.readonly
- https://www.googleapis.com/auth/drive.readonly
- https://www.googleapis.com/auth/calendar.readonly
- https://www.googleapis.com/auth/chat.messages.readonly
- https://www.googleapis.com/auth/chat.spaces.readonly
- https://www.googleapis.com/auth/chat.memberships.readonly
Включите https://www.googleapis.com/auth/chat.spaces.readonly и https://www.googleapis.com/auth/chat.memberships.readonly, чтобы сервер мог определить, кто участвует в каждом чате Google Chat. Без них результаты Google Chat будут считаться внешними и могут требовать подтверждения пользователя или отфильтровываться.
Нажмите Обновить, а затем – Сохранить.

Подробные инструкции по настройке окна запроса доступа приведены в статье Как настроить MCP-серверы Google Workspace.

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

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

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

Antigravity

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

Создайте идентификатор клиента OAuth 2.0 и секретный код типа Веб-приложение. В разделе Разрешенные URI перенаправления нажмите + Добавить URI и в поле URI введите https://antigravity.google/oauth-callback. Выберите Использовать этого клиента для агента на основе искусственного интеллекта. Инструкции приведены в статье Как настроить MCP-серверы Google Workspace.
Откройте или создайте файл конфигурации ~/.gemini/config/mcp_config.json.
Добавьте конфигурацию workspace-universal в mcp_config.json:
```
{
  "mcpServers": {
    "workspace-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}
```
Замените следующее:
- OAUTH_CLIENT_ID – созданный вами идентификатор клиента.
- OAUTH_CLIENT_SECRET – секретный код клиента, который вы создали.
Экономите mcp_config.json.
Выполните аутентификацию MCP-сервера. Вы можете выполнить аутентификацию с помощью графического интерфейса пользователя или интерфейса командной строки.
- Для Antigravity IDE или GUI (Antigravity 2.0):
  1. Откройте экран настроек (например, нажмите Settings (Настройки) в левом нижнем углу или откройте Antigravity User Settings (Пользовательские настройки Antigravity)).
  2. Перейдите в раздел Настройки.
  3. В разделе Установленные MCP-серверы нажмите Обновить.
  4. Найдите в списке workspace-universal, нажмите Authenticate (Аутентификация), войдите в аккаунт Google, скопируйте код авторизации, вставьте его в диалоговое окно и нажмите Submit (Отправить).
- Для Antigravity CLI:
  1. Запустите Antigravity CLI:
```
agy
```
  2. Откройте интерактивную панель управления MCP, выполнив следующую команду:
```
/mcp
```
  3. С помощью клавиш со стрелками выберите workspace-universal, перейдите к действию Аутентификация и нажмите Ввод. Выполните вход в браузере, скопируйте код авторизации, вставьте его в командную строку терминала и нажмите Ввод.
Убедитесь, что сервер правильно настроен и работает:
- В Antigravity IDE или графическом интерфейсе пользователя. Кнопка Выйти показывается рядом с workspace-universal в разделе Customizations (Настройки) > Installed MCP Servers (Установленные MCP-серверы).
- Для Antigravity CLI. Откройте панель /mcp, чтобы посмотреть настроенные серверы MCP. Рядом с названиями проверенных и аутентифицированных серверов на интерактивной панели TUI будет указано Authed. Вы можете выбрать сервер workspace-universal на панели управления, чтобы проверить его статус и посмотреть список доступных инструментов.

Claude

Чтобы добавить MCP-сервер Universal Search в Claude, настройте собственный коннектор.

Создайте идентификатор клиента OAuth 2.0 и секретный код типа Веб-приложение и выберите Использовать этот клиент для агента на основе искусственного интеллекта. Инструкции приведены в статье Как настроить MCP-серверы Google Workspace.
В настройках Claude добавьте пользовательский коннектор:
- Имя сервера: Universal Search MCP Server.
- URL удаленного MCP-сервера: https://workspacemcp.googleapis.com/mcp/v1
- Идентификатор клиента OAuth и Секретный код клиента OAuth – введите свои учетные данные.
- Области действия. Добавьте https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.spaces.readonly и https://www.googleapis.com/auth/chat.memberships.readonly.

Как протестировать MCP-сервер универсального поиска

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

"Найди все, что связано с проектом X, в моих письмах, документах и сообщениях чата".
"Когда у меня следующая встреча по маркетинговому плану и какие последние заметки и сообщения в чате по этой теме?"

Если инструменты выполняются успешно и вы получаете релевантные ответы от нескольких продуктов, значит MCP-сервер Universal Search настроен правильно.

Поддерживаемые инструменты

MCP-сервер Universal Search предлагает следующий инструмент. Схемы ввода и вывода приведены в справочнике по MCP-серверу универсального поиска.

search_corpus выполняет поиск по нескольким продуктам Google Workspace, включая Диск, Gmail, Календарь и Chat, на основе предоставленного запроса.