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. Pilih hak token: Boleh mengubah, atau Hanya melihat bila AI cukup memantau (alat yang mengubah tidak terlihat dan ditolak, begitu juga perubahan lewat API). Atau Izin terpilih untuk token yang hanya boleh mengubah kelompok tertentu (situs, server, database, kubernetes, jaringan, pantau, hapus). Lewat MCP, AI hanya melihat dan bisa memanggil alat di kelompok itu; alat lain disembunyikan dan ditolak, dan alat yang menghapus butuh izin hapus. Lihat Tim dan peran.
  4. 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

Muat alat yang dipakai saja

Tanpa pilihan, agent AI memuat semua 148 alat Saka (sekitar 25 ribu token di setiap percakapan; sebagian klien seperti Cursor juga membatasi jumlah alat). Tambahkan ?alat= di alamat MCP untuk memuat kelompok tertentu saja, mis. https://app.saka.work/mcp?alat=situs,pantau. Alat inti (daftar & status server, tugas, peringatan, riwayat aksi, usulan fitur) selalu ikut. Kelompok: server (kelola server, Perisai, akun cloud), situs (situs, berkas, WordPress, katalog, cadangan S3), pantau, aplikasi (OpenClaw, Hermes), database, jaringan (load balancer, tunnel, VPN), k8s, armada, pindah. Di Pengaturan, saat membuat token, centang kelompoknya dan perintah sambung ikut menyesuaikan. Alat di luar kelompok yang dipilih ditolak dengan pesan yang menyebut kelompoknya.

Claude Code

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

Klien MCP lain

OpenClaw atau Hermes (urus server lewat chat Telegram)

Dipasang lewat Saka: buka halaman aplikasinya, kartu Urus server lewat chat, pilih hak, lalu tekan Hubungkan ke Saka. Saka membuat token khusus, menyimpannya di server aplikasi (tidak di riwayat tugas), dan memulai ulang asisten. Tekan Putuskan untuk mencabutnya; menghapus aplikasi atau melepas server juga mencabut token. Dengan hak Boleh mengubah, setiap aksi pengubah dari asisten dikabarkan ke Telegram Anda.

Dipasang sendiri: buat token, lalu

OpenClaw
openclaw mcp add saka --url https://app.saka.work/mcp --transport streamable-http --header "Authorization=Bearer <token>"
Hermes: ~/.hermes/config.yaml, lalu kirim /reload-mcp
mcp_servers:
  saka:
    url: https://app.saka.work/mcp
    headers:
      Authorization: "Bearer <token>"

Siapa pun yang bisa chat dengan asisten itu bisa memakai aksesnya ke Saka. Pastikan hanya Anda yang disetujui di Akses chat.

claude.ai, Claude Desktop, dan ChatGPT (tanpa menyalin token)

  1. claude.ai atau Claude Desktop: Settings, Connectors, Add custom connector. ChatGPT: Settings, Apps & Connectors, buat konektor baru (mode developer).
  2. Isi alamat https://app.saka.work/mcp, lalu tekan Connect.
  3. Halaman Saka terbuka: masuk bila diminta, pilih Hanya melihat atau Boleh mengubah, lalu Izinkan. Anda kembali ke aplikasi AI dan konektor langsung aktif.

