AI エージェントを TrekMail Drive に接続

制限の厳しいトークンと明確なルールを与えれば、AI エージェントは Drive ファイルを安全に管理できます。このガイドでは、MCP 互換エージェント向けの Drive 固有の設定について説明します。MCP の一般的なインストールについては、AI エージェントの接続 (MCP)を参照してください。

エージェントの役割を選ぶ

ツールではなく、まずワークフローに名前を付けます。適切な例を次に示します。

• client-delivery-links は承認済みファイルの公開リンクを作成します。
• monthly-report-uploader は生成された PDF を Account Drive にアップロードします。
• mailbox-file-assistant は 1 つのメールボックスの Drive を検索します。
• storage-monitor は使用状況とアドオンの状態を読み取ります。

目的が明確な名前を付けると、後でトークンや監査ログを確認しやすくなります。

スコープを制限したトークンを作成する

AI エージェントと API → トークン → トークンを作成を開きます。Drive 専用エージェントでは、Drive スコープだけを選択してください。ほとんどのエージェントに完全消去の権限は不要です。

例：

トークンはこの時点でコピーしてください。TrekMail では再表示されません。

MCP を設定する

MCP 環境に操作用トークンを設定します。

TREKMAIL_BASE_URL=https://trekmail.net
TREKMAIL_API_TOKEN=tm_live_your_token
TREKMAIL_ALLOW_DESTRUCTIVE=false

これはセルフホスト型 MCP の安全管理であり、Drive の機能スイッチではありません。通常の Drive 作業では TREKMAIL_ALLOW_DESTRUCTIVE=false のままにし、完全消去ツールが必要な確認済みのクリーンアップ実行時だけ有効にしてください。

同じエージェントがメールの読み取りや送信も行う場合は、メッセージトークンを別途追加します。

TREKMAIL_MESSAGE_TOKEN=tm_msg_your_message_token

Drive ツールはメッセージトークンを使用しません。メッセージツールは Drive スコープを使用しません。

最初に無害なツールでテストする

エージェントに次のツールを呼び出すよう依頼します。

1. drive_spaces_list
2. drive_storage_summary
3. space="account" を指定した drive_browse_folder

これらの呼び出しではデータを変更せずにトークンの動作を確認できます。その後、一時フォルダーへの小さなファイルのアップロードをテストしてください。

安全な運用ルールをエージェントに与える

Drive エージェント向けの実用的なシステムプロンプトには、次のルールを含めてください。

• ユーザーが明示的に依頼しない限り、ファイルを完全に消去しない。
• 完全削除よりもゴミ箱を優先する。
• 公開リンクに有効期限とダウンロード数の上限を追加する。
• 作成した共有 URL をすぐに返す。
• チームファイルには Account Drive を使用し、タスクでメールボックスが指定された場合に限り Mailbox Drive を使用する。
• 大きなファイルをアップロードする前にストレージ使用量を確認する。

設定後に監査する

AI エージェントと API → 監査ログを開き、トークン名で絞り込みます。エージェントが想定した Drive ツールだけを呼び出したことを確認してください。トークンのスコープが多すぎる場合は取り消し、より制限の厳しいトークンを作成します。