Cette page a été traduite de l'anglais avec l'aide de l'IA. En cas de divergence, la version anglaise fait référence.
run_mutation_query
Exécute INSERT, UPDATE, REPLACE ou DELETE sur le provider. Effets de bord réels - un appel réussi modifie l'état du cloud.
Contrôlé par le mode du serveur :
| Mode | INSERT / UPDATE / REPLACE | DELETE |
|---|---|---|
read_only | refusé | refusé |
safe (valeur par défaut) | approbation requise (élicitation) | approbation requise |
delete_safe | autorisé | approbation requise |
full_access | autorisé | autorisé |
Une charge utile contenant plusieurs instructions est contrôlée par son instruction la plus privilégiée
Lorsqu'une mutation nécessite une approbation et que le client n'a pas annoncé la capacité d'élicitation MCP, l'appel est refusé.
Voir aussi :
[ Présentation de MCP ] [ run_lifecycle_operation ] [ describe_method ] [ INSERT dans la spécification du langage ] [ DELETE dans la spécification du langage ]
Entrées
| Argument | Obligatoire | Description |
|---|---|---|
sql | Oui | Une instruction INSERT, UPDATE, REPLACE ou DELETE. |
source | Non | Identifiant de l'entrée de la Query Library lorsque le SQL provient de query_library_get. Attribution uniquement ; ne modifie ni l'exécution ni les approbations. |
format | Non | Rendu du texte : markdown ou json. S'il est omis, le paramètre de rendu du serveur est utilisé. |
Sortie
| Rendu | Forme |
|---|---|
| KV | {messages: [...], timestamp} - confirmation d'envoi, pas le corps de la réponse de l'API |
Exemple
Essayez ce prompt avec n'importe quel client MCP prenant en charge l'élicitation et dans lequel le serveur MCP StackQL est enregistré :
The firewall rule allow-test-old in project my-project
is no longer needed. Please remove it.
Le client MCP affiche une demande d'approbation avant l'envoi de la suppression, sauf si le serveur s'exécute en mode full_access.
La séquence suivante montre le flux d'élicitation lorsque le serveur MCP StackQL s'exécute dans le mode safe par défaut - le client est invité à approuver le DELETE avant l'envoi de toute modification côté cloud. Vous pouvez reproduire cela sur votre propre serveur MCP StackQL avec l'outil officiel MCP Inspector, à l'aide de npx @modelcontextprotocol/inspector :