運用:監査ログとエンドポイントの制限
AI エージェントに MT を操作させるなら、何をしたかをあとから確かめられることと、させたくない操作を止められることが要ります。 mtb Pro はこの2つの機能を MT の側に用意します。
監査ログ
MtbPro は Data API へのリクエストについて、だれが・いつ・どのエンドポイントを・どんなパラメータで呼び、結果がどうだったかを記録します。 mtb から呼ぶと、何の作業として呼んだか(MTB_AUDIT_NOTE)も残ります。
bash
export MTB_AUDIT_NOTE="Five United の構築: カテゴリの作成"
mtb sites categories create 2 --category '{"label":"お知らせ","basename":"info"}'作業の説明で絞り込んで読みます。
bash
mtb audit-logs list --note "Pro の確認" --fields createdAt,method,path,note,userName,statusjson
{"items":[{"createdAt":"2026-11-06T04:26:58Z","method":"PUT","note":"Pro の確認: Data API の許可",
"path":"/v7/sites/1/dataApi","status":200,"userName":"admin"}],"totalResults":1}| 絞り込み | フラグ |
|---|---|
| 作業の説明の一部 | --note |
| 期間 | --since --until(2026-10-25 や 2026-10-25T09:00:00+09:00) |
| 人 | --user-name --user-id |
| サイト | --site-id |
| エンドポイント・メソッド | --endpoint --method |
| 失敗したものだけ | --failed true(完了しなかったものも含む) |
監査ログを読んだこと自体の記録は、既定では出しません(読むたびに増えるため)。記録に含めるなら --include-audit-reads true を付けます。
AI に任せた作業の確かめ方として、頼むときに「書き込みの前に MTB_AUDIT_NOTE に作業の説明を入れて」と書いておき、 終わったら --note で絞って読む、という使い方ができます(チュートリアル 3-2 でも頼んでいます)。
MtbPro を入れたら、まずアップグレード
アップグレードの前は監査ログのテーブルが無く、記録されません(インストール)。
エンドポイントの制限
MtbPro のエンドポイントは MT の管理画面(システム > プラグイン > MtbPro > 設定)で開け閉めできます。 構築のあいだは開けておき、運用を始めたら危険なもの(ファイルの書き込みなど)を閉じる、という使い方です。
- 閉じたものを呼ぶと
403 … turned off in the MtbPro plugin settingsで拒否されます。権限の問題ではないので、システム管理者でも呼び出せません - Data API から開ける手段はありません(意図した設計です)。AI エージェントが自分で開けることはできません
- いま開いているものはサインインしている人なら誰でも読めます
bash
mtb endpoint-policy get --extract restricted # false なら構築のあいだ(全部開いている)falseファイルを送るコマンドは、これとは別に mt-config.cgi の MtbProAllowFileUpload 1 も要ります(サーバの管理者が決める、2つ目の制限)。