Обзор инструментов Drive MCP для ИИ-агентов
Обзор 42 инструментов TrekMail Drive MCP для ИИ-агентов: загрузка, публичные ссылки, массовые операции, безопасное удаление и доступ на чтение.
Сведения о статье
Тип, сложность, тарифы и дата последнего обновления.
▼
Сведения о статье
Тип, сложность, тарифы и дата последнего обновления.
- Тип
- Справочная статья
- Сложность
- Средний уровень
- Тарифы
- Starter · Pro · Agency · + Drive Add-on
- Обновлено
- 10 сен 2026 г.
Сервер TrekMail MCP предоставляет ИИ-агентам TrekMail в виде структурированных инструментов для хранения файлов, создания общедоступных ссылок, безопасной очистки и управления паролями устройств синхронизации. Подключение видит только инструменты, разрешённые его учётными данными, выбранными наборами инструментов, транспортом и механизмами безопасности. Проверяйте список доступных агенту инструментов, а не полагайтесь на фиксированное количество в каталоге.
Для агентов MCP обычно проще прямых запросов REST. Вместо того чтобы просить агента формировать HTTP-запросы, вы предоставляете ему такие инструменты, как drive_file_upload, drive_share_create или drive_bulk_move. При этом API продолжает в фоновом режиме контролировать права токена, идемпотентность, журналирование аудита и механизмы безопасности.
Охват инструментов
| Группа инструментов | Инструменты | Возможности агентов |
|---|---|---|
| Пространства и использование | drive_spaces_list, drive_storage_summary, drive_space_usage |
Находить Drive аккаунта, разрешённые пространства почтовых ящиков и состояние квоты |
| Просмотр и выбор | drive_browse_folder, drive_folder_tree, drive_select_all_ids |
Перемещаться по папкам и безопасно готовить массовые операции |
| Файлы | drive_file_get, drive_file_download_url, drive_file_rename, drive_file_move, drive_file_trash, drive_file_restore, drive_file_purge |
Читать метаданные, скачивать, переименовывать, перемещать, отправлять в корзину, восстанавливать или безвозвратно удалять файл |
| Папки | drive_folder_create, drive_folder_update, drive_folder_move, drive_folder_trash, drive_folder_restore, drive_folder_purge |
Создавать деревья папок и управлять ими |
| Общий доступ для команды | drive_folder_share_with_account, drive_folder_stop_sharing |
Делать папку верхнего уровня видимой всем почтовым ящикам или прекращать доступ на уровне аккаунта |
| Корзина | drive_trash_list, drive_trash_empty |
Просматривать корзину или безвозвратно очищать её, если включён механизм разрушительных операций |
| Массовые операции | drive_bulk_trash, drive_bulk_restore, drive_bulk_move, drive_bulk_purge |
Перемещать, отправлять в корзину, восстанавливать или безвозвратно удалять до 5 000 выбранных элементов |
| Общедоступные ссылки | drive_share_create, drive_share_list, drive_share_revoke |
Создавать ограниченные по сроку или количеству скачиваний ссылки и впоследствии отзывать их |
| Загрузка | drive_file_upload, drive_upload_initiate, drive_upload_complete, drive_upload_refresh_parts, drive_upload_abort |
Загружать локальные файлы через простую обёртку или вручную управлять многочастным процессом |
| Состояние дополнения | drive_addon_get, drive_addon_pricing, drive_addon_cancellation_preview |
Читать состояние и цену дополнения для хранилища, не изменяя биллинг |
| Устройства синхронизации | drive_device_list, drive_device_create, drive_device_revoke, drive_device_rotate |
Создавать, проверять, отзывать или менять отдельный пароль для приложения синхронизации WebDAV |
Требования к токену
Инструменты Drive MCP используют переменную среды для операционного токена:
TREKMAIL_API_TOKEN=tm_live_your_token
Токен должен включать соответствующие права Drive. Например, drive_share_create требует права на общий доступ для пространства Drive, в котором находится файл. Для drive_file_purge нужны право на безвозвратное удаление и включённый механизм разрушительных инструментов. Инструментам для устройств синхронизации требуется drive:devices:read или drive:devices:write; созданный пароль устройства показывается только один раз. Их ответы содержат правильный server_url, включая брендированный адрес DAV только после готовности его сертификата и ограниченного хоста.
Инструменты Drive можно использовать вместе с инструментами сообщений, дополнительно предоставив TREKMAIL_MESSAGE_TOKEN. Эти два семейства токенов остаются раздельными.
Механизмы безопасности
На самостоятельно размещённом stdio-сервере MCP локальный администратор может потребовать TREKMAIL_ALLOW_DESTRUCTIVE=true перед запуском инструментов безвозвратного удаления и очистки корзины. Это локальная мера безопасности, а не переключатель функции продукта TrekMail. Обычные операции с корзиной также изменяют данные и поэтому требуют права на запись, но их можно отменить и для них не нужны права на безвозвратное удаление.
Для отправки почты и операций записи при миграции действуют отдельные механизмы. Включение разрушительных инструментов Drive не включает автоматически отправку или запись при миграции.
Загрузка через MCP
Для большинства процессов используйте drive_file_upload. Этот инструмент читает локальный файл на хосте MCP, запрашивает инструкции по загрузке, отправляет файл на полученный URL загрузки, завершает загрузку и отменяет резервирование, если происходит ошибка.
Низкоуровневые инструменты остаются доступными, когда интеграции требуется больше контроля, например если байты файла поступают из другого сервиса или специального процесса передачи.
Общедоступные ссылки через MCP
Используйте drive_share_create, чтобы создать общедоступный URL для скачивания. Всегда задавайте expires_at и max_downloads, если ссылка выходит за пределы вашей организации. Используйте drive_share_revoke, когда ссылка должна перестать работать. Исходный токен показывается только при создании, поэтому агентам следует сразу возвращать полный общедоступный URL.
Граница биллинга
Инструменты дополнения доступны только для чтения: drive_addon_get, drive_addon_pricing и drive_addon_cancellation_preview. Агенты не могут купить, изменить объём или отменить дополнение Drive через MCP. Эти действия по-прежнему выполняются только в Dashboard и контролируются пользователем.
Связанные статьи
Похожие статьи
Перейдите к близким руководствам, которые продолжают рабочий процесс.