본문으로 건너뛰기
번역된 페이지

이 페이지는 AI의 도움을 받아 영어에서 번역되었습니다. 두 내용이 다를 경우 영어 버전을 기준으로 합니다.

run_mutation_query

프로바이더에 대해 INSERT, UPDATE, REPLACE 또는 DELETE 문을 실행합니다. 실제 부작용이 있습니다. 호출이 성공하면 클라우드 상태가 변경됩니다.

서버 모드에 의해 게이트 제어됩니다.

모드INSERT / UPDATE / REPLACEDELETE
read_only거부됨거부됨
safe (기본값)엘리시테이션(elicitation)으로 승인 필요승인 필요
delete_safe허용됨승인 필요
full_access허용됨허용됨

정보

여러 문을 포함하는 페이로드는 그중 가장 높은 권한이 필요한 문을 기준으로 게이트 제어됩니다

변경 작업에 승인이 필요한데 클라이언트가 MCP 엘리시테이션 기능을 알리지 않은 경우 호출이 거부됩니다.

참고 항목: [ MCP 개요 ] [ run_lifecycle_operation ] [ describe_method ] [ INSERT 언어 사양 ] [ DELETE 언어 사양 ]


입력​

인수필수설명
sql예INSERT, UPDATE, REPLACE 또는 DELETE 문입니다.
source아니요SQL을 query_library_get 도구에서 가져온 경우의 Query Library 항목 ID입니다. 출처 표시 용도로만 사용되며, 실행이나 승인에는 영향을 주지 않습니다.
format아니요텍스트 렌더링 형식(markdown 또는 json)입니다. 생략하면 서버의 렌더링 설정을 사용합니다.

출력​

렌더러형태
KV{messages: [...], timestamp} (API 응답 본문이 아닌 전송 확인)

예제​

StackQL MCP 서버가 등록되어 있고 엘리시테이션을 지원하는 MCP 클라이언트에서 다음 프롬프트를 사용해 보세요:

The firewall rule allow-test-old in project my-project
is no longer needed. Please remove it.

서버가 full_access 모드로 실행 중이 아니면, MCP 클라이언트는 삭제 작업이 전송되기 전에 승인 요청을 표시합니다.

다음 영상은 StackQL MCP 서버가 기본 safe 모드로 실행 중일 때의 엘리시테이션 흐름을 보여 줍니다. 클라우드 측 변경이 전송되기 전에 클라이언트에 DELETE 문을 승인하라는 요청이 표시됩니다. 공식 MCP Inspector를 npx @modelcontextprotocol/inspector 명령으로 실행하여 자체 StackQL MCP 서버에서 이 과정을 재현할 수 있습니다.