# Biznet Gio — Agent & MCP quickstart

Ringkasan untuk manusia dan agent. Versi halaman: [agents.html](agents.html). Semua fakta di bawah berasal dari sumber resmi Biznet Gio dan paket `@biznetgio/mcp` versi 1.2.0 (diperiksa November 2026).

## Pilih jalur yang benar

| Kebutuhan | Produk | Cara terhubung | Setup publik |
|---|---|---|---|
| Deploy aplikasi dari coding agent | NEO App Platform | MCP dari Cursor, Claude, atau Windsurf | Detail koneksi MCP belum dipublikasikan; minta ke support. Akun: [daftar & buat NEO App](https://portal.biznetgio.com/user/register?sourcebn=neo-app&next=%2Fplatform%2Fneo-app%2Fcreate) |
| Kelola infrastruktur dari AI client | Server MCP `@biznetgio/mcp` | Server stdio lokal + API key Portal | Lihat di bawah |
| Menjalankan agent sendiri | VPS (OpenClaw, Hermes Agent, n8n) | SSH/console ke VPS Anda | [VPS OpenClaw](https://www.biznetgio.com/product/vps-openclaw) |
| Bantuan AI untuk VPS di Cloud Portal | AI Console (NEO Lite, NEO Lite Pro) | Panel chat di Cloud Portal | [AI Console](https://www.biznetgio.com/blog/ai-console-vps-biznet/) |
| API model AI | NEO Inference | Access key per proyek, dengan batas kredit | [Panduan NEO Inference](https://kb.biznetgio.com/id_ID/neo-inference/cara-menggunakan-layanan-neo-inference) |

Server MCP infrastruktur **tidak** mencakup NEO App.

## Server MCP infrastruktur (`@biznetgio/mcp`)

- Kode sumber: https://github.com/BiznetGIO/biznetgio-cli (lisensi MIT)
- Paket: https://www.npmjs.com/package/@biznetgio/mcp
- Layanan: NEO Lite, NEO Lite Pro, NEO Metal, NEO Elastic Storage, NEO Metal Additional IP, NEO Object Storage
- Cara kerja: `npx` menjalankan server di komputer Anda (transport stdio). Setiap tool memanggil `https://api.portal.biznetgio.com/v1` dengan API key di header `x-token`.

### Prasyarat

1. Akun Cloud Portal Biznet Gio.
2. API key dari menu **Generate API Key** di Cloud Portal. Key hanya dapat digenerate sekali; key yang hilang diminta ulang ke support. Panduan: https://kb.biznetgio.com/id_ID/api/menggunakan-api-portal-biznet-gio-untuk-layanan-neo-lite
3. Node.js 18 atau lebih baru.
4. AI client yang mendukung server MCP lokal (stdio).

### Konfigurasi

Simpan key di variabel lingkungan `BIZNETGIO_API_KEY`. Jangan menulis key di repository, chat, atau kode publik.

Claude Code (terminal, scope local):

```bash
claude mcp add --env BIZNETGIO_API_KEY="$BIZNETGIO_API_KEY" --transport stdio biznetgio -- npx -y @biznetgio/mcp@latest
```

Claude Code (`.mcp.json` untuk tim, key dibaca dari environment):

```json
{
  "mcpServers": {
    "biznetgio": {
      "command": "npx",
      "args": ["-y", "@biznetgio/mcp@latest"],
      "env": { "BIZNETGIO_API_KEY": "${BIZNETGIO_API_KEY}" }
    }
  }
}
```

Claude Desktop (`claude_desktop_config.json`, mulai ulang aplikasi setelahnya):

```json
{
  "mcpServers": {
    "biznetgio": {
      "command": "npx",
      "args": ["-y", "@biznetgio/mcp@latest"],
      "env": { "BIZNETGIO_API_KEY": "API_KEY_ANDA" }
    }
  }
}
```

Cursor (`.cursor/mcp.json` atau `~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "biznetgio": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@biznetgio/mcp@latest"],
      "env": { "BIZNETGIO_API_KEY": "${env:BIZNETGIO_API_KEY}" }
    }
  }
}
```

Client lain (termasuk Windsurf): `command` = `npx`, `args` = `-y @biznetgio/mcp@latest`, `env` = `BIZNETGIO_API_KEY`. Lokasi file mengikuti dokumentasi client.

Menambahkan server tidak membuat atau mengubah resource apa pun.

## Uji koneksi dan tugas pertama

Server yang aktif belum membuktikan key valid: key dibaca saat tool dipanggil.

1. Cek server: `claude mcp list` atau `/mcp` (Claude Code); daftar server/tool di Customize dan Output › MCP Logs (Cursor).
2. Kirim prompt yang hanya membaca:

   > Pakai server biznetgio untuk menampilkan daftar layanan NEO Lite Pro di akun saya. Jangan membuat, mengubah, atau menghapus apa pun.

3. Tool yang diharapkan: `neolite_pro_list` (GET `/neolite-pros/accounts`).

| Hasil | Artinya | Langkah berikutnya |
|---|---|---|
| JSON berisi akun dan status | Key valid, akun terbaca | Cocokkan ID dengan Cloud Portal |
| Daftar kosong | Key valid, belum ada NEO Lite Pro | Coba `neolite_list`, `metal_list`, `object_storage_list` |
| `Error: API Error 4xx` | Portal API menolak key | Periksa key; minta key baru ke support |
| `Error: API key not set` | `BIZNETGIO_API_KEY` kosong di proses server | Set variabel, mulai ulang client |
| `Error: fetch failed` | Server tidak menjangkau `api.portal.biznetgio.com` | Periksa jaringan, proxy, atau firewall; cek https://status.biznetgio.com/ |

## Jenis aksi

| Jenis | Contoh tool | Dampak |
|---|---|---|
| Baca | `neolite_pro_list`, `neolite_pro_vm_details`, `metal_state`, `object_storage_bucket_usage` | Tidak mengubah layanan |
| Ubah | `neolite_pro_set_state`, `neolite_pro_rename`, `neolite_pro_snapshot_restore`, `object_storage_bucket_set_acl` | Mengubah layanan berjalan atau akses data |
| Berbiaya | `neolite_pro_create`, `neolite_pro_upgrade_storage`, `neolite_pro_change_package`, `object_storage_create` | Membuat atau menambah resource yang ditagih |
| Hapus | `neolite_pro_delete`, `metal_delete`, `object_storage_object_delete` | Menghapus layanan atau data |

Server MCP ini tidak membaca log di dalam VM; gunakan AI Console atau SSH.

## Akses dan kontrol

- Dokumentasi publik tidak menyebutkan scope atau batas izin per API key. Anggap key setara akses akun Anda untuk layanan yang didukung.
- Persetujuan sebelum tool berjalan diatur oleh AI client (mis. Cursor meminta persetujuan secara bawaan), bukan oleh Biznet Gio. Mode auto-run dapat melewatinya.
- Portal API menjalankan permintaan dengan key valid; belum ada langkah persetujuan tambahan dari sisi Biznet Gio yang terdokumentasi.
- Versi 1.2.0 belum memberi anotasi read-only pada tool.
- Pencabutan key secara mandiri belum terdokumentasi. Jika key bocor: support@biznetgio.com atau (021) 5714567.

## NEO App (Chat-to-Deploy)

- Client yang disebut resmi: Cursor, Claude, Windsurf. Kemampuan via MCP: deploy dari prompt, membuat service otomatis, mengecek status build.
- Di dashboard Cloud Portal: grafik CPU/RAM, live logs, terminal browser, rollback satu klik.
- Harga: paket per jam (Micro Rp50, Small Rp100, Medium Rp200, Large Rp400, XLarge Rp800); add-on persistent storage Rp4/GB/jam; egress Rp0/GB; top-up mulai Rp100.000. Detail: [neo-app.html#paket](neo-app.html#paket) dan [pricelist.html](pricelist.html).

## Bantuan

- Status: https://status.biznetgio.com/
- Tiket support: https://kb.biznetgio.com/id_ID/informasi/cara-menghubungi-dan-mengakses-tiket-support-di-neocloud
- Kontak: https://www.biznetgio.com/contact-us