Drive ストレージアドオンの API 境界
TrekMail Drive ストレージアドオンで、エージェントが状態と料金を確認できても、API や MCP から請求を変更できない理由を説明します。
記事の詳細
種類・難易度・対象プラン・最終更新の情報。
▼
記事の詳細
種類・難易度・対象プラン・最終更新の情報。
- 種類
- リファレンス
- 難易度
- 中級
- プラン
- Starter · Pro · Agency · + Drive Add-on
- 最終更新
- 2026年9月10日
Drive ストレージアドオンは、TrekMail アカウントの共有ストレージを拡張します。エージェントはアドオンのステータスと料金を読み取れますが、API または MCP の書き込み操作を通じて購入、容量変更、キャンセル、その他のサブスクリプション変更を行うことはできません。
このページでは、請求に関する決定がバックグラウンドのエージェント操作にならないようにしながら、自動化を有効に活用するための境界について説明します。
エージェントが読み取れる情報
drive:addon:read があれば、連携機能は次の情報を読み取れます。
- Drive アドオンの現在のステータス。
- アドオンが有効な場合の容量と請求期間。
- 対応している通貨の料金オプション。
- 利用可能な場合は、キャンセルのプレビュー情報。
- 追加容量が必要かどうかの判断に役立つストレージ使用状況。
これは、レポート作成エージェント、ダッシュボード、ストレージモニター、サポートワークフローに十分な情報です。
エージェントが変更できない項目
API と MCP サーバーは、次の書き込み操作を提供していません。
- Drive アドオンの購入。
- アドオン容量の増減。
- 請求期間または支払い方法の変更。
- アドオンのキャンセルまたは再有効化。
- カードへの請求またはサブスクリプション変更の実行。
drive:addon:write スコープは存在しません。MCP サーバーには、購入、容量変更、キャンセルを行うツールがありません。
この境界が存在する理由
ストレージの変更は、請求書、通貨、容量計画、データ保持に影響する可能性があります。エージェントは使用量が多いことに気づいて選択肢を説明できますが、請求に関する最終手順は、人が料金を確認して操作を承認できるダッシュボードで行う必要があります。
この境界は、エージェントが誤って設定された場合の被害も抑えます。権限を絞ったストレージ監視トークンは、費用を発生させたり容量をキャンセルしたりすることなく、割り当て量が残りわずかであることを報告できます。
推奨される自動化パターン
drive:addon:readと関連する Drive 読み取りスコープを付与します。- エージェントに使用量とアドオンのステータスを確認させます。
- ストレージが不足しそうな場合は、エージェントに短い推奨事項を作成させます。
- 購入、容量変更、キャンセルを行う場合は、ダッシュボードの Drive アドオンページにユーザーを案内します。
エージェントの応答例:
アカウントは共有ストレージの 91% を使用しています。現在の Drive アドオンは有効です。現在の増加傾向を踏まえ、次のアップロード処理を行う前にダッシュボードでアドオンの容量を確認することをおすすめします。
猶予期間と読み取り専用の状態
アドオンをキャンセルすると、書き込みが制限されてもファイルは読み取り可能な猶予期間が設けられる場合があります。エージェントはこれを自動修復する対象ではなく、報告する状態として扱う必要があります。容量を復元するか、ファイルを削除するか、データをエクスポートするかはユーザーが決定できます。
関連記事
ワークフローの続きとなる関連ガイドに移動します。