Как настроить MCP-серверы Google Workspace

Google Workspace предлагает удаленные серверы Model Context Protocol (MCP), которые позволяют ИИ-агентам безопасно взаимодействовать с данными Google Workspace. Настроив серверы MCP Google Workspace, вы разрешите ИИ-приложениям, таким как Google Antigravity и Claude, выполнять действия в приложениях Google Workspace, например в Gmail, Google Диске, Google Документах, Google Таблицах, Google Презентациях, Google Календаре, Google Chat и Google Классе. У каждого продукта Google Workspace есть собственный MCP-сервер.

MCP-серверы Google Workspace предоставляют ИИ-агентам стандартизированный способ:

  • Чтение данных. Поиск писем, получение файлов и просмотр списка мероприятий в календаре.
  • Выполнять действия. Создавать черновики писем, загружать файлы и планировать встречи.
  • Безопасность. Наследует те же разрешения и настройки управления данными, что и пользователь.

Требования

Как настроить MCP-серверы Google Workspace

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

Включение API

Чтобы использовать серверы MCP Google Workspace, необходимо включить в облачном проекте Google Cloud следующие API:

  • Gmail API
  • Google Drive API
  • Google Docs API
  • Google Sheets API
  • Google Slides API
  • Google Calendar API
  • Google Chat API
  • People API
  • Google Classroom API

ИКС

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.googleapis.com --project=PROJECT_ID

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

Консоль

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

Как включить API

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

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

  • Gmail MCP API
  • Google Drive MCP API
  • Google Docs MCP API
  • Google Sheets MCP API
  • Google Slides MCP API
  • Google Calendar MCP API
  • Google Chat MCP API
  • People MCP API
  • Google Classroom MCP API

ИКС

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID

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

Консоль

Включите сервисы MCP в консоли Google Cloud:

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

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

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

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

    Перейти к Google Chat API

  2. Настройте приложение Chat:

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

Подробнее о том, как создавать приложения для Chat, см. Как выбрать архитектуру приложения Google Chat.

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

  1. В консоли Google Cloud выберите Google Auth Platform (Платформа Google Auth) > Branding (Брендинг).

    Перейти к брендингу

  2. Если вы уже настроили платформу идентификации Google, то можете задать следующие настройки окна запроса доступа OAuth: Брендинг, Аудитория и Доступ к данным. Если вы видите сообщение Google Auth Platform not configured yet (Платформа Google Auth Platform ещё не настроена), нажмите Get Started (Начать).

    1. В разделе App Information (Информация о приложении) в поле App name (Название приложения) введите Workspace MCP Servers.
    2. В поле Адрес электронной почты службы поддержки выберите свой адрес электронной почты или подходящую группу Google.
    3. Нажмите Далее.
    4. В разделе Аудитория выберите Внутреннее. Если вы не можете выбрать Внутреннее, выберите Внешнее.
    5. Нажмите Далее.
    6. В разделе Контактная информация укажите адрес электронной почты, на который вы хотите получать уведомления об изменениях в проекте.
    7. Нажмите Далее.
    8. В разделе Finish (Завершение) ознакомьтесь с Правилами в отношении пользовательских данных сервисов API Google и, если вы согласны с ними, выберите I agree to the Google API Services: User Data Policy (Я принимаю Правила в отношении пользовательских данных сервисов API Google).
    9. Нажмите Продолжить.
    10. Нажмите Создать.
    11. Если вы выбрали тип пользователя Внешний, добавьте тестовых пользователей:
      1. Нажмите Аудитория.
      2. В разделе Тестовые пользователи нажмите Добавить пользователей.
      3. Введите свой адрес электронной почты и адреса других авторизованных тестовых пользователей, а затем нажмите Сохранить.
  3. Нажмите Доступ к данным > Добавить или удалить области действия. Появится панель со списком областей действия для каждого API, включенного в облачном проекте Google Cloud.

    1. В разделе Добавить области действия вручную вставьте области действия для MCP-серверов, которые хотите использовать:

      • Gmail:
        • https://www.googleapis.com/auth/gmail.readonly
        • https://www.googleapis.com/auth/gmail.compose
      • Google Диск:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
      • Google Документы:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/documents.readonly
        • https://www.googleapis.com/auth/documents
      • Google Таблицы:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/spreadsheets.readonly
        • https://www.googleapis.com/auth/spreadsheets
      • Google Презентации:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/presentations.readonly
        • https://www.googleapis.com/auth/presentations
      • 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.messages.create
        • https://www.googleapis.com/auth/chat.users.readstate
      • People API:
        • https://www.googleapis.com/auth/directory.readonly
        • https://www.googleapis.com/auth/userinfo.profile
        • https://www.googleapis.com/auth/contacts.readonly
      • Google Класс
        • https://www.googleapis.com/auth/classroom.announcements
        • https://www.googleapis.com/auth/classroom.courses.readonly
        • https://www.googleapis.com/auth/classroom.coursework.students
        • https://www.googleapis.com/auth/classroom.courseworkmaterials
        • https://www.googleapis.com/auth/classroom.rosters.readonly
        • https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
        • https://www.googleapis.com/auth/classroom.topics.readonly
    2. Нажмите Добавить в таблицу.

    3. Нажмите Обновить.

    4. Выбрав области действия, необходимые для приложения, на странице Доступ к данным нажмите Сохранить.

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

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

Antigravity

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

  1. Создайте идентификатор клиента и секретный код OAuth 2.0:

    1. В консоли Google Cloud выберите Google Auth Platform (Платформа Google Auth) > Clients (Клиенты) > Create Client (Создать клиента).

      Перейти к созданию клиента

    2. В качестве типа приложения выберите Веб-приложение.

    3. Укажите название.

    4. В разделе Разрешенные URI перенаправления нажмите + Добавить URI и введите https://antigravity.google/oauth-callback в поле URI.

    5. Выберите Использовать этого клиента для агента на основе искусственного интеллекта.

    6. Нажмите Создать и скопируйте идентификатор клиента и секретный код клиента.

  2. Откройте или создайте файл конфигурации ~/.gemini/config/mcp_config.json.

  3. Добавьте конфигурацию mcpServers в mcp_config.json:

    {
      "mcpServers": {
        "gmail": {
          "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "drive": {
          "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "docs": {
          "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "sheets": {
          "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "slides": {
          "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "calendar": {
          "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "chat": {
          "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "people": {
          "serverUrl": "https://people.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "classroom": {
          "serverUrl": "https://classroommcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        }
      }
    }
    

    Замените следующее:

    • OAUTH_CLIENT_ID – созданный вами идентификатор клиента.
    • OAUTH_CLIENT_SECRET – секретный код клиента, который вы создали.
  4. Экономите mcp_config.json.

  5. Выполните аутентификацию MCP-серверов. Вы можете выполнить аутентификацию с помощью настроек графического интерфейса пользователя или интерфейса командной строки.

    • Для Antigravity IDE или GUI (Antigravity 2.0):

      1. Откройте экран настроек (например, нажмите Настройки в левом нижнем углу или откройте Пользовательские настройки Antigravity).
      2. Перейдите в раздел Настройки.
      3. В разделе Установленные MCP-серверы нажмите Обновить.
      4. Для каждого сервера в списке (gmail, drive, docs, sheets, slides, calendar, chat, people и classroom) нажмите Authenticate (Аутентификация), войдите в аккаунт Google, скопируйте код авторизации, вставьте его в диалоговое окно и нажмите Submit (Отправить).
    • Для Antigravity CLI:

      1. Запустите Antigravity CLI:

        agy
        
      2. Откройте интерактивную панель управления MCP, выполнив следующую команду:

        /mcp
        
      3. Выполните аутентификацию каждого MCP-сервера:

        1. С помощью клавиш со стрелками выберите сервер, перейдите к действию Authenticate (Аутентификация) и нажмите Ввод. Выполните вход в браузере, скопируйте код авторизации, вставьте его в командную строку терминала и нажмите Ввод.
        2. Повторите эти действия для каждого настроенного сервера (gmail, drive, docs, sheets, slides, calendar, chat, people и classroom).
  6. Убедитесь, что серверы настроены правильно и работают:

    • Для Antigravity IDE или графического интерфейса пользователя. Кнопка Выйти показывается рядом с каждым сервером в разделе Настройки > Установленные MCP-серверы.
    • Для Antigravity CLI. Откройте панель /mcp, чтобы посмотреть настроенные серверы MCP. Рядом с названиями проверенных и аутентифицированных серверов на интерактивной панели TUI будет указано Authed. Вы можете выбрать любой сервер на панели управления, чтобы проверить его статус и посмотреть список доступных инструментов.

Удаленные MCP-серверы готовы к использованию в Antigravity.

Claude

Чтобы использовать удаленные серверы MCP Google Workspace с Claude.ai или Claude Desktop, у вас должен быть тарифный план Claude Enterprise, Pro, Max или Team.

Чтобы добавить удаленные MCP-серверы Google Workspace в Claude, настройте собственный коннектор с идентификатором клиента OAuth и секретным ключом.

  1. Создайте идентификатор клиента и секретный код OAuth 2.0:

    1. В консоли Google Cloud выберите Google Auth Platform (Платформа Google Auth) > Clients (Клиенты) > Create Client (Создать клиента).

      Перейти к созданию клиента

    2. В качестве типа приложения выберите Веб-приложение.

    3. Укажите название.

    4. В разделе Разрешенные URI перенаправления нажмите + Добавить URI и в поле URI введите https://claude.ai/api/mcp/auth_callback.

    5. Выберите Использовать этого клиента для агента на основе искусственного интеллекта.

    6. Нажмите Создать и скопируйте идентификатор клиента и секретный код клиента.

  2. Настройте MCP-сервер в Claude:

    1. В Claude.ai или Claude Desktop перейдите в Settings (Настройки) (или Admin settings (Настройки администратора)) > Connectors (Коннекторы).
    2. Нажмите Добавить собственный коннектор.
    3. Введите сведения о подключении для продукта Google Workspace, который вы хотите добавить:

      • Имя сервера. Название сервера, например Gmail.
      • URL удаленного MCP-сервера – URL продукта Google Workspace, например один из следующих:
        • Gmail: https://gmailmcp.googleapis.com/mcp/v1
        • Google Диск: https://drivemcp.googleapis.com/mcp/v1
        • Google Документы: https://docsmcp.googleapis.com/mcp/v1
        • Google Таблицы: https://sheetsmcp.googleapis.com/mcp/v1
        • Google Презентации: https://slidesmcp.googleapis.com/mcp/v1
        • Google Календарь: https://calendarmcp.googleapis.com/mcp/v1
        • Google Chat: https://chatmcp.googleapis.com/mcp/v1
        • People API: https://people.googleapis.com/mcp/v1
        • Google Класс: https://classroommcp.googleapis.com/mcp/v1
    4. В разделе Расширенные настройки введите идентификатор клиента OAuth и секретный код клиента OAuth.

    5. Нажмите Добавить.

    6. Повторите эти шаги для каждого продукта Google Workspace, который хотите добавить.

Другое

Многие ИИ-приложения могут подключаться к удаленному MCP-серверу. Обычно требуется ввести сведения о сервере, например его название, конечные точки, транспортный протокол и способ аутентификации. Для удаленных MCP-серверов Google Workspace введите следующее:

  • Имя сервера: googleworkspace.

  • Серверы. У каждого продукта Google Workspace есть собственный URL сервера:

    • Gmail: https://gmailmcp.googleapis.com/mcp/v1
    • Google Диск: https://drivemcp.googleapis.com/mcp/v1
    • Google Документы: https://docsmcp.googleapis.com/mcp/v1
    • Google Таблицы: https://sheetsmcp.googleapis.com/mcp/v1
    • Google Презентации: https://slidesmcp.googleapis.com/mcp/v1
    • Google Календарь: https://calendarmcp.googleapis.com/mcp/v1
    • Google Chat: https://chatmcp.googleapis.com/mcp/v1
    • People API: https://people.googleapis.com/mcp/v1
    • Google Класс: https://classroommcp.googleapis.com/mcp/v1
  • Транспорт: Streamable HTTP

  • Аутентификация. Удаленный сервер MCP Google Workspace использует OAuth 2.0. При создании клиента OAuth 2.0 выберите Использовать этот клиент для агента на основе искусственного интеллекта. Подробнее об аутентификации и авторизации…

    Клиенту MCP нужен токен обновления, чтобы пользователям не приходилось входить в систему примерно каждый час. Сервер OAuth 2.0 от Google выдает токен обновления, только если запрос авторизации содержит access_type=offline. Если запросить только область offline_access OpenID Connect (OIDC), то токен обновления не возвращается. Если ваш клиент MCP поддерживает специальные параметры авторизации, добавьте в запрос авторизации access_type=offline. Чтобы получить новый токен обновления для пользователя, который уже предоставил доступ, также добавьте prompt=consent. Если ваш клиент MCP не поддерживает настраиваемые параметры авторизации, пользователям придется входить в систему заново каждый раз, когда истекает срок действия токена доступа. Подробнее о том, как обновить токен доступа…

Подробнее о подключении клиентов разных типов рассказывается в статье Как настроить MCP в ИИ-приложении.

Протестируйте MCP-серверы Google Workspace

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

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

  • "Что Ариэль написала в последнем письме о нашем маркетинговом плане?"

    Клиент отфильтрует письма от Арины с помощью gmail.search_threads, получит содержимое последней цепочки с помощью gmail.get_thread и создаст для вас краткий пересказ.

  • "Напиши письмо на адрес ariel@example.com о том, что я одобряю маркетинговый план".

    Клиент использует gmail.create_draft, чтобы создать черновик письма, который вы можете проверить и отправить из Gmail.

  • "Обобщи контент файла "Маркетинговый план".

    Клиент вызывает drive.search_files, чтобы найти файл "Маркетинговый план", а затем использует drive.read_file_content, чтобы получить и обобщить его содержимое.

  • "Покажи мне структуру заметок к встрече в Google Документах".

    Клиент получает структуру и содержимое документа с помощью docs.read_doc.

  • "Прочитай лист "Лист1" из таблицы Google "Продажи за квартал".

    Клиент получает значения сетки с помощью sheets.get_values.

  • Покажи мне озвученный макет презентации Google"Обзор продукта".

    Клиент получает структуры визуального контекста презентации с помощью slides.read_presentation.

  • "Когда у меня следующая встреча с Ариной?"

    Клиент проверяет ваше расписание с помощью calendar.list_events и сообщает подробности о вашей следующей встрече с Ариэль.

  • "Как меня зовут согласно профилю Google?"

    Клиент использует people.get_user_profile для получения информации профиля Google Workspace.

  • "Какие курсы я сейчас веду?"

    Клиент проверяет ваше расписание с помощью classroom.list_course_summaries и обобщает информацию об активных курсах, где вы являетесь преподавателем.

  • "Напиши объявление о предстоящей экскурсии для моего курса по геологии".

    Клиент использует classroom.create_announcement для составления объявления, которое вы можете проверить и опубликовать в приложении Google Класс.

Если инструменты выполняются успешно и вы получаете релевантные ответы, значит серверы MCP Google Workspace настроены правильно.

Устранение неполадок

Если у вас возникли проблемы с подключением к MCP-серверам, вы можете проверить журналы OAuth на наличие ошибок. Попросите администратора проверить события в журнале OAuth в инструменте "Анализ безопасности".

Если ваши запросы к серверам MCP отклоняются, убедитесь, что для вашего клиента OAuth 2.0 выбран параметр Использовать этот клиент для агента на основе искусственного интеллекта в разделе Google Auth Platform > Clients (Клиенты). Если вы не можете изменить эту настройку для существующего клиента OAuth, создайте новый клиент OAuth, выбрав Использовать этот клиент для агента на основе искусственного интеллекта, и обновите приложение, чтобы использовать его. Если существующий клиент OAuth используется как для ИИ-агента, так и для других функций, создайте отдельный клиент OAuth для ИИ-агента и оставьте существующий клиент для других функций. Инструкции приведены в статьях Как настроить клиент MCP и Как управлять клиентами OAuth.

Если в вашем приложении используется сервисный аккаунт с делегированием доступа к данным в домене, вы не сможете выбрать для него параметр Использовать этот клиент для агента на основе искусственного интеллекта, поскольку сервисные аккаунты не управляются в разделе Платформа Google Auth > Клиенты. Запросы к MCP-серверам от сервисных аккаунтов, использующих делегирование доступа к данным в домене, не отклоняются по этой причине. Доступ контролируется настройками делегирования доступа к данным в домене, которыми управляет администратор Google Workspace. Подробнее о том, как управлять доступом к API, используя делегирование доступа к данным в домене…

Если вы вызываете серверы MCP из Google Apps Script, Apps Script создает клиент OAuth по умолчанию для вашего скрипта и управляет им, но вы не можете выбрать для него Использовать этот клиент для агента на основе искусственного интеллекта. Это правило действует, даже если в скрипте используется стандартный проект Google Cloud. Вместо этого сделайте следующее:

  1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Clients (Клиенты), создайте клиент OAuth и выберите Use this client for an AI-powered agent (Использовать этот клиент для агента на основе искусственного интеллекта).
  2. В скрипте используйте библиотеку OAuth2 для Apps Script, чтобы авторизовать пользователей с помощью этого клиента OAuth.
  3. При вызове MCP-серверов отправляйте токен доступа, возвращенный библиотекой, а не токен из ScriptApp.getOAuthToken.

Проекты Apps Script, которые не вызывают MCP-серверы, не будут затронуты.

Если вам приходится входить в аккаунт примерно каждый час, значит клиент MCP не получает токен обновления. Сервер Google OAuth 2.0 выдает токен обновления, только если запрос на авторизацию содержит access_type=offline. Если запрашивается только область действия offline_access OpenID Connect (OIDC), то токен не возвращается. Если ваш клиент MCP поддерживает специальные параметры авторизации, добавьте в запрос авторизации access_type=offline. Чтобы получить новый токен обновления для пользователя, который уже предоставил доступ, также добавьте prompt=consent. Если ваш клиент MCP не поддерживает специальные параметры авторизации, вам придется входить в систему каждый раз, когда срок действия токена доступа истекает. Подробнее о том, как обновить токен доступа…

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

Следующие продукты Google Workspace поддерживают серверы MCP Google Workspace и предлагают следующие инструменты:

Важное замечание о безопасности: косвенное внедрение запроса

Если языковая модель получает доступ к ненадежным данным, возникает риск косвенной атаки с внедрением запроса. Поскольку у клиентов MCP, таких как Google Antigravity, есть доступ к мощным инструментам и API через MCP-серверы Google Workspace, они могут читать, изменять и удалять данные в вашем аккаунте Google.

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

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