Docs — Handlify

Ringkasan

Handlify men-deploy app yang dibuatkan Claude untukmu — langsung ke infra Qiscus. Cukup minta lewat chat Claude, atau pakai dashboard ini. Tanpa server yang perlu diurus, tanpa Git, tanpa antre ke ops.

Tiap app dapat URL live https://<id>.handlify.qiscus.io. Kamu bisa mengatur siapa yang boleh membuka (private / tim / siapa saja), memasang custom domain, mengisi env secret, dan redeploy — semuanya dari chat atau dashboard.

Mulai cepat

Buka chat Claude yang tersambung ke connector Qiscus Builder.
Deskripsikan app yang kamu mau. Claude yang generate file-nya dan men-deploy.
URL live keluar dalam ~20–40 detik.

Kamu: bikinkan landing page hitung mundur untuk hackathon Q3 dengan form daftar,
      lalu deploy.

Di balik layar Claude memakai deploy_project dan membalas dengan URL-nya. Iterasi cukup dengan minta perubahan — otomatis redeploy di URL yang sama.

Deploy app

Kode yang di-generate Claude

Jalur paling umum. Claude menulis file-nya dan men-deploy langsung — tanpa repo git. Situs statis (HTML/CSS/JS) atau app Node. Kalau app butuh database, PostgreSQL terkelola otomatis disediakan dan DATABASE_URL-nya disuntik otomatis (kredensial tidak pernah ditampilkan).

Dari repo Git publik

Minta Claude meng-import repo-nya — kasih URL https:// publik, otomatis di-deploy via create_app_from_repo. Bisa juga lewat Handlify CLI.

Dari repo Git privat

Tambahkan deploy key SSH di halaman Deploy keys, pasang public key-nya sebagai deploy key read-only di repo, lalu minta Claude men-deploy URL SSH-nya. Repo multi-service di-deploy via docker-compose. Repo di Forgejo internal pakai deploy key bersama — tanpa setup per-repo.

Kelola app

Buka sebuah app dari Apps untuk mengelolanya. Dari dashboard kamu bisa:

Environment secrets — tambah/hapus env var (nilainya write-only, tidak pernah ditampilkan lagi), lalu Apply & redeploy.
Custom domain — sajikan app dari domain milikmu sendiri.
Access — pilih siapa yang boleh membuka URL (lihat bawah).
Deployments & logs — riwayat build + log container.
Ownership — serahkan app ke orang lain (lihat bawah).
Danger zone — hapus app permanen.

Atau dari chat: get_app, get_logs, restart_app, deploy_app, update_project, delete_project.

Auto-sleep & keep-awake — app yang tanpa traffic ~72 jam otomatis ditidurkan untuk hemat resource dan bangun sendiri saat request berikutnya (cold start beberapa detik), jadi biasanya kamu nggak perlu ngapa-ngapain. Butuh app tetap nyala pas periode sibuk (kuis mingguan, demo terjadwal)? Pin Keep awake di kartu app (berjangka, maks 14 hari, bisa diperpanjang) atau dari chat set_keep_awake.

Akses URL

Atur siapa yang boleh membuka URL app. Ubah dari kartu Access app, atau dari chat dengan set_access / get_access. Perubahan langsung berlaku — tanpa redeploy.

private — cuma kamu (pemiliknya).
team — allow-list email tertentu atau seluruh domain (mis. qiscus.com).
company — siapa saja dengan akun @qiscus.com.
public — siapa saja yang punya link.
password — publik, digembok password bersama.

Ini beda dengan kepemilikan app. Satu app punya SATU owner — hanya dia yang bisa deploy, mengatur, atau menghapusnya. Menambahkan orang ke team cuma memberi izin membuka URL. Kalau mau orang lain bisa deploy, serahkan app-nya: kartu Ownership, transfer_owner dari chat, atau handlify transfer <uuid> <email>.

Kamu: buat gate-demo-b1c229 hanya bisa diakses andi@qiscus.com dan aku

Password & secret: password URL bisa diset di dashboard (disarankan) atau dikirim inline via chat — kalau dikirim lewat chat, akan muncul di transkrip. Selalu disimpan salted-hash, tidak pernah plain text. Nilai env secret, API key, dan deploy key privat hanya lewat dashboard dan tidak pernah lewat chat.

Custom domain

Di kartu Custom domain app: tambahkan domain milikmu, arahkan DNS-nya (record CNAME atau A) ke handlify.qiscus.io, klik Check DNS, lalu Apply to this app. App kemudian tersaji di domainmu berdampingan dengan URL bawaan.

Sambungkan klien

Selain connector Claude.ai (yang pakai login Google), MCP ini bisa dipanggil dari CLI atau script pakai API key pribadi. Buat satu di Settings → API keys, lalu arahkan klien ke endpoint dengan header Bearer:

Claude Code

claude mcp add --transport http qiscus-builder \
  https://qiscus-coolify-mcp.qiscus.io/mcp \
  --header "Authorization: Bearer <your-key>"

Codex / other CLIs (via the mcp-remote bridge)

[mcp_servers.qiscus-builder]
command = "npx"
args = ["-y", "mcp-remote", "https://qiscus-coolify-mcp.qiscus.io/mcp", "--header", "Authorization: Bearer <your-key>"]

Cursor / generic JSON MCP config

{
  "mcpServers": {
    "qiscus-builder": { "url": "https://qiscus-coolify-mcp.qiscus.io/mcp", "headers": { "Authorization": "Bearer <your-key>" } }
  }
}

Key di-scope seperti dashboard (hanya app milikmu) dan bisa dicabut kapan saja.

MCP tools

`list_apps` / `get_app`	Daftar app-mu / detail satu app.
`get_logs` / `list_deployments_for_app`	Log container / riwayat deploy.
`deploy_project`	Deploy kode yang di-generate Claude (static/node, DB opsional).
`create_app_from_repo` / `deploy_private_repo`	Deploy dari repo git publik / privat.
`update_project` / `deploy_app` / `restart_app`	Redeploy / trigger / restart.
`get_access` / `set_access`	Baca / atur siapa yang boleh membuka URL.
`manage_secrets`	Dapatkan link dashboard untuk mengisi env secret out-of-band.
`transfer_owner`	Serahkan app ke user lain — satu app satu owner, dan owner-lah yang boleh deploy (owner/admin).
`delete_project`	Hapus app (owner/admin).

Roles

viewer — read-only (list/get/logs) + baca level akses.
developer — viewer + deploy, restart, update, delete, kelola secret, set access.
admin — semuanya.

Kamu hanya melihat & mengelola app milikmu sendiri (admin melihat semua). Role per-email.