Начните работу с Google Workspace MCP и Gemini CLI.

1. Введение

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

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

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

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

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

Выполнение этого практического задания займет приблизительно 30 минут.

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

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. Назовите его Gemini CLI .
4. Нажмите «Создать» и скопируйте идентификатор клиента (Client ID) и секретный ключ клиента (Client Secret ). Они понадобятся вам на следующем шаге.

4. Настройка Gemini CLI

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

Требуется локальная среда: не используйте Cloud Shell на этом шаге. Gemini CLI требует наличия локального браузера для аутентификации OAuth. Пожалуйста, используйте терминал на вашем локальном компьютере. Дополнительную информацию см. в разделе «Требования к перенаправлению браузера» .

Создайте файл конфигурации.

Откройте или создайте ~/.gemini/settings.json в своей домашней директории и добавьте следующую конфигурацию. Замените заполнители вашими учетными данными OAuth.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. Аутентификация и проверка серверов MCP.

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

Запуск Gemini CLI

Для запуска Gemini CLI выполните следующую команду в терминале:

gemini

Аутентификация

Для аутентификации в тестируемых сервисах выполните соответствующую команду в интерфейсе командной строки Gemini. Аутентификация необходима только для тех сервисов, которые вы планируете использовать в этом практическом задании.

Календарь

/mcp auth calendar

Чат

/mcp auth chat

Водить машину

/mcp auth drive

Гмайл

/mcp auth gmail

Люди

/mcp auth people

Следуйте инструкциям в вашем браузере, чтобы авторизовать каждую службу.

Проверить соединение

Убедитесь, что инструменты загружены и готовы к работе:

/mcp list

Вы должны увидеть сообщение о том, что службы Ready , со списком соответствующих инструментов.

6. Тестирование серверов MCP

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

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

Календарь Google

Попробуйте спросить у Близнецов о вашем расписании:

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

Google Чат

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

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

Google Диск

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

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

Гмайл

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

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

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

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

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

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

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

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

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

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

7. Уборка

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

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

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

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

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

Что вы узнали

• Как включить сервисы Google Workspace MCP в Google Cloud.
• Как настроить OAuth-клиент для MCP.
• Как использовать интерфейс командной строки Gemini для взаимодействия с данными Google Workspace с помощью стандартных инструментов.

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

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