Setiap konektor muncul sebagai token di Pengaturan, Token API (mis. "Konektor Claude") dan bisa dicabut kapan saja. Anda juga dikabari lewat Telegram saat konektor baru tersambung.

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).
server_bandwidth, server_kuota_bandwidthPemakaian bandwidth masuk dan keluar per hari, per bulan, dan per situs, serta kuota bulanan untuk peringatan 80% dan 100%. Lihat Pemakaian bandwidth.
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 dan keamanan server (keamanan-cek baca saja, ssh-kunci, pembaruan-otomatis): swap, firewall-cek (daftar port, baca saja), firewall, serta web-cek (rencana, baca saja) dan web (menyiapkan port 80/443 bila dipakai CasaOS, nginx, atau Apache, dengan persetujuan Anda; lihat Port web).
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.
panduan_deployUrutan langkah dan aturan membawa aplikasi buatan OpenCode/Claude Code/Cursor dari komputer pengguna menjadi online di server Saka, dari VM kosong sampai alamat HTTPS. AI memanggilnya sebelum mulai. Lihat Dari VM kosong sampai online.
panduan_haUrutan langkah dan aturan membuat aplikasi + database tetap jalan saat satu VM atau region mati. AI memanggilnya sebelum mulai.
database_pindahkan_lamaMenyalin database lama (PostgreSQL, atau MySQL 8/MariaDB ke klaster MariaDB) ke klaster, lalu membandingkan jumlah baris.
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 (dari berkas cadangan, atau masuk ke cPanel lama; sandi cPanel hanya diteruskan ke server Anda). 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_alamatMemberi situs yang sudah ada alamat otomatis https://<nama>-app.hack.id (HTTPS otomatis, tanpa mengatur DNS). Situs baru cukup dibuat tanpa domain.
situs_unggahMengunggah gambar, font, PDF, atau zip (dibongkar di tempat) ke situs, maks. 10 MB per panggilan. Dengan panduan_deploy, agent bisa menaruh folder situs statis online tanpa Git, termasuk fotonya.
situs_uji_pulihMenguji cadangan terbaru benar-benar bisa dipulihkan: dibuka di wadah sementara tanpa internet, database diimpor, situs dibuka sekali. Situs asli tidak diubah. Lihat Uji pulih cadangan.
situs_atur_phpMengubah pengaturan PHP situs (setara MultiPHP INI Editor cPanel): batas unggah, memori, waktu eksekusi, max_input_vars, zona waktu, tampilkan error. Situs dimulai ulang beberapa detik.
situs_pindah_salinLangkah pertama pindah ke server lain: menyalin situs langsung ke server tujuan (boleh dengan PHP lain, opsional pembaruan WordPress dengan kembali otomatis). Situs lama tetap berjalan.
situs_ubah_siapkanLangkah 1 dari 2 untuk aksi yang mengganti isi situs: pulihkan, hapus, pindah_sekarang (situs lama pemeliharaan sebentar, situs aktif di server baru), pindah_selesai (hapus di server lama setelah DNS mengarah), atau pindah_batal. Menghasilkan pratinjau dan token konfirmasi (10 menit).
situs_ubahLangkah 2 dari 2: menjalankan aksi itu dengan token, hanya setelah Anda menyetujui pratinjau.
fitur_usulkanMengirim usulan fitur ke tim Saka bila Anda butuh sesuatu yang belum bisa dilakukan Saka. Agent wajib menunjukkan draf judul dan isinya kepada Anda, dan mengirim hanya setelah Anda setuju.
katalog_daftar, situs_perbarui_aplikasiAplikasi siap pakai: lihat daftar aplikasi sekali klik (pasang dengan situs_buat jenis katalog) dan perbarui ke versi terbaru dengan cadangan dulu. Lihat Aplikasi siap pakai.
situs_deploy, situs_rollback, situs_env, situs_email_ujiAplikasi dari Git: deploy commit terbaru (tanpa jeda), kembali ke rilis sebelumnya, atur variabel lingkungan (rahasia acak dibuat di server tanpa ditampilkan), dan kirim email uji dengan pengaturan SMTP aplikasi. Lihat Aplikasi dari Git.
tunnel_daftar, tunnel_buat, tunnel_hapusAlamat publik gratis <nama>-app.hack.id untuk situs atau aplikasi web di server tanpa IP publik (server rumah). Menghapus butuh konfirmasi nama. Lihat Server rumah & tunnel.
vpnVPN WireGuard tim: daftar, pasang di server, tambah perangkat (split atau penuh; konfigurasi berkunci rahasia hanya diberikan sekali), cabut, hapus.
riwayat_aksiRiwayat aksi akun: siapa mengubah apa, termasuk agent AI lewat MCP. Hanya membaca.
situs_periksa_aplikasiPeriksa aplikasi Git: rahasia di repo, variabel lingkungan kurang, alamat terbuka tanpa login. Hanya membaca.
cloud_akun_daftar, cloud_pilihan, server_buat, cloud_server_daftarMembuat server baru dari akun DigitalOcean, Vultr, atau IDCloudHost yang sudah Anda hubungkan: lihat lokasi dan ukuran, buat server (Saka terpasang otomatis), lalu pantau sampai tersambung. Token akun hanya ditambahkan lewat panel, tidak lewat chat. Lihat Buat server dari akun cloud.
server_ganti_nama, server_port, server_logGanti nama tampilan server, lihat port yang terbuka beserta programnya, dan baca ekor log sistem. Dibaca langsung dari server, tanpa shell.
aplikasi_telegramMenambahkan bot Telegram ke Hermes atau OpenClaw yang sudah terpasang, atau mengganti token bot. Data aplikasi tetap; bila gagal, aplikasi dikembalikan seperti semula.
aplikasi_pindah, dokploy_pindahPindah ke Saka: OpenClaw dan Hermes ke VPS lain, serta aplikasi dan situs dari Dokploy, Coolify, aaPanel, dan CyberPanel (platform), termasuk database berdiri sendiri ke klaster (klaster). Lihat Pindah ke Saka.
situs_git_databaseDatabase khusus aplikasi Git (PostgreSQL, MySQL, MariaDB, MongoDB, Redis) sekali klik. Lihat Database untuk aplikasi Git.
database_cadangan_status, database_pulihkan, database_salinan_tabel, database_salinan_ambil, database_salinan_hapusCadangan database ke S3 Anda: lihat keadaan dan rentang waktu yang bisa dipulihkan, pulihkan ke waktu tertentu sebagai salinan terpisah, bandingkan tabelnya dengan database sekarang, ambil tabel yang perlu (ke tempat terpisah, atau menimpa dengan persetujuan Anda), lalu hapus salinan. Lihat Cadangan & pulih.
situs_proses, situs_cron_jalankan, situs_log, situs_pratinjau, situs_lokasi_keduaAplikasi dari Git lebih lanjut: worker dan cron, jalankan cron sekarang, baca log (aplikasi, build, worker, web), pratinjau pull request dengan database sendiri per PR, dan salinan di lokasi kedua agar tetap jalan saat satu server atau region mati.
armada_daftar, armada_buat, armada_status, armada_deploy, armada_envAplikasi Git yang sama di banyak server: kelompokkan jadi satu grup, deploy bertahap (satu server percobaan dulu, lalu bergelombang, berhenti sendiri bila banyak yang gagal), dan ubah variabel bersama. Lihat Deploy massal.
cadangan_s3_masa_simpanMengubah berapa hari cadangan situs disimpan di S3 (1 sampai 3650) agar bucket tidak menumpuk; yang terbaru tiap situs selalu disimpan. Agent wajib mengonfirmasi dulu bila memperpendek. Lihat Cadangan ke S3.
pantau_luar, laporan_bulananPantau URL/API di luar Saka (daftar, tambah dengan kata kunci atau kode HTTP, hapus), dan laporan bulanan akun (ketersediaan, bandwidth, keamanan). Lihat Pantau alamat di luar Saka.
pantau_daftarHasil pemantauan dari internet untuk semua situs, tunnel, dan load balancer (bisa dibuka atau tidak, sejak kapan, uptime 30 hari), plus daftar halaman status publik.
server_cloud, server_snapshot, server_ubah_ukuran, server_hapus_cloudVM server di akun cloud: lihat penyedia, ukuran, dan snapshot; buat snapshot; ubah ukuran (dengan persetujuan Anda); hapus VM di penyedia sekaligus dari Saka (harus dikonfirmasi dengan nama server). Lihat Snapshot, ubah ukuran, dan hapus.
k8s_daftar, k8s_status, k8s_buat, k8s_adopsi, k8s_aplikasi, k8s_terapkan, k8s_hapus, k8s_log, k8s_cadangan, k8s_gitKubernetes: daftar dan keadaan klaster (node, workload, pod bermasalah), buat klaster dari server kosong atau adopsi klaster k3s yang ada, deploy aplikasi dengan HTTPS tanpa YAML, terapkan YAML, hapus resource, baca log, snapshot etcd, serta aplikasi dari repo Git (build di klaster, rilis ulang, kembali ke rilis lama, variabel, jumlah salinan & skala otomatis, database sekali klik, pratinjau per cabang). Aksi yang mengubah klaster wajib persetujuan Anda.
email_dns_cekPeriksa DNS email domain pengirim (SPF, DKIM, DMARC, MX) dan beri saran record yang perlu ditambahkan pengguna di penyedia DNS-nya. Baca saja. Lihat Email keluar.
berkas_daftar, berkas_baca, berkas_ubahFile manager situs: daftar isi folder dan tempat sampah, baca berkas teks, serta tulis, buat folder, ganti nama, hapus ke tempat sampah, pulihkan, dan ekstrak zip (dengan persetujuan Anda).
wp_keamanan, wp_kuatkan, wp_perbarui, wp_nonaktifkan_plugin, wp_pasang_ulang, wp_staging, situs_karantinaWordPress: skor keamanan, kerentanan yang diketahui (CVE) untuk versi terpasang, daftar pengamanan yang bisa diperbaiki satu per satu, periksa keamanan (versi tertinggal, plugin yang ditutup karena masalah keamanan, berkas yang diubah penyusup, sisipan judi online dan pintu belakang PHP, juga untuk situs PHP), karantina berkas sisipan yang bisa dikembalikan, pasang ulang berkas asli, perbarui dengan cadangan & kembali otomatis atau di staging dulu, nonaktifkan plugin, serta buat, terapkan, dan hapus staging. Aksi yang mengubah situs utama butuh persetujuan Anda. Lihat Keamanan & staging WordPress.
perisai_status, perisai_atur, perisai_lepasPerisai Saka: lihat IP yang diblok beserta alasannya dan temuan WAF; nyalakan/matikan, ubah pengecualian, batas laju, blok negara, dan mode WAF OWASP (dengan persetujuan Anda); lepas blok. Lihat Perisai Saka.
tugas_pantau_daftar, tugas_pantau_buat, tugas_pantau_hapusPantau tugas terjadwal lewat alamat ping (heartbeat): daftar beserta keadaannya, buat pemantau baru (agent AI bisa sekaligus menambahkan perintah curl ke crontab Anda), dan hapus. Lihat Pantau tugas terjadwal.
tugas_statusKeadaan tugas yang berjalan lama (misalnya pemasangan aplikasi).
peringatan_aktifMasalah yang sedang terjadi di semua server (terputus, disk penuh, aplikasi berhenti).
database_tambah_nodeMenambah server data baru ke klaster PostgreSQL yang berjalan sebagai replika (cadangan S3 ikut disalin).
database_jadikan_utamaPeralihan terencana peran utama ke replika lain lewat Patroni.
database_diagnosaBukti baca-saja keadaan node klaster dan dugaan masalahnya.
database_ubah_modeMengganti mode replikasi sinkron atau asinkron.
database_aksesMengizinkan atau mencabut alamat IP yang boleh menjangkau port database.
jaringan_periksaPra-periksa server dan jaringan UDP/TCP antar server sebelum membuat klaster, beserta waktu tempuh.
dns_failover_daftarDaftar pengalihan DNS satu klik dan record yang sedang aktif.
dns_failover_alihkanMengalihkan A record ke server cadangan atau kembali ke utama.
dns_failover_gladiGladi pengalihan: alihkan sungguhan, ukur konvergensi resolver, periksa standby, lalu kembalikan.
s3_tujuan_ujiMenguji tujuan S3 yang disimpan sebelum dipakai untuk cadangan.
pantau_uji_alarmMengirim pesan percobaan lewat saluran alarm (Telegram atau email) untuk memastikan alarm sampai.

