Lewati ke konten utama
Halaman terjemahan

Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.

Agen AI

StackQL memberi agen AI antarmuka SQL yang sama dengan yang digunakan orang untuk mengkueri, menyediakan, dan mengoperasikan layanan cloud dan SaaS. Agen menemukan apa yang diekspos oleh sebuah provider, memvalidasi kueri sebelum kueri dijalankan, membaca status terkini dengan SELECT dan mengubahnya dengan INSERT, UPDATE, dan DELETE, tanpa file status dan tanpa SDK per cloud.

Cara agen terhubung​

  • MCP melalui stdio untuk klien editor dan desktop seperti Claude Desktop, Cursor, dan Continue. Klien sendiri yang meluncurkan perintah stackql mcp --mcp.server.type=stdio. Lihat Server MCP.
  • MCP melalui HTTP untuk agen mandiri dan otomatisasi yang terhubung ke proses stackql mcp atau stackql srv yang berjalan lama, dengan autentikasi token bearer dan TLS opsional.
  • MCP tersemat untuk aplikasi terkompilasi: server berjalan di dalam proses aplikasi di Go, Rust, Swift, Kotlin, .NET, dan Gleam. Lihat MCP tersemat.
  • Protokol komunikasi PostgreSQL melalui stackql srv untuk framework agen, notebook, dan alat BI yang sudah mendukung Postgres.

Mulai cepat dengan Claude Desktop​

Instal dari Anthropic Connector Directory (direkomendasikan) atau dari MCP Bundle yang dapat diunduh, atau daftarkan server secara manual di file claude_desktop_config.json:

{
"mcpServers": {
"stackql": {
"command": "stackql",
"args": ["mcp", "--mcp.server.type=stdio", "--tls.allowInsecure"],
"env": {
"AWS_ACCESS_KEY_ID": "your-aws-access-key-id",
"AWS_SECRET_ACCESS_KEY": "your-aws-secret-access-key"
}
}
}
}

Sertakan hanya kredensial untuk provider yang akan Anda gunakan. Instruksi lengkap, termasuk unduhan bundle dan penggunaan file kredensial, ada di Menggunakan StackQL dengan Claude Desktop.

Apa yang dapat dilakukan agen​

Server MCP mengekspos sekumpulan kecil alat bertipe. Setiap alat mengembalikan tampilan hasil render untuk model dan payload terstruktur untuk klien yang mengaksesnya secara terprogram.

  • Menemukan: list_providers, list_services, list_resources, list_methods, dan describe_method menelusuri hierarki provider dan mengembalikan input serta field output setiap operasi, sehingga parameter WHERE yang wajib sudah diketahui sebelum kueri ditulis.
  • Memvalidasi dan membaca: validate_select_query mengurai dan merencanakan pernyataan SELECT tanpa menjalankannya; run_select_query menjalankannya.
  • Mengubah: run_mutation_query menjalankan INSERT, UPDATE, REPLACE, dan DELETE; run_lifecycle_operation menjalankan operasi siklus hidup EXEC. Keduanya dikendalikan oleh mode server yang dijelaskan di bawah.
  • Pemeliharaan: server_info, list_registry, pull_provider, dan reload_credentials.

Referensi lengkap, dengan input, perilaku pengendalian, dan contoh prompt untuk setiap alat, ada di Alat MCP.

Batasan pengaman​

Mode server menetapkan kontrak keamanan untuk seluruh sesi:

ModeSELECT / metadataINSERT / UPDATE / REPLACEDELETE / EXEC
read_onlyizinkantolaktolak
safe (default)izinkanperlu persetujuanperlu persetujuan
delete_safeizinkanizinkanperlu persetujuan
full_accessizinkanizinkanizinkan

"Perlu persetujuan" menggunakan elisitasi MCP: klien yang mendukungnya (Claude Desktop, Cursor, Continue) menampilkan nama alat, kelas kueri, dan SQL kepada pengguna lalu menunggu keputusan sebelum apa pun dijalankan; klien yang tidak menyatakan kemampuan tersebut ditolak. Setiap panggilan alat ditulis ke log audit, listener HTTP memerlukan token bearer, dan kredensial diambil dari lingkungan atau file dotenv tanpa ada nilai rahasia yang pernah dikembalikan ke klien. Detailnya ada di Mode server, Autentikasi klien HTTP, dan Log audit.

Langkah berikutnya​

  • Server MCP - mode deployment, konfigurasi, mode server, log audit, dan flag.
  • Alat MCP - referensi lengkap alat dengan input, pengendalian, dan contoh prompt.
  • MCP tersemat - jalankan server di dalam aplikasi Go, Rust, Swift, Kotlin, .NET, atau Gleam milik Anda sendiri.
  • Query Library - SQL siap jalan untuk pertanyaan umum seputar operasi cloud, per provider.
  • Referensi AI - konsep, panduan praktis, perbandingan, dan pemecahan masalah yang ditulis untuk agen dan orang yang membangunnya.