AI エージェント向け Drive MCP ツールの概要

TrekMail MCP サーバーは、ファイルストレージ、公開リンク、安全なクリーンアップ、同期デバイスのパスワードに対応する構造化ツールとして TrekMail を AI エージェントに公開します。接続に表示されるのは、その認証情報、選択したツールセット、トランスポート、セーフティゲートで許可されたツールだけです。固定されたカタログ数に頼らず、エージェントに公開されているツール一覧を確認してください。

通常、エージェントにとって MCP は生の REST よりも簡単です。エージェントに HTTP リクエストを組み立てさせる代わりに、drive_file_upload、drive_share_create、drive_bulk_move などのツールを与えます。背後では、API が引き続きトークンスコープ、冪等性、監査ログ、セーフティゲートを適用します。

ツールの対象範囲

トークンの要件

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 アドレスは、その証明書と制限付きホストの準備が完了してから含まれます。

TREKMAIL_MESSAGE_TOKEN も指定すれば、Drive ツールをメッセージツールと併用できます。2 種類のトークンは引き続き分離されています。

セーフティゲート

セルフホスト型の stdio MCP サーバーでは、完全消去やゴミ箱を空にするツールを実行する前に、ローカル管理者が TREKMAIL_ALLOW_DESTRUCTIVE=true を必須にできます。これはローカルの安全管理であり、TrekMail 製品の機能スイッチではありません。通常のゴミ箱操作もデータを変更するため書き込みスコープが必要ですが、復元可能なので消去スコープは不要です。

メール送信と移行の書き込み操作には、それぞれ別のゲートがあります。Drive の破壊的ツールを有効にしても、送信や移行の書き込みが自動的に有効になることはありません。

MCP 経由のアップロード

ほとんどのワークフローでは drive_file_upload を使用します。このツールは MCP ホストからローカルファイルを読み取り、アップロード手順を要求し、返されたアップロード URL にファイルを送信してアップロードを完了します。問題が発生した場合は予約を中止します。

別のサービスからファイルのバイト列を受け取る場合や独自の転送処理を使う場合など、統合でさらに細かい制御が必要なときは、低レベルツールも引き続き利用できます。

MCP 経由の共有リンク

公開ダウンロード URL を作成するには drive_share_create を使用します。リンクを組織外に出す場合は、必ず expires_at と max_downloads を設定してください。リンクを停止するときは drive_share_revoke を使用します。生のトークンは作成時にしか表示されないため、エージェントは完全な公開 URL をすぐに返す必要があります。

請求の境界

アドオンツールは読み取り専用です。対象は drive_addon_get、drive_addon_pricing、drive_addon_cancellation_preview です。エージェントは MCP 経由で Drive アドオンを購入、容量変更、または解約できません。これらの操作は引き続きダッシュボードでのみ行え、ユーザーが管理します。