Pantau egress. Alat aplikasi_egress (dan GET /api/v1/server/{id}/aplikasi/{nama}/egress) menampilkan alamat internet yang dihubungi kontainer aplikasi (OpenClaw, Hermes, dst.): IP, port, nama balik bila ada, kapan pertama dan terakhir terlihat. Hanya mengamati, tidak memblokir, sehingga tidak bisa membuat bot berhenti. Dibaca dari tabel koneksi kernel; tidak ada aturan firewall yang diubah. Tujuan yang tidak terlihat 30 hari dibuang. Koneksi ke alamat privat dan loopback tidak dicatat.

Batas egress. Dari pemantauan itu Anda bisa membatasi ke mana aplikasi boleh mengirim data. Alat aplikasi_egress_batas (GET /api/v1/server/{id}/aplikasi/{nama}/egress/batas) membaca mode, daftar izin, tujuan yang terlihat, dan yang diblokir. Alat aplikasi_egress_atur (PUT di jalur yang sama dengan {mode, izin, uji_menit}) mengaturnya; alat ini masuk daftar yang butuh persetujuan Telegram bila Anda mengaktifkannya. Tiga mode per aplikasi: pantau (bawaan, tanpa aturan firewall), simulasi (aplikasi tetap normal, Saka hanya mencatat yang AKAN diblokir), dan batasi (koneksi ke internet di luar daftar izin ditolak seketika). Daftar izin berisi domain (nama lengkap tanpa wildcard, diterjemahkan ke IP tiap menit dan IP lama dipakai 10 menit lagi), alamat IP, atau blok IP (minimal /8), dengan port dan protokol opsional. Alamat privat, balasan atas koneksi masuk, dan DNS server selalu boleh; IPv6 tidak dicakup. Saka memverifikasi dari dalam jaringan kontainer bahwa aturan benar-benar berlaku dan membatalkan mode batasi sendiri bila tidak. Dengan uji_menit (disarankan 10) mode batasi kembali ke simulasi sendiri bila tidak dikukuhkan ulang. Aturan dipasang di rantai DOCKER-USER dan dipulihkan otomatis bila firewall dibilas atau kontainer dibuat ulang (sampai 5 detik). Alur aman: simulasi beberapa hari, lengkapi daftar dari yang tercatat, lalu batasi dengan uji 10 menit. Nama domain: Saka membaca jawaban DNS (UDP/53) yang diterima kontainer secara pasif dan menampilkan nama yang ditanyakan aplikasi (field domain) di samping IP, di daftar alamat, diizinkan, dan diblokir; tombol Izinkan domain menambahkannya ke daftar izin. DNS lewat TCP, DoH, atau DoT tidak terlihat, jadi daftarnya tetap IP saja. Preset siap pakai (Telegram, WhatsApp, Discord, Slack, OpenAI, Anthropic, Google Gemini, OpenRouter, DeepSeek, Groq, Mistral, xAI, Together, Perplexity, GitHub, npm dan pip): daftar lewat aplikasi_egress_preset (GET /api/v1/egress/preset), dipakai dengan argumen preset (id) di aplikasi_egress_atur atau di isi PUT. Wildcard tidak didukung, jadi media WhatsApp (nama server CDN yang berganti) perlu ditambah dari yang tercatat saat simulasi. Di panel: kartu Batasi alamat yang boleh dihubungi di bawah kartu alamat internet, dengan tombol preset.

Daftar rute API. GET /api/v1/rute (dan alat MCP rute_api) memberi daftar semua rute REST yang terbaca mesin: metode, jalur, parameter jalur, kelompok, dan jenis akses (publik, masuk, atau admin; rute admin hanya tampil bagi admin). Saring dengan ?kelompok=situs atau ?q=egress. Daftar dihasilkan dari kode dan dijaga tes agar tidak tertinggal. Daftar ini belum memuat skema isi permintaan; untuk bentuk isian, lihat alat MCP padanannya lewat tools/list.

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.