Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.
run_mutation_query
Executa INSERT, UPDATE, REPLACE ou DELETE no provider. Efeitos colaterais reais - uma chamada bem-sucedida altera o estado na nuvem.
Controlado pelo modo do servidor:
| Modo | INSERT / UPDATE / REPLACE | DELETE |
|---|---|---|
read_only | recusado | recusado |
safe (padrão) | requer aprovação (elicitação) | requer aprovação |
delete_safe | permitido | requer aprovação |
full_access | permitido | permitido |
Um payload com várias instruções é controlado pela instrução mais privilegiada que ele contém
Quando uma mutação requer aprovação e o cliente não anunciou a capacidade de elicitação do MCP, a chamada é recusada.
Veja também:
[ Visão geral do MCP ] [ run_lifecycle_operation ] [ describe_method ] [ INSERT na especificação da linguagem ] [ DELETE na especificação da linguagem ]
Entradas
| Argumento | Obrigatório | Descrição |
|---|---|---|
sql | Sim | Uma instrução INSERT, UPDATE, REPLACE ou DELETE. |
source | Não | ID do item da Query Library quando o SQL veio de query_library_get. Serve apenas para atribuição; não altera a execução nem as aprovações. |
format | Não | Renderização do texto: markdown ou json. Quando omitido, usa a configuração de renderização do servidor. |
Saída
| Renderizador | Formato |
|---|---|
| KV | {messages: [...], timestamp} - confirmação de envio, não o corpo da resposta da API |
Exemplo
Experimente este prompt em qualquer cliente MCP compatível com elicitação que tenha o servidor MCP do StackQL registrado:
The firewall rule allow-test-old in project my-project
is no longer needed. Please remove it.
O cliente MCP exibirá uma solicitação de aprovação antes de a exclusão ser enviada, a menos que o servidor esteja em execução no modo full_access.
O clipe a seguir mostra o fluxo de elicitação quando o servidor MCP do StackQL está em execução no modo padrão safe - o cliente recebe uma solicitação para aprovar o DELETE antes que qualquer alteração do lado da nuvem seja enviada. Você pode reproduzir isso no seu próprio servidor MCP do StackQL com o MCP Inspector oficial, usando npx @modelcontextprotocol/inspector: