Начало работы с Google Workspace MCP и Gemini CLI

1. Введение

Примечание. Вы все ещё используете Gemini CLI? Чтобы узнать, как настроить MCP-серверы Google Workspace с помощью Antigravity CLI, выполните эту практическую работу. Подробную информацию о переходе можно найти в этой записи блога.

В этой практической работе вы узнаете, как использовать протокол контекста модели (MCP), чтобы подключить Gemini CLI к данным Google Workspace. MCP – это открытый стандарт, который позволяет ИИ-моделям безопасно использовать инструменты, предоставляемые удаленными серверами. Вы будете использовать Gemini CLI в качестве клиента для взаимодействия с Gmail, Google Диском, Google Календарем, Google Chat и People API без написания кода.

Что вам предстоит сделать

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

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

• Браузер, например Chrome.
• Проект Google Cloud.
• аккаунт Google Workspace;
• Gemini CLI, установленный на локальном компьютере.

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

Удобный доступ к практической работе

2. Подготовка

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

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

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

Включение API

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

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

Включение API

Включить сервисы MCP

Затем включите специальные сервисы MCP для продуктов.

Включите сервисы MCP

Как настроить приложение Chat

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

1. В консоли Google Cloud найдите Google Chat API и нажмите Google Chat API > Управление > Конфигурация.Перейти к Google Chat API
2. Настройте приложение Chat:
   • В поле Название приложения введите Chat MCP.
   • В поле Avatar URL (URL аватара) введите https://developers.google.com/chat/images/quickstart-app-avatar.png.
   • В поле Description (Описание) введите Chat MCP server.
   • В разделе Функциональность отключите параметр Включить интерактивные функции.
   • В разделе Журналы выберите Записывать ошибки в журнал.
3. Нажмите Сохранить.

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

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

Как настроить окно запроса доступа OAuth

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

1. В консоли Google Cloud выберите Google Auth Platform (Платформа идентификации Google) > Branding (Брендинг). Если вы ещё не настроили эту функцию, нажмите Начать.
2. Настройте информацию о приложении:
   • Название приложения: Google Workspace MCP Servers
   • User support email (Адрес электронной почты службы поддержки) – выберите свой адрес электронной почты.
3. Настройте Аудиторию: выберите Внутренние (или Внешние, если вариант "Внутренние" недоступен).
4. В разделе Contact Information (Контактная информация) укажите свой адрес электронной почты.
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 Chat: 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
   • People API: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly.
8. Нажмите Добавить в таблицу, затем Обновить и Сохранить.

Как создать идентификатор клиента OAuth

При настройке клиента OAuth 2.0 для MCP-серверов Google Workspace необходимо включить параметр агентной классификации (is_agentic), выбрав Использовать этот клиент для агента на основе искусственного интеллекта. Клиенты OAuth, у которых не включена эта настройка, не смогут вызывать конечные точки MCP Google Workspace.

1. Перейдите в раздел Google Auth Platform (Платформа Google Auth) > Clients (Клиенты) > Create Client (Создать клиента) (или APIs & Services (API и сервисы) > Credentials (Учетные данные) > Create Credentials (Создать учетные данные) > OAuth client ID (Идентификатор клиента OAuth)).
2. В качестве типа приложения выберите Компьютерное приложение.
3. Назовите его Gemini CLI.
4. Выберите Использовать этот клиент для агента на основе искусственного интеллекта, чтобы включить флаг классификации is_agentic для клиента OAuth.
5. Нажмите Create (Создать) и скопируйте Client ID (Идентификатор клиента) и Client Secret (Секретный код клиента). Они понадобятся вам на следующем шаге.

4. Как настроить Gemini CLI

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

Требуется локальная среда. Не используйте Cloud Shell для этого шага. Для аутентификации OAuth в Gemini CLI требуется локальный браузер. Используйте терминал локального компьютера. Подробнее о требованиях к перенаправлению в браузере…

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

Откройте или создайте файл ~/.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 CLI. Вам нужно пройти аутентификацию только в тех сервисах, которые вы планируете использовать в этой практической работе.

Календарь

/mcp auth calendar

Чат

/mcp auth chat

Диск

/mcp auth drive

Gmail

/mcp auth gmail

Участники

/mcp auth people

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

Проверить подключение

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

/mcp list

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

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

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

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

Google Календарь

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

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

Google Chat

Попросите Gemini найти сообщения:

• "Найди сообщения, содержащие [ключевое слово], в чат-группе [название чат-группы]".

Google Диск

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

• "Найди на Google Диске файлы, содержащие [ключевое слово]".
• "Покажи список документов, которые я недавно редактировал".
• "Прочитай документ [название файла] и кратко перескажи основные цели".

Gmail

Попросите Gemini найти письма или выполнить с ними действия:

• "Перескажи последние пять писем, которые я получил".
• "Напиши письмо на адрес [EMAIL_ADDRESS] с просьбой рассказать о ходе проекта [PROJECT_NAME]".

People API

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

• "Как меня зовут согласно моему профилю Google?"
• "Найди контактную информацию пользователя [имя]".

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

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

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

Другие инструменты

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

7. Организовать

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

1. В консоли Google Cloud перейдите на страницу API & Services Dashboard (Панель управления API и сервисами).
2. Нажмите на каждый из включенных API Google Workspace и MCP (например, Calendar MCP, Chat MCP) и выберите Отключить API.

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

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

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

Что вы узнали

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

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

• Общие сведения о Model Context Protocol (MCP)
• Как настроить серверы MCP Google Workspace
• Настройте запрос согласия OAuth