Эта страница переведена с помощью Cloud Translation API.

Позвольте агентам ИИ осуществлять поиск по всему рабочему пространству с помощью сервера универсального поиска MCP для рабочего пространства.

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

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

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

Проект Google Cloud. Чтобы создать проект, см. раздел «Создание проекта» .
Клиент MCP, например, Google Antigravity .
Для выполнения команд, описанных на этой странице, настройте интерфейс командной строки gcloud в одной из следующих сред разработки:
Облачная оболочка
Чтобы использовать онлайн-терминал с уже настроенным интерфейсом командной строки gcloud, активируйте Cloud Shell:
Активировать Cloud Shell
Локальная оболочка
Для использования локальной среды разработки выполните следующие действия:
1. Установите Google Cloud CLI . Если вы ранее устанавливали gcloud CLI, убедитесь, что у вас установлена последняя версия, выполнив команду gcloud components update .
2. Если вы используете внешнего поставщика идентификации (IdP), войдите в CLI gcloud, используя свою федеративную идентификацию. Для получения дополнительной информации см. раздел «Вход в CLI gcloud с использованием вашей федеративной идентификации» .
3. Инициализируйте интерфейс командной строки gcloud .

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

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

Включите API

Для использования сервера Universal Search MCP Server включите API Google Workspace MCP и API для продуктов, которые вы хотите искать в своем проекте Google Cloud:

API Gmail
API Google Drive
API календаря Google
API чата Google
API Google Workspace MCP

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
workspacemcp.googleapis.com --project=PROJECT_ID

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

Консоль

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

Включите API

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

Если вы уже настроили экран согласия OAuth для других серверов MCP, убедитесь, что вы добавили необходимые области действия для сервера Universal Search 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

Сервер Universal Search MCP Server будет осуществлять поиск по Gmail, Google Drive, Google Calendar и 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 Drive, Google Calendar и Google Chat. Он не будет искать в вашей электронной почте и не будет возвращать результаты из Gmail.

В консоли Google Cloud перейдите в раздел Google Auth Platform > 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
Нажмите «Обновить» , а затем «Сохранить» .

Подробные инструкции по настройке экрана согласия см. в разделе «Настройка серверов Google Workspace MCP» .

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

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

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

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

Создайте идентификатор клиента и секретный ключ OAuth 2.0 типа «Веб-приложение» . В разделе «Авторизованные URI перенаправления» нажмите « + Добавить URI» , а затем добавьте https://antigravity.google/oauth-callback в поле «URI» . Инструкции см. в разделе «Настройка серверов Google Workspace MCP» .
Откройте или создайте конфигурационный файл ~/.gemini/antigravity/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 »).
  2. Перейдите в раздел «Настройки» .
  3. В разделе «Установленные серверы MCP» нажмите «Обновить» .
  4. Найдите workspace-universal в списке, нажмите «Аутентифицировать» , войдите в свою учетную запись Google, скопируйте код авторизации, вставьте его в диалоговое окно ввода и нажмите «Отправить» .
- Для интерфейса командной строки Antigravity:
  1. Запуск интерфейса командной строки Antigravity:
```
agy
```
  2. Откройте интерактивную панель управления MCP, выполнив следующую команду:
```
/mcp
```
  3. С помощью клавиш со стрелками выберите workspace-universal , перейдите к действию «Аутентификация» и нажмите Enter . Завершите процесс входа в систему в браузере, скопируйте код авторизации, вставьте его в командную строку терминала и нажмите Enter .
Убедитесь, что сервер правильно настроен и запущен:
- Для Antigravity IDE или GUI: кнопка «Выход» отображается рядом с workspace-universal в разделе «Настройки» > «Установленные серверы MCP» .
- Для Antigravity CLI: Откройте панель /mcp , чтобы просмотреть настроенные серверы MCP. Проверенные и аутентифицированные серверы отображаются как «Authented» рядом со своими именами в интерактивной панели TUI. Вы можете выбрать сервер workspace-universal в панели мониторинга, чтобы проверить его состояние и получить список всех доступных инструментов.

Клод

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

Создайте идентификатор клиента и секретный ключ OAuth 2.0 типа «Веб-приложение» . Инструкции см. в разделе «Настройка серверов Google Workspace MCP» .
В настройках 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, в своей электронной почте, документах и сообщениях чата».
«Когда состоится моя следующая встреча по маркетинговому плану, и какие последние заметки и сообщения в чате по этому поводу?»

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

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

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

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

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

Облачная оболочка

Локальная оболочка

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

Включите API

CLI

Консоль

Настройте экран согласия OAuth.

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

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

Клод

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

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