Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.
run_mutation_query
Menjalankan pernyataan INSERT, UPDATE, REPLACE, atau DELETE terhadap provider. Efek samping nyata - panggilan yang berhasil mengubah status cloud.
Dikendalikan oleh mode server:
| Mode | INSERT / UPDATE / REPLACE | DELETE |
|---|---|---|
read_only | ditolak | ditolak |
safe (default) | perlu persetujuan (elisitasi) | perlu persetujuan |
delete_safe | diizinkan | perlu persetujuan |
full_access | diizinkan | diizinkan |
Payload yang berisi beberapa pernyataan dikendalikan oleh pernyataan dengan hak istimewa tertinggi di dalamnya
Jika mutasi memerlukan persetujuan dan klien tidak menyatakan kemampuan elisitasi MCP, panggilan ditolak.
Lihat juga:
[ Ringkasan MCP ] [ run_lifecycle_operation ] [ describe_method ] [ INSERT di spesifikasi bahasa ] [ DELETE di spesifikasi bahasa ]
Input
| Argumen | Wajib | Deskripsi |
|---|---|---|
sql | Ya | Pernyataan INSERT, UPDATE, REPLACE, atau DELETE. |
source | Tidak | ID entri Query Library jika SQL berasal dari query_library_get. Hanya untuk atribusi; tidak mengubah eksekusi atau persetujuan. |
format | Tidak | Perenderan teks: markdown atau json. Jika dihilangkan, pengaturan render server yang digunakan. |
Output
| Perender | Bentuk |
|---|---|
| KV | {messages: [...], timestamp} - konfirmasi pengiriman, bukan isi respons API |
Contoh
Coba prompt ini di klien MCP mana pun yang mendukung elisitasi dan telah mendaftarkan server MCP StackQL:
The firewall rule allow-test-old in project my-project
is no longer needed. Please remove it.
Klien MCP akan menampilkan permintaan persetujuan sebelum penghapusan dikirim, kecuali jika server berjalan dalam mode full_access.
Klip berikut menunjukkan alur elisitasi saat server MCP StackQL berjalan dalam mode safe (default) - klien diminta menyetujui pernyataan DELETE sebelum perubahan apa pun di sisi cloud dikirim. Anda dapat mereproduksinya terhadap server MCP StackQL Anda sendiri dengan MCP Inspector resmi menggunakan npx @modelcontextprotocol/inspector: