Dokumentasi / Sambungkan AI (MCP)

Sambungkan AI (MCP)

Tetap bekerja dengan agent AI pilihan Anda. Lewat MCP Saka, agent hanya memakai alat yang kami sediakan, bukan shell root yang bisa melakukan apa saja.

1. Buat token

  1. Buka Pengaturan di panel, kartu Sambungkan AI Anda (MCP) & token API.
  2. Beri nama token, misalnya "Claude di laptop", lalu tekan Buat token.
  3. Salin token (diawali saka_) sekarang. Token hanya ditampilkan sekali.

Token yang sama berlaku untuk MCP dan API REST. Panel menampilkan kapan terakhir dipakai, dan token bisa dicabut kapan saja; AI yang memakainya langsung kehilangan akses.

2. Sambungkan

Claude Code

Terminal
claude mcp add --transport http sakapanel https://app.saka.work/mcp --header "Authorization: Bearer <token>"

Klien MCP lain

Segera

Masuk dengan OAuth agar Saka bisa dipasang langsung sebagai konektor di claude.ai dan ChatGPT tanpa menyalin token.

Setelah tersambung, coba tanyakan: "Bagaimana kondisi server saya?" Agent akan memanggil server_daftar.

Alat MCP yang tersedia

AlatFungsi
server_daftarDaftar server beserta status terakhir (tersambung, CPU, RAM, disk, aplikasi).
server_statusStatus langsung satu server, diminta ke agent saat itu juga.
server_tambahMembuat perintah pasang satu baris untuk VPS baru; Anda sendiri yang menjalankannya di server.
metrik_riwayatRiwayat CPU, RAM, disk, dan beban (disimpan di server itu, 30 hari).
resep_daftarKatalog aplikasi siap pasang dan isian yang dibutuhkan.
aplikasi_pasangMemasang aplikasi dari katalog di server (kontainer non-root, port hanya lokal).
aplikasi_logLog terakhir aplikasi, dibaca langsung dari server (tidak disimpan Saka).
aplikasi_mulai_ulangMemulai ulang aplikasi; data tidak berubah.
aplikasi_hapus_siapkanLangkah 1 dari 2 menghapus aplikasi: pratinjau dan token konfirmasi (10 menit).
aplikasi_hapusLangkah 2 dari 2: menghapus aplikasi dengan token, hanya setelah Anda menyetujui pratinjau.
aplikasi_akses_daftarPermintaan akses (pairing) yang menunggu persetujuan, misalnya orang baru yang mengirim pesan ke bot OpenClaw.
aplikasi_akses_setujuiMenyetujui satu kode akses, hanya setelah Anda mengenali pengirimnya.
server_perbaikiPerbaikan kesiapan: swap, firewall-cek (daftar port, baca saja), dan firewall.
database_daftarDaftar klaster database beserta keadaan dan anggotanya.
database_buatMembuat klaster database multi-lokasi (PostgreSQL atau MariaDB, 2 data + 1 saksi).
database_statusKeadaan klaster, anggota, jeda replikasi, dan alamat sambungan. Tanpa sandi.
database_sambungkan_aplikasiMemasang proxy Saka di server aplikasi agar aplikasi pindah otomatis saat server mati.
lb_daftarDaftar load balancer: penyeimbang, tujuan, domain, keadaan.
lb_buatMembuat load balancer dengan pemeriksaan kesehatan dan HTTPS otomatis.
lb_statusKesehatan tiap server tujuan dilihat dari tiap penyeimbang, dan sertifikat HTTPS per domain.
situs_daftarDaftar situs (WordPress, PHP, statis) di semua server, dengan domain dan keadaannya.
situs_buatMembuat situs WordPress, PHP, atau statis dengan HTTPS otomatis, database lokal atau klaster, atau pindah dari cPanel. Agent wajib mengonfirmasi rencananya kepada Anda dulu.
situs_statusKeadaan situs: HTTPS dan arah DNS per domain, ukuran, daftar cadangan, akun SFTP. Tanpa sandi.
situs_cadangkanMembuat cadangan situs sekarang (berkas + database), disimpan di server.
situs_ubah_siapkanLangkah 1 dari 2 untuk memulihkan atau menghapus situs: pratinjau dan token konfirmasi (10 menit).
situs_ubahLangkah 2 dari 2: memulihkan atau menghapus situs dengan token, hanya setelah Anda menyetujui pratinjau.
tugas_statusKeadaan tugas yang berjalan lama (misalnya pemasangan aplikasi).
peringatan_aktifMasalah yang sedang terjadi di semua server (terputus, disk penuh, aplikasi berhenti).

Setiap galat berisi kode, arti, dan langkah, sehingga agent bisa memperbaiki sendiri atau menjelaskan ke Anda apa yang harus dilakukan.

Prinsip keamanan

AI langsung di server vs AI lewat Saka

Memberi agent AI akses SSH root memang cepat, tapi satu perintah salah, atau satu halaman web yang menipu agent, bisa menghapus data dan membuka server Anda.

AI langsung di server (SSH root)AI lewat Saka (MCP)
AksesShell root: bisa menjalankan apa sajaHanya alat yang disediakan: status, pasang aplikasi, situs, buat database, load balancer, perbaikan
Kunci & sandiKunci SSH, sandi database, dan kunci AI terbaca oleh agentTidak pernah diserahkan ke agent; Anda melihatnya sendiri di panel
Aksi berbahayaLangsung jalan, tanpa pratinjauHapus aplikasi selalu dua langkah; firewall wajib menunjukkan port yang dipakai dulu
Ditipu lewat chat atau webPerintah sisipan dieksekusi dengan hak rootPaling jauh memanggil alat terbatas yang tetap butuh persetujuan Anda
JejakTidak tercatat di mana punSetiap tugas di server tercatat di riwayat beserta hasilnya
Server mati mendadakAgent ikut mati; tidak ada yang mengabariSaka memantau dari luar dan mengirim notifikasi Telegram

Biaya AI dibayar langsung ke penyedia AI Anda. Saka tidak memungut biaya untuk MCP.