Tvijo wiki
Каталог

Темы

Google Drive и Workspace MCP: доступ к документам и контроль отправки писем

Официальные и независимые серверы Workspace MCP, OAuth scopes и безопасная работа с документами: отправка писем только после явного подтверждения.

🎯 Для Developers and workspace administrators connecting agents to Drive, Docs or Gmail while controlling data access and outbound email.

📚 Вы узнаете
  • Distinguish official preview servers from community implementations
  • Understand reading, writing and mail-sending scopes
  • Connect an editor client with a retrieval test
  • Keep outbound email behind explicit approval
  • Recognize Tvijo’s documented integration boundaries

Google Drive MCP, Gmail MCP server и Google Workspace MCP дают агенту доступ к данным аккаунта через инструменты; границы доступа определяются авторизацией и выбранным сервером. По состоянию на 30 октября 2026 года у Google есть официальные удалённые серверы для Drive, Docs и Gmail в статусе Developer Preview, а также существуют независимые реализации; официальный вариант описан в руководстве Google. Начинайте с получения контекста из документов, а отправку любого письма допускайте только после явного подтверждения.

Какие серверы существуют

Для каждого приложения Google предоставляет отдельный адрес. Официальные серверы используют Streamable HTTP и OAuth 2.0:

Целевая интеграция Адрес официального сервера
Google Drive https://drivemcp.googleapis.com/mcp/v1
Google Docs https://docsmcp.googleapis.com/mcp/v1
Gmail https://gmailmcp.googleapis.com/mcp/v1

Адреса приведены в документации Google по состоянию на 30 октября 2026 года. Для подключения требуется доступ к Developer Preview: наличие адреса ещё не означает, что сервис доступен любому аккаунту.

Из независимых решений можно рассмотреть taylorwilsdon/google_workspace_mcp. В репозитории описаны поддержка Gmail, Drive и Docs, локальная работа через stdio, удалённая работа через Streamable HTTP и режим только для чтения. Это проект стороннего разработчика. Отдельно оцените выбранный выпуск, зависимости и хранение учётных данных: название приложения не показывает, кто управляет сервером.

Основы изложены в статье что такое MCP. Другие варианты собраны в категории MCP-серверы для приложений.

Что можно делать

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

Официальный сервер Docs позволяет читать текст и структуру документа, а также менять структуру и оформление. Для начала лучше получить локальный список требований. Изменение общего документа оформляйте как отдельное разрешённое действие.

Для почты можно спроектировать процесс, в котором агент кратко излагает разрешённую переписку и готовит ответ на проверку. Заранее выберите, останется ли ответ локальным текстом или станет черновиком в Gmail: создание черновика уже меняет удалённые данные. Ни один из этих вариантов не должен подразумевать разрешение на отправку.

Что разрешают OAuth scopes

Scope задаёт границу полномочий. Список доступных инструментов и условия задачи должны дополнительно ограничивать рабочий процесс. Ниже — значения scopes по документации на 30 октября 2026 года. Полный адрес каждого складывается из https://www.googleapis.com/auth/ и указанного суффикса.

Суффикс scope Значение и практическое следствие
drive.readonly Просмотр и скачивание файлов Drive; чтение тоже может раскрыть чувствительные данные.
drive.file Создание файлов и изменение файлов, открытых через приложение или предоставленных ему; это доступ с возможностью записи.
gmail.readonly Чтение сообщений и настроек.
gmail.compose Управление черновиками и отправка писем.
gmail.send Отправка писем от имени пользователя.

Определения приведены в таблицах Drive и Gmail. Если вместе с drive.file выдан drive.readonly, доступ на чтение не сужается до отдельных выбранных файлов.

В инструкции Docs MCP перечислены drive.readonly, drive.file, documents.readonly и documents. Сопоставляйте запрашиваемые разрешения с нужными инструментами. Полная инструкция подключения сама по себе не обеспечивает режим только для чтения; поддерживаемую комбинацию уточняйте в актуальной документации.

Почему отправку письма нужно подтверждать

Граница между подготовкой и отправкой должна обеспечиваться технически. Таблица scopes Gmail подтверждает: gmail.compose разрешает отправлять письма, поэтому считать его разрешением только на черновики нельзя. Наличие отправки среди инструментов зависит и от конкретного сервера.

Рекомендуемое правило: исходящие письма никогда не отправляются автоматически. Во время поиска и чтения инструменты отправки должны быть недоступны. Если отправка понадобится позже, непосредственно перед ней человек подтверждает аккаунт отправителя, поля To/Cc/Bcc, тему, текст и вложения. Любое изменение требует нового подтверждения.

В документе или письме могут оказаться инструкции злоумышленника для агента. Google прямо предупреждает об этом в рекомендациях по безопасности Docs. Полученный текст — источник сведений, а не разрешение кому-либо написать. Если отправка завершилась тайм-аутом, сначала проверьте состояние почты: повторное действие может создать дубликат. Эти правила стоит включить в свой чек-лист безопасности MCP.

Как подключить безопасно

  1. Выберите реализацию и аккаунт. Зафиксируйте, используется ли официальный удалённый сервер Google или конкретный сторонний репозиторий. Начните с разрешённого тестового аккаунта и несекретных документов. До входа определите задачу, допустимое чтение и запрещённые изменения.
  2. Подготовьте условия для официального сервера. Понадобятся доступ к Developer Preview и проект Google Cloud. Включите API нужного приложения и соответствующий MCP-сервис, затем настройте OAuth consent. Требования описаны в инструкции Drive. Учётные данные клиента и адрес возврата должны соответствовать выбранному клиенту. Секреты нельзя помещать в чат или систему контроля версий.
  3. Проверьте реальные полномочия. Сверьте запрос согласия, инструменты и аккаунт. Запрашивайте минимально необходимые поддерживаемые разрешения. Если сервер требует слишком широкого доступа, используйте разрешённый экспорт документа. Для независимой реализации в репозитории описан параметр --read-only; проверьте его действие до работы с настоящими данными.
  4. Добавьте сервер в редактор. В совместимом сеансе агента VS Code откройте Command Palette и выполните MCP: Add Server. Для удалённого адреса выберите HTTP, для проверенной локальной команды — Command (stdio). Следуйте инструкции авторизации разработчика и проверяйте запросы доверия. Этот порядок описан в руководстве VS Code. Добавленная конфигурация ещё не подтверждает совместимость выбранного клиента с Google OAuth.
  5. Проверьте получение данных. Запросите известный тестовый документ, раскройте вызов инструмента и изучите результат. Сравните пересказ с оригиналом. Убедитесь, что использованы нужные аккаунт и сервер, а изменение данных и отправка писем не выполняются без участия человека.
  6. Закрепите порядок подтверждения. Для исходящих писем оставьте описанную выше проверку либо отправляйте их вручную в Gmail. Фиксируйте разрешённые действия и результаты, не копируя в журналы секреты и лишний текст документов. Статья о разрешениях и передаче данных поможет определить, что покидает рабочую станцию.

Когда это не работает

Файл может открываться в браузере Drive, но отсутствовать в результатах MCP. По правилам доступности файлов исключаются объекты с соответствующими запретами скачивания, копирования и печати, клиентским шифрованием и другими ограничениями. Может влиять и Context Aware Access. Поиск отфильтровывает недоступные объекты, а обращение к конкретному файлу может вернуть ошибку. Расширение OAuth scopes не устраняет такие ограничения.

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

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

Где здесь Tvijo

По состоянию на 30 октября 2026 года DSHREM — расширение для VS Code позволяет начинать задачи из редактора с выделенным или прикреплённым контекстом. Практический процесс для Workspace можно организовать так: получить разрешённый документ через отдельно настроенный коннектор, проверить нужный фрагмент и приложить его к ограниченной задаче Tvijo. Это предлагаемый рабочий процесс, а не заявление о готовой встроенной интеграции Google Workspace.

TvijoCode — тестовая сборка на основе Code - OSS со встроенным расширением Tvijo. Tvijo MCP делает Tvijo доступным для вызова из совместимого MCP-клиента; интеграция с редактором и делегирование описаны в датированной документации как планируемые этапы. Установка не даёт Tvijo автоматического управления другим Workspace MCP-сервером. Контекст документов и право отправки остаются разными разрешениями: в рекомендуемом здесь процессе исходящие письма никогда не отправляются автоматически.

В рабочем пространстве Tvijo по состоянию на 30 октября 2026 года Try стоит $0: до 5 задач, 50 000 токенов или $0.05 спонсируемого использования — до достижения первого из этих пределов. Используется общий суточный пул $1, финансируемый TVIJO. Service credit показан за $10 как запрос предоплаченного кредита: учитывается фактическое использование провайдеров плюс сервисная наценка 8%. Приём платежей не активирован; заказ не означает списание денег. Эти предложения не подтверждают доступность интеграции Workspace.

Частые вопросы

Есть ли официальный Google Drive MCP server?

Да. На 30 октября 2026 года удалённый сервер Google Drive находится в Developer Preview. Перед подключением уточните условия доступа и настройки в официальном руководстве по ссылке выше.

Запрещает ли gmail.compose отправлять письма?

Нет. Этот scope включает отправку. Ограничьте инструменты и требуйте подтверждения окончательного письма либо отправляйте его вручную.

Подключится ли Gmail после установки Tvijo MCP?

Установка этого не обеспечивает. Настройте доступ к Workspace отдельно и передавайте только разрешённый контекст задачи. Наличие нужного коннектора уточняйте в документации продукта.

Google Workspace (Drive, Docs, Gmail) — товарный знак правообладателя. Tvijo не связан с ним и не одобрен им.

Источники

Ниже указаны источники и даты наблюдений. Статус проверки отмечен для каждого материала.

  1. Configure the Google Workspace MCP servers · Проверено 2026-10-30 · Official remote servers, Developer Preview status, separate endpoints, transport and OAuth configuration.
  2. Configure the Drive MCP server · Проверено 2026-10-30 · Official Drive capabilities, preview prerequisites, product API and MCP service enablement, and OAuth setup.
  3. Configure the Docs MCP server · Проверено 2026-10-30 · Document reading and updates, documented OAuth scopes, and indirect prompt injection guidance.
  4. Choose Google Drive API scopes · Проверено 2026-10-30 · Meanings of drive.readonly and drive.file, and the recommendation to request narrow scopes.
  5. Choose Gmail API scopes · Проверено 2026-10-30 · Meanings of gmail.readonly, gmail.compose and gmail.send; composing permission includes sending.
  6. Drive MCP file eligibility · Проверено 2026-10-30 · IRM, Context Aware Access and encryption restrictions; filtering of ineligible files and direct-operation errors.
  7. Add MCP servers in VS Code · Проверено 2026-10-30 · MCP: Add Server flow, HTTP and stdio choices, trust review, tool-result verification and troubleshooting.
  8. taylorwilsdon/google_workspace_mcp repository · Проверено 2026-10-30 · Community-maintained Workspace server, supported applications, transports and documented read-only option.

Связи опубликованных статей. Выберите узел, чтобы открыть статью у заголовка.

100%
→ Связанные статьи← Ссылаются сюда⋯ Та же тема
Связи статей · клавиатура / текст

💬 Комментарии

Комментарии публичны и модерируются. Не публикуйте персональные данные.
  • Комментариев пока нет. Будьте первым!

Следующие шаги

MCP-серверы для популярных сервисов

Microsoft 365 и MCP: почта, файлы и Teams как контекст, отправка — вручную

Как подключить контекст Microsoft 365 через Work IQ MCP, проверить разрешения Graph и согласие администратора, сохранив отправку сообщений за человеком.

MCP-серверы для популярных сервисов

AWS MCP servers: документация, расходы и безопасные вопросы об инфраструктуре

Как выбрать AWS MCP server для документации и расходов, ограничить доступ через IAM и исключить изменения production из запуска агента.

MCP-серверы для популярных сервисов

MCP-серверы Cloudflare: сначала проверка, затем согласование изменений

Как выбрать MCP-сервер Cloudflare, подключить поиск документации и ограничить доступ к аккаунту, оставив изменения DNS и firewall под контролем человека.

MCP-серверы для популярных сервисов

Sentry MCP: разобрать ошибку production и предложить исправление

Как подключить Sentry MCP через OAuth, проверить диагностику и воспроизвести сбой до ревью патча. Риски передачи данных и роль Tvijo.