Chuyển tới nội dung chính
Trang được dịch

Trang này được dịch từ tiếng Anh với sự hỗ trợ của AI. Nếu hai bản có chỗ khác nhau, hãy lấy phiên bản tiếng Anh làm chuẩn.

run_mutation_query

Thực thi INSERT, UPDATE, REPLACE hoặc DELETE đối với provider. Có tác dụng phụ thực sự - một lệnh gọi thành công sẽ thay đổi trạng thái đám mây.

Được kiểm soát bởi chế độ máy chủ:

Chế độINSERT / UPDATE / REPLACEDELETE
read_onlybị từ chốibị từ chối
safe (mặc định)cần phê duyệt (elicitation)cần phê duyệt
delete_safeđược cho phépcần phê duyệt
full_accessđược cho phépđược cho phép

thông tin

Một payload chứa nhiều câu lệnh được kiểm soát theo câu lệnh có đặc quyền cao nhất trong đó

Khi một thao tác thay đổi dữ liệu cần phê duyệt mà ứng dụng khách không công bố khả năng elicitation của MCP, lệnh gọi sẽ bị từ chối.

Xem thêm: [ Tổng quan về MCP ] [ run_lifecycle_operation ] [ describe_method ] [ INSERT trong đặc tả ngôn ngữ ] [ DELETE trong đặc tả ngôn ngữ ]


Đầu vào​

Đối sốBắt buộcMô tả
sqlCóMột câu lệnh INSERT, UPDATE, REPLACE hoặc DELETE.
sourceKhôngID mục Query Library khi SQL đến từ query_library_get. Chỉ dùng để ghi nhận nguồn; không thay đổi việc thực thi hay phê duyệt.
formatKhôngĐịnh dạng hiển thị văn bản: markdown hoặc json. Khi không được cung cấp, công cụ dùng thiết lập hiển thị của máy chủ.

Đầu ra​

Trình hiển thịDạng
KV{messages: [...], timestamp} - xác nhận đã gửi đi, không phải phần thân phản hồi của API

Ví dụ​

Hãy thử lời nhắc này với bất kỳ ứng dụng khách MCP nào hỗ trợ elicitation và đã đăng ký máy chủ MCP StackQL:

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

Ứng dụng khách MCP sẽ hiển thị yêu cầu phê duyệt trước khi thao tác xóa được gửi đi, trừ khi máy chủ đang chạy ở chế độ full_access.

Đoạn video sau cho thấy luồng elicitation khi máy chủ MCP StackQL đang chạy ở chế độ safe mặc định - ứng dụng khách được yêu cầu phê duyệt DELETE trước khi bất kỳ thay đổi nào phía đám mây được gửi đi. Bạn có thể tái hiện điều này trên máy chủ MCP StackQL của riêng bạn bằng MCP Inspector chính thức thông qua npx @modelcontextprotocol/inspector: