🔌MCP ツール一覧（28）

AI agent が使える 28 ツール（read 12 / write 13 / approval 3）と strict モードの仕組み。

MCP サーバ経由で AI agent が使える 28 ツールの一覧。read / write / approval の 3 namespace に分かれ、ダッシュボード相当の設定変更が可能。transport は既定 stdio（HTTP + Bearer も可）。

内訳（read 12 / write 13 / approval 3 = 計 28）

read（閲覧）

ツール	できること	実装
`read_list_clients`	アクセス可能な顧客一覧	`backend/mcp/tools/clients.py`
`read_get_client_overview`	顧客の基本設定 + 連携ポリシー + protection_enabled	`backend/mcp/tools/clients.py`
`read_list_whitelist`	許可番号（ホワイトリスト）一覧	`backend/mcp/tools/whitelist.py`
`read_list_blocklist`	拒否番号（ブロックリスト）一覧	`backend/mcp/tools/blocklist.py`
`read_list_auth_keywords`	認証キーワード一覧	`backend/mcp/tools/auth_keywords.py`
`read_list_dictionary`	STT 補正辞書の一覧	`backend/mcp/tools/dictionary.py`
`read_get_engine_config`	判定エンジン設定（閾値・キーワード重み）	`backend/mcp/tools/engine_config.py`
`read_list_categories`	グローバルスパムカテゴリ一覧	`backend/mcp/tools/categories.py`
`read_list_client_category_configs`	顧客別カテゴリオーバーライド一覧	`backend/mcp/tools/categories.py`
`read_list_pending_approvals`	承認待ちの変更申請一覧	`backend/mcp/tools/approvals.py`
`read_get_change_approval`	変更申請の詳細（差分つき）	`backend/mcp/tools/approvals.py`
`read_list_integration_audit`	連携監査ログの一覧	`backend/mcp/tools/audit.py`

write（変更）

ツール	できること	実装
`write_add_whitelist_entry`	許可番号を追加（緩め方向 = strict 時は要承認）	`backend/mcp/tools/whitelist.py`
`write_remove_whitelist_entry`	許可番号を削除	`backend/mcp/tools/whitelist.py`
`write_add_blocklist_entry`	拒否番号を追加	`backend/mcp/tools/blocklist.py`
`write_remove_blocklist_entry`	拒否番号を削除（緩め方向 = strict 時は要承認）	`backend/mcp/tools/blocklist.py`
`write_add_auth_keyword`	認証キーワードを追加（緩め方向 = strict 時は要承認）	`backend/mcp/tools/auth_keywords.py`
`write_remove_auth_keyword`	認証キーワードを削除	`backend/mcp/tools/auth_keywords.py`
`write_add_dictionary_entry`	STT 補正辞書に追加	`backend/mcp/tools/dictionary.py`
`write_remove_dictionary_entry`	STT 補正辞書から削除	`backend/mcp/tools/dictionary.py`
`write_update_engine_config`	判定エンジン設定を更新（閾値を下げる patch は緩め方向 = strict 時は要承認）	`backend/mcp/tools/engine_config.py`
`write_set_client_category_override`	顧客別カテゴリオーバーライドを設定（allowed 化は緩め方向）	`backend/mcp/tools/categories.py`
`write_remove_client_category_override`	顧客別カテゴリオーバーライドを解除	`backend/mcp/tools/categories.py`
`write_set_protection_enabled`	保護の ON/OFF 切替（OFF 化は緩め方向 = strict 時は要承認）	`backend/mcp/tools/clients.py`
`write_update_client_overview`	顧客の連携ポリシー等を更新（strict 時は要承認）	`backend/mcp/tools/clients.py`

approval（承認フロー）

ツール	できること	実装
`approval_propose_change`	変更を申請する（strict で 409 になった write の再入口）	`backend/mcp/tools/approvals.py`
`approval_approve_change`	申請を承認する（申請者と別の operator が行う）	`backend/mcp/tools/approvals.py`
`approval_apply_change`	承認済み申請を適用する（CAS で二重適用を防止）	`backend/mcp/tools/approvals.py`

strict モード（二人承認の強制）

strict モード（clients.strict_approval_mode・client 単位）は既定 OFF。OFF の間は write は素通し（従来挙動）。ON の企業では「緩め方向（loosens）× 要二人承認」の変更だけ backend が 409 で拒否し、propose →（申請者と別の operator が）承認 → apply の 3 段が必須になる。MCP 側は 409 を「次に取るべき行動 + 自動 propose 用 payload」に変換して返すため、AI agent はそのまま approval_propose_change を呼べる。

ℹ️要点

既定 OFF。ON の企業では緩め方向の変更は propose →（別 operator の）承認 → apply の 3 段が必須。 全 write は AuditLogger で追跡されるため、OFF でも「誰がいつ何を変えたか」は事後監査できる。