# Cara Menggunakan Insforge di Zeabur

> Cara termudah untuk memberi Agen AI Anda backend yang siap produksi.

Kami baru saja mengumumkan [kemitraan strategis](https://zeabur.com/blogs/zeabur-insforge-partnerships) dengan **InsForge**, *Backend-as-a-Service* (BaaS) terkemuka yang dirancang khusus untuk agen coding AI.

Anda bisa membuat frontend React yang indah dalam hitungan detik, tetapi meminta AI untuk "menyiapkan database yang aman, mengonfigurasi autentikasi, dan men-deploy API" sering kali berakhir dengan kekacauan Dockerfile dan file konfigurasi yang rusak. Hal ini mengganggu alur kerja (*flow*) Anda.

**Di sinilah [Insforge](https://insforge.dev/) di Zeabur mengubah permainan.**

Insforge adalah backend AI-native yang dirancang untuk dikelola oleh agen (via MCP), dan Zeabur adalah platform deployment AI-native yang menangani infrastrukturnya. Bersama-sama, mereka memungkinkan Anda beralih dari "Ide" ke "Full-Stack Deployment" tanpa meninggalkan editor kode Anda.

Dalam panduan ini, kami akan menunjukkan cara men-deploy Insforge di Zeabur dalam satu klik dan menghubungkannya ke editor kode AI Anda.

## Prasyarat

- [Akun Zeabur](https://zeabur.com/) (Anda bisa mulai secara gratis).
- Editor Kode AI yang mendukung MCP (seperti **Cursor** atau **Antigravity**).

---

## Langkah 1: Deploy dari Integrasi Zeabur

Masalah terbesar dalam pengembangan backend adalah pengaturan awal. Zeabur menghilangkan masalah ini dengan Integrasi pra-konfigurasi.

1. Masuk ke [**Dashboard Zeabur**](https://zeabur.com/login) Anda.
2. Buat **Project Baru** (atau pilih yang sudah ada).
3. Klik **Add Integration** → **Insforge**.
4. Klik **Enable Insforge**.

![Enable Insforge button](https://cdn.zeabur.com/insforge%20partnerships/Enable%20Insforge%20button.png)

**Inilah bagian "Pengalaman Pengembang yang Lebih Baik":**
Saat Anda mengklik install, Zeabur tidak hanya men-deploy container Insforge. Zeabur secara otomatis membuat **layanan PostgreSQL** baru dan menautkannya ke Insforge secara internal. Anda tidak perlu menyalin *connection string* atau mengonfigurasi port jaringan secara manual. Zeabur menangani orkestrasi untuk Anda.

Tunggu beberapa detik hingga layanan berubah menjadi hijau (Running).

---

## Langkah 2: Hubungkan Agen AI Anda (Pengaturan MCP)

Setelah layanan Insforge Anda ter-deploy, Anda memerlukan detail koneksi untuk menautkannya ke editor AI (MCP) atau aplikasi frontend Anda. Zeabur membuat halaman informasi khusus untuk ini.

Ada dua cara mudah untuk mengakses informasi ini:

### Metode 1: Tautan Layanan Langsung (Disarankan)

Di tampilan Project Zeabur Anda, cari **ikon Insforge** yang terletak tepat di bawah tombol "Add Service".

![Insforge Link](https://cdn.zeabur.com/insforge%20partnerships/insforge%20icon.png)

Mengklik ikon ini akan mengarahkan Anda ke **Halaman Informasi Insforge** khusus. Halaman ini berisi:

- **Informasi Proyek:** Status instance dan detail dasar Anda.
- **Panduan Koneksi MCP:** Perintah tepat yang perlu Anda *copy-paste* ke Cursor atau Windsurf.
- **Connection Strings:** URL database dan endpoint API untuk frontend Anda.

### Metode 2: Halaman Integrasi

Atau, Anda dapat mengakses detail ini melalui pengaturan layanan:

1. Klik pada **layanan Insforge** di peta proyek Anda.
2. Arahkan ke tab **Integrations** (atau halaman Instruksi tergantung versi template).
3. Di sini Anda akan menemukan set kredensial dan panduan koneksi yang sama.

![Zeabur Integration Page](https://cdn.zeabur.com/insforge%20partnerships/Zeabur%20integration%20page%20with%20insforge%20.png)

### Konfigurasi Cursor / Antigravity

**Untuk Deploy MCP Satu Klik:**

**Untuk Cursor**: Klik Tombol `Add to Cursor`.

![one click use insforge](https://cdn.zeabur.com/insforge%20partnerships/one%20click%20use%20insforge.png)

**Untuk Konfigurasi Manual:**
→ Buka pengaturan editor Anda.

- **Untuk Cursor:** Pergi ke `Cursor Settings` > `Features` > `MCP Servers` > `+ Add New`.
- **Untuk Antigravity:** Pergi ke Terminal dan masukkan perintah (Anda dapat menemukan ini di **Dashboard Insforge**).

![Connect Project](https://cdn.zeabur.com/insforge%20partnerships/Connect%20Project.png)

```jsx
npx @insforge/install 
--client antigravity 
--env API_KEY=ik_xxxxxxxxxxxxxx
--env API_BASE_URL=https://xxxxx.ap-southeast.insforge.app`.
```

Pilih **"SSE"** (Server-Sent Events) atau mode Command tergantung preferensi Anda, tetapi cara termudah untuk terhubung adalah menggunakan jembatan `npx` yang disediakan oleh Insforge.

Tambahkan konfigurasi ini ke file konfigurasi MCP Anda:

Anda dapat menemukan halaman ini di **Dashboard Insforge** atau halaman **Integrasi Zeabur Insforge**.

![Insforge MCP JSON](https://cdn.zeabur.com/insforge%20partnerships/Insforge%20MCP%20JSON.png)

![Zeabur Dashboard MCP JSON](https://cdn.zeabur.com/insforge%20partnerships/Zeabur%20Dashboard%20MCP%20JSON.png)

```json
{
  "mcpServers": {
    "insforge": {
      "command": "npx",
      "args": [
        "-y",
        "@insforge/mcp@latest"
      ],
      "env": {
        "API_KEY": "api_key_insforge_anda",
        "API_BASE_URL": "https://API_BASE_URL.insforge.app"
      }
    }
  }
}
```

*Ganti URL dan API Key dengan detail deployment Zeabur Anda yang sebenarnya.*

**Mengapa ini meningkatkan Pengalaman Pengembang:**
Zeabur menampilkan **Perintah Instalasi MCP** langsung di halaman-halaman ini. Anda tidak perlu membuat konfigurasi JSON secara manual atau menebak URL-nya—cukup salin perintah yang disediakan di layar.

---

## Langkah 3: Akses Detail Koneksi & Kredensial (Opsional)

Ini adalah langkah ajaibnya. Backend standar mengharuskan Anda membaca dokumentasi dan menulis SQL. Insforge menyediakan server **Model Context Protocol (MCP)**, yang memungkinkan editor AI Anda (Cursor/Windsurf) untuk "berbicara" langsung dengan database Anda.

**Cara yang Disarankan: Ikuti Panduan Langkah-demi-Langkah Kami**

Untuk menyederhanakan proses, kami telah membuat panduan instalasi langkah demi langkah untuk setiap agen AI. Anda dapat menemukan panduan ini di [dokumentasi](https://www.notion.so/How-to-Use-Insforge-on-Zeabur-2e8a221c948e8044a115ffd8540bdb04?pvs=21) kami.

### Dapatkan Kredensial Anda

1. Di Dashboard Zeabur, buka tab **Integration** pada layanan Insforge Anda.
2. Catat URL Domain Anda (misalnya, `https://xxxxx.ap-southeast.insforge.app`).
    
    ![zeabur dashboard acquire insforge credentials](https://cdn.zeabur.com/insforge%20partnerships/CleanShot%202026-01-15%20at%2016.20.49%402x.png)
    
3. Di dalam Dashboard Admin Insforge, buka **Project Settings** -> **Connect** dan dapatkan Connection String.
    
    ![connection strings](https://cdn.zeabur.com/insforge%20partnerships/connection%20strings.png)

---

## Langkah 4: Tes "Hello World"

Sekarang setelah agen Anda terhubung ke infrastruktur Zeabur, mari kita tes koneksinya. Kekuatan Insforge adalah AI Anda dapat membaca manualnya sendiri.

Buka Chat AI Anda (Command+L / Ctrl+L) dan ketik:

> "I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions."

**Lihat apa yang terjadi:**

1.  **Aktivasi Alat:** AI akan memverifikasi bahwa ia memiliki akses ke server MCP `insforge` dan memicu alat `fetch-docs`.
2.  **Penyerapan Konteks:** AI akan mengunduh dan membaca dokumentasi Insforge langsung dari instance Zeabur Anda, mempelajari cara membuat tabel, mengelola autentikasi, dan menangani data.
3.  **Konfirmasi:** AI akan mengonfirmasi bahwa ia memahami API Insforge dan siap untuk membangun.

Anda sekarang melakukan "Vibe Coding". Agen Anda telah membaca dokumentasi untuk Anda. Anda sekarang dapat melanjutkan dengan perintah seperti *"Create a 'Todos' table"* dan ia akan tahu persis cara mengeksekusinya di database Zeabur Anda.

---

## Mengapa Zeabur adalah Rumah Terbaik untuk Insforge

Anda mungkin bertanya, "Mengapa tidak menjalankannya secara lokal saja?" atau "Mengapa Zeabur?".

1.  **Integrasi Backend Tanpa Repot:** Dengan menghubungkan Insforge ke Zeabur, seluruh backend ditangani untuk Anda. Agen coding AI Anda menjadi pembangun full-stack.
2.  **Dari Ide ke Peluncuran dengan Prompt:** Zeabur mengurus semuanya, termasuk deployment situs.
3.  **Zero-Config Networking:** Komunikasi antara Insforge dan Postgres terjadi melalui **jaringan internal pribadi** di Zeabur. Ini aman, sangat cepat, dan tidak memerlukan pengaturan.
4.  **Persisten & Skalabel:** Localhost hanya untuk prototipe. Dengan men-deploy di Zeabur, agen AI Anda membangun di atas infrastruktur *production* sejak hari pertama.
5.  **Hemat Biaya:** Model harga berbasis penggunaan Zeabur berarti Anda hanya membayar untuk CPU/RAM yang benar-benar Anda gunakan.
6.  **Tanpa Pusing DevOps:** Jika server mati, Zeabur me-restart-nya. Anda tetap menjadi developer, bukan sysadmin.

### **Pertanyaan yang Sering Diajukan (FAQ)**

**1. Apa bedanya Insforge dengan Supabase atau Firebase?**
Insforge adalah **"Agent-First."** Backend standar dirancang untuk manusia. Insforge dirancang dengan **MCP** sebagai intinya, memungkinkan agen AI memahami database Anda secara mandiri.

**2. Berapa biayanya di Zeabur?**
Zeabur menggunakan **harga berbasis penggunaan**. Untuk proyek awal dengan Insforge dan PostgreSQL, biayanya sangat rendah (seringkali hanya beberapa dolar per bulan).

**3. Bisakah saya terhubung ke Database secara langsung?**
**Ya.** Anda dapat menemukan connection string eksternal di dashboard Zeabur dan terhubung menggunakan alat seperti **TablePlus, DBeaver, atau Prisma**.

**4. Apakah saya harus menggunakan Editor AI untuk menggunakan Insforge?**
**Tidak.** Insforge dilengkapi dengan **GUI Dashboard Admin** lengkap. Anda dapat mengelola tabel dan pengguna secara manual melalui browser.

**5. Apakah data saya aman?**
Ya. Zeabur mengisolasi layanan Anda dalam jaringan pribadi. Komunikasi database terjadi secara internal.

**6. Bisakah saya memigrasikan data saya nanti?**
Tentu saja. Karena Zeabur menyediakan database PostgreSQL standar, Anda dapat melakukan `pg_dump` untuk mengekspor data Anda kapan saja.

## Kesimpulan

Kombinasi **Insforge** (Backend AI-Native) dan **Zeabur** (Deployment AI-Native) menghilangkan hambatan dari pengembangan aplikasi modern.

Dengan mengikuti panduan ini, Anda telah mengatur stack di mana:
- **Zeabur** mengelola server.
- **Insforge** mengelola logika database.
- **Agen AI Anda** menulis kodenya.

Anda sekarang bebas untuk fokus sepenuhnya membangun produk yang hebat.

**Deploy Insforge di Zeabur Sekarang**
<video src="https://cdn-console.zeabur.com/f/brrUV/insforge%20demo.mov" controls />
