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

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

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

Сервер MCP универсального поиска предоставляет ИИ-агентам стандартизированный способ поиска информации во всем аккаунте 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-сервера универсального поиска.

При аутентификации на 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

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

Однако если вы предоставите доступ только к 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/gmail.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
Нажмите Обновить, а затем – Сохранить.

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

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

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

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. Откройте экран настроек (например, нажмите Настройки в левом нижнем углу или откройте 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 в разделе Настройки > Установленные 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.

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

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

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

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

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

MCP-сервер Universal Search предлагает следующий инструмент:

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