Pular para o conteúdo principal
Página traduzida

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:

ModoINSERT / UPDATE / REPLACEDELETE
read_onlyrecusadorecusado
safe (padrão)requer aprovação (elicitação)requer aprovação
delete_safepermitidorequer aprovação
full_accesspermitidopermitido

informação

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​

ArgumentoObrigatórioDescrição
sqlSimUma instrução INSERT, UPDATE, REPLACE ou DELETE.
sourceNãoID 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.
formatNãoRenderização do texto: markdown ou json. Quando omitido, usa a configuração de renderização do servidor.

Saída​

RenderizadorFormato
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: