Серверы Google Workspace MCP в режиме антигравитации

1. Введение

Примечание: Используете Gemini CLI? Тогда перейдите к этому руководству . Данное руководство относится специально к Antigravity.

В этом практическом занятии вы узнаете, как использовать протокол контекста модели (MCP) для подключения Antigravity к данным вашей рабочей области Google . MCP — это открытый стандарт, позволяющий моделям ИИ безопасно использовать инструменты, предоставляемые удаленными серверами. Вы настроите Antigravity для взаимодействия с Gmail, Google Drive, Google Calendar, Google Chat и People API без написания какого-либо кода!

Что вы будете делать

• Включите сервисы Google Workspace MCP в своем проекте Google Cloud.
• Настройте Antigravity для доступа к этим сервисам MCP.
• Протестируйте интеграцию с помощью забавных и полезных подсказок , взаимодействующих с данными вашего Google Workspace.

Что вам понадобится

• Веб-браузер, например Chrome.
• Проект Google Cloud
• Учетная запись Google Workspace
• Антигравитация, установленная на вашем локальном компьютере.

Удобный доступ к этому практическому занятию.

2. Прежде чем начать

Программа предварительного просмотра Google Workspace для разработчиков: доступ к серверам Google Workspace MCP предоставляется в рамках программы предварительного просмотра для разработчиков. Если вы еще этого не сделали, пожалуйста, зарегистрируйтесь и убедитесь, что ваша учетная запись принята в программу по адресу https://developers.google.com/workspace/preview .

Создайте или выберите проект Google Cloud.

В консоли Google Cloud выберите или создайте проект Google Cloud .

Включите API

Для использования серверов Google Workspace MCP необходимо включить стандартные API Google Workspace. Хотя некоторые серверы MCP работают независимо, для других по-прежнему требуется включение базового стандартного API:

• Gmail и Chat по-прежнему требуют использования стандартных API.
• Для работы некоторых инструментов Drive требует использования стандартного API.
• Для работы календаря не требуется включать стандартный API.
• API для работы с пользователями обрабатывает как стандартный доступ, так и функциональность MCP, поэтому для его активации не требуется отдельная служба MCP.

Включите API

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

Далее включите выделенные службы MCP для продуктов.

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

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

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

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

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

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

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

Серверы Google Workspace MCP используют OAuth 2.0 для безопасной аутентификации. Вам необходимо настроить экран согласия OAuth и создать клиентское веб-приложение.

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

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

1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Брендинг . Нажмите «Начать», если настройка еще не выполнена.
2. Настройка информации о приложении :
   • Название приложения : Google Workspace MCP Servers
   • Адрес электронной почты службы поддержки пользователей : выберите свой адрес электронной почты.
3. Настройка аудитории : выберите «Внутренняя» (или «Внешняя» , если параметр «Внутренняя» недоступен).
4. Настройка контактной информации : Введите свой адрес электронной почты.
5. Ознакомьтесь с Политикой обработки пользовательских данных и примите ее условия, затем нажмите «Создать» .
6. Если вы выбрали «Внешние» , перейдите в раздел «Аудитория» и добавьте свой адрес электронной почты в поле «Тестовые пользователи» .
7. Перейдите в раздел «Доступ к данным» > «Добавить или удалить области действия» . В разделе «Добавить области действия вручную» укажите следующие серверы, которые вы хотите использовать:
   • Календарь Google : https://www.googleapis.com/auth/calendar.calendarlist.readonly , https://www.googleapis.com/auth/calendar.events.freebusy , https://www.googleapis.com/auth/calendar.events.readonly
   • Google Чат : 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.users.readstate.readonly
   • Google Диск : https://www.googleapis.com/auth/drive.readonly , https://www.googleapis.com/auth/drive.file
   • Gmail : https://www.googleapis.com/auth/gmail.readonly , https://www.googleapis.com/auth/gmail.compose
   • API для работы с пользователями : https://www.googleapis.com/auth/directory.readonly , https://www.googleapis.com/auth/userinfo.profile , https://www.googleapis.com/auth/contacts.readonly
8. Нажмите «Добавить в таблицу» , затем «Обновить» и, наконец, «Сохранить» .

Создайте идентификатор клиента OAuth.

1. Перейдите в Google Auth Platform > Клиенты > Создать клиента .
2. В качестве типа приложения выберите «Веб-приложение» .
3. Назовите это Antigravity .
4. В разделе «Авторизованные URI перенаправления» нажмите « + Добавить URI» , затем введите https://antigravity.google/oauth-callback .
5. Нажмите «Создать» и скопируйте идентификатор клиента (Client ID) и секретный ключ клиента (Client Secret ). Они понадобятся вам на следующем шаге.

4. Настройка антигравитации

Теперь давайте настроим Antigravity для использования этих конечных точек. Если у вас не установлен Antigravity, следуйте инструкциям по установке на веб-сайте Antigravity .

Добавить пользовательские серверы MCP

1. Откройте серверы MCP через выпадающее меню " ..." в верхней части панели агента редактора.

2. Нажмите «Управление серверами MCP» , затем «Просмотр необработанной конфигурации» .

4. Измените открытый файл mcp_config.json , добавив в него следующую пользовательскую конфигурацию сервера MCP. Перед этим замените заполнители <YOUR_CLIENT_ID> и <YOUR_CLIENT_SECRET> на идентификатор клиента OAuth и секретный ключ, созданные вами на предыдущих шагах:

{
  "mcpServers": {
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

5. Вернитесь к разделу «Управление серверами MCP» , затем нажмите «Обновить» .

Аутентификация пользовательских серверов MCP

1. Откройте пользовательские настройки Antigravity через выпадающее меню настроек редактора в верхней части окна.

2. Перейдите в раздел «Настройки» .

3. Для каждого сервера, указанного в разделе «УСТАНОВЛЕННЫЕ СЕРВЕРЫ MCP» :
   1. Нажмите «Аутентифицировать» .

2. Пройдите процедуру аутентификации в открывшемся новом окне браузера.
3. После завершения нажмите кнопку «Скопировать в буфер обмена» .

4. Закройте окно браузера.
5. Вставьте скопированный вами код авторизации в текстовое поле, отображаемое в настройках Antigravity.
6. Нажмите «Отправить» .

5. Инструменты тестирования

Теперь вы можете взаимодействовать с данными Google Workspace, используя естественный язык. Вот несколько примеров запросов для каждой службы.

Примечание: Замените заключенные в скобки заполнители в приведенных ниже подсказках (например, [NAME] , [FILE_NAME] ) фактическими значениями из ваших собственных данных Google Workspace.

Календарь Google

Попробуйте поискать в своем расписании:

• «Какие у меня запланированы встречи на этой неделе?»
• «У меня будет свободное время завтра после обеда?»

Google Чат

Попробуйте выполнить поиск сообщений:

• "Ищите сообщения, содержащие '[КЛЮЧЕВОЕ СЛОВО]' в '[НАЗВАНИЕ ПРОСТРАНСТВА]'"

Google Диск

Попробуйте выполнить поиск или чтение файлов:

• "Найдите на моем Google Диске файлы, содержащие '[КЛЮЧЕВОЕ СЛОВО]'."
• «Перечислите документы, которые я редактировал в последнее время».
• «Прочитайте содержимое моего документа '[FILE_NAME]' и кратко изложите его основные цели».

Гмайл

Попробуйте выполнить поиск или управление электронной почтой:

• «Кратко изложите содержание последних 5 полученных мною писем».
• Составьте электронное письмо на адрес '[EMAIL_ADDRESS]' с просьбой предоставить обновленную информацию о проекте '[PROJECT_NAME]'.

API для работы с людьми

Попробуйте выполнить поиск в своем профиле или в контактах:

• «Согласно моему профилю в Google, как меня зовут?»
• "Найдите контактную информацию для '[ИМЯ]'."

Объединение нескольких сервисов

Истинная мощь MCP проявляется при координации задач между несколькими сервисами. Попробуйте эти примеры, демонстрирующие возможности межсервисного взаимодействия:

• «Найдите в Google Диск файлы, относящиеся к обновлениям этапов проекта [PROJECT_NAME], кратко опишите их содержимое, найдите адрес электронной почты [NAME] и создайте черновик письма в Gmail с этим кратким описанием».

Изучите другие инструменты

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

6. Уборка

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

1. В консоли Google Cloud перейдите на панель управления API и сервисами .
2. Щелкните по каждому из включенных вами API Google Workspace и MCP (например, Calendar MCP, Chat MCP) и нажмите «Отключить API» .

Удалите учетные данные клиента OAuth в консоли платформы Google Auth, если вы больше не планируете их использовать.

7. Поздравляем!

Поздравляем! Вы успешно настроили и протестировали официальные серверы Google Workspace MCP с помощью Antigravity.

Справочная документация

• Введение в протокол контекста модели (MCP)
• Настройка серверов Google Workspace MCP
• Настройка согласия OAuth
• Редактор Antigravity: интеграция MCP