Diese Seite wurde mit KI-Unterstützung aus dem Englischen übersetzt. Bei Abweichungen ist die englische Version maßgeblich.
run_mutation_query
Führt INSERT, UPDATE, REPLACE oder DELETE gegen den Provider aus. Reale Seiteneffekte - ein erfolgreicher Aufruf ändert den Cloud-Zustand.
Unterliegt dem Gating durch den Modus des Servers:
| Modus | INSERT / UPDATE / REPLACE | DELETE |
|---|---|---|
read_only | abgelehnt | abgelehnt |
safe (Standard) | erfordert Genehmigung (Elicitation) | erfordert Genehmigung |
delete_safe | erlaubt | erfordert Genehmigung |
full_access | erlaubt | erlaubt |
Eine Payload mit mehreren Anweisungen unterliegt dem Gating ihrer privilegiertesten Anweisung
Wenn eine Mutation eine Genehmigung erfordert und der Client die MCP-Elicitation-Fähigkeit nicht angekündigt hat, wird der Aufruf abgelehnt.
Siehe auch:
[ MCP-Übersicht ] [ run_lifecycle_operation ] [ describe_method ] [ INSERT-Sprachspezifikation ] [ DELETE-Sprachspezifikation ]
Eingaben
| Argument | Erforderlich | Beschreibung |
|---|---|---|
sql | Ja | Eine INSERT-, UPDATE-, REPLACE- oder DELETE-Anweisung. |
source | Nein | ID des Query-Library-Eintrags, wenn das SQL von query_library_get stammt. Nur zur Attribution; ändert weder Ausführung noch Genehmigungen. |
format | Nein | Textrendering: markdown oder json. Wenn nicht angegeben, wird die Rendering-Einstellung des Servers verwendet. |
Ausgabe
| Renderer | Struktur |
|---|---|
| KV | {messages: [...], timestamp} - Bestätigung des Absendens, nicht der Antworttext der API |
Beispiel
Probieren Sie diesen Prompt mit einem beliebigen Elicitation-fähigen MCP-Client aus, bei dem der StackQL-MCP-Server registriert ist:
The firewall rule allow-test-old in project my-project
is no longer needed. Please remove it.
Der MCP-Client zeigt eine Genehmigungsaufforderung an, bevor das Löschen abgesetzt wird, es sei denn, der Server läuft im Modus full_access.
Der folgende Clip zeigt den Elicitation-Ablauf, wenn der StackQL-MCP-Server im Standardmodus safe läuft - der Client wird aufgefordert, das DELETE zu genehmigen, bevor eine cloudseitige Änderung abgesetzt wird. Sie können dies gegen Ihren eigenen StackQL-MCP-Server mit dem offiziellen MCP Inspector über npx @modelcontextprotocol/inspector nachvollziehen: