run_mutation_query

プロバイダーに対して INSERT、UPDATE、REPLACE または DELETE を実行します。実際の副作用があります：呼び出しが成功すると、クラウドの状態が変更されます。

サーバーのモードによってゲート制御されます：

モード	INSERT / UPDATE / REPLACE	DELETE
read_only	拒否	拒否
safe（デフォルト）	承認が必要（エリシテーション）	承認が必要
delete_safe	許可	承認が必要
full_access	許可	許可

備考

複数の文を含むペイロードは、その中で最も権限の高い文によってゲート制御されます

ミューテーションに承認が必要で、クライアントが MCP のエリシテーション（elicitation）機能を公開していない場合、呼び出しは拒否されます。

関連項目： [ MCP の概要 ] [ run_lifecycle_operation ] [ describe_method ] [ INSERT 言語仕様 ] [ DELETE 言語仕様 ]

---

入力

引数	必須	説明
sql	はい	INSERT、UPDATE、REPLACE または DELETE 文。
source	いいえ	SQL が query_library_get から得られた場合の Query Library のエントリ ID。出典を示すためだけのもので、実行や承認には影響しません。
format	いいえ	テキストのレンダリング形式：markdown または json。省略した場合は、サーバーのレンダリング設定を使用します。

---

出力

レンダラー	形状
KV	{messages: [...], timestamp}：API のレスポンスボディではなく、送信の確認

---

例

StackQL MCP サーバーを登録した、エリシテーションに対応する任意の MCP クライアントで、次のプロンプトを試してください：

The firewall rule allow-test-old in project my-project  
is no longer needed.  Please remove it.

サーバーが full_access モードで実行されている場合を除き、MCP クライアントは削除が送信される前に承認リクエストを表示します。

次のクリップは、StackQL MCP サーバーがデフォルトの safe モードで実行されている場合のエリシテーションの流れを示しています。クラウド側の変更が送信される前に、クライアントは DELETE を承認するよう求められます。公式の MCP Inspector を npx @modelcontextprotocol/inspector で起動すると、手元の StackQL MCP サーバーに対してこれを再現できます：