Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
run_mutation_query
Виконує інструкції INSERT, UPDATE, REPLACE або DELETE для провайдера. Реальні побічні ефекти - успішний виклик змінює стан хмари.
Контролюється режимом сервера:
| Режим | INSERT / UPDATE / REPLACE | DELETE |
|---|---|---|
read_only | відхилено | відхилено |
safe (за замовчуванням) | потрібне схвалення (elicitation) | потрібне схвалення |
delete_safe | дозволено | потрібне схвалення |
full_access | дозволено | дозволено |
Корисне навантаження з кількома інструкціями контролюється за інструкцією з найвищими привілеями
Якщо змінення даних потребує схвалення, а клієнт не оголосив можливість elicitation протоколу MCP, сервер відхиляє виклик.
Див. також:
[ Огляд MCP ] [ run_lifecycle_operation ] [ describe_method ] [ INSERT у специфікації мови ] [ DELETE у специфікації мови ]
Вхідні дані
| Аргумент | Обов'язковий | Опис |
|---|---|---|
sql | Так | Інструкція INSERT, UPDATE, REPLACE або DELETE. |
source | Ні | Ідентифікатор запису Query Library, якщо SQL отримано за допомогою query_library_get. Лише для атрибуції; не впливає на виконання та схвалення. |
format | Ні | Формат текстового відображення: markdown або json. Якщо аргумент не вказано, сервер використовує власне налаштування відображення. |
Вихідні дані
| Засіб відображення | Форма |
|---|---|
| KV | {messages: [...], timestamp} - підтвердження надсилання, а не тіло відповіді API |
Приклад
Спробуйте цей промпт у будь-якому клієнті MCP з підтримкою elicitation, у якому зареєстровано сервер MCP StackQL:
The firewall rule allow-test-old in project my-project
is no longer needed. Please remove it.
Клієнт MCP покаже запит на схвалення перед надсиланням операції видалення, якщо сервер не працює в режимі full_access.
У наведеному нижче відео показано процес elicitation, коли сервер MCP StackQL працює в режимі за замовчуванням safe - клієнт отримує запит на схвалення інструкції DELETE до надсилання будь-якої зміни на боці хмари. Ви можете відтворити це на власному сервері MCP StackQL за допомогою офіційного інструмента MCP Inspector, запущеного командою npx @modelcontextprotocol/inspector: