AGENT & MCP / PANDUAN SETUP

Hubungkan agent Anda.
Dengan akses yang jelas.

Deploy aplikasi ke NEO App dari coding agent, atau kelola NEO Lite, NEO Lite Pro, NEO Metal, dan Object Storage dari AI client lewat server MCP Biznet Gio. Setiap langkah di halaman ini bisa Anda uji sendiri.

MULAI CEPAT / CLAUDE CODEBUTUH API KEY PORTAL

Simpan API key Portal di variabel BIZNETGIO_API_KEY, lalu tambahkan server dari terminal:

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

  1. Berjalan di komputer Andanpx menjalankan paket @biznetgio/mcp sebagai server stdio lokal.
  2. Memakai API key akun AndaSetiap tool memanggil Portal API Biznet Gio dengan key tersebut.
  3. Tidak membuat resourceMenambahkan server tidak membuat atau mengubah layanan apa pun.
CLAUDE DESKTOP · CURSOR · LAINNYALIHAT SEMUA CLIENT ↓
LAYANAN VIA MCP6layanan
RUNTIME18+Node.js
TRANSPORTstdiolokal
KODE SUMBERMITopen-source

Empat kebutuhan. Empat jalur berbeda.

Deploy aplikasi, mengelola infrastruktur, menjalankan agent, dan memakai AI di Cloud Portal adalah produk yang berbeda — masing-masing dengan cara terhubung, akses, dan biaya sendiri.

Perbandingan jalur agent dan AI di Biznet Gio
JalurTerhubung lewatAkses yang diberikanBiayaPanduan setup
NEO AppMCP dari Cursor, Claude, atau WindsurfDeploy dan service NEO App di akun AndaPer jam sesuai paket, mulai Rp50Detail koneksi MCP via support; mulai di Cloud Portal
Server MCP Biznet GioServer stdio lokal dan API key PortalLayanan yang didukung Portal API di akun AndaSesuai layanan yang dibuat atau di-upgradeTersedia di halaman ini
VPS untuk agentSSH atau console ke VPS AndaServer VPS tersebut sajaLangganan VPS bulananInstalasi Hermes Agent ↗
AI ConsolePanel chat di Cloud PortalSaran untuk VPS NEO Lite dan NEO Lite ProTermasuk dalam NEO Lite dan NEO Lite ProCara membuka AI Console ↗
NEO InferenceAPI dengan access key per proyekModel AI yang Anda pilihBatas kredit diatur per access keyMenggunakan NEO Inference ↗

Setup server MCP infrastruktur.

Server @biznetgio/mcp dari repositori GitHub Biznet Gio berjalan di komputer Anda lewat npx, lalu memanggil Portal API dengan API key akun Anda. Pilih AI client, salin konfigurasinya, kemudian uji dengan permintaan yang hanya membaca.

SETUP / @BIZNETGIO/MCPKONFIGURASI PER CLIENT

Claude Code

Jalankan di terminal. Scope bawaan (local) menyimpan konfigurasi di ~/.claude.json, hanya untuk Anda di proyek ini.

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

Untuk konfigurasi tim, simpan di .mcp.json pada root proyek. Key tetap dibaca dari environment masing-masing anggota, bukan ditulis di file:

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

Claude Desktop

Tambahkan ke claude_desktop_config.json, ganti API_KEY_ANDA, lalu mulai ulang Claude Desktop. File ini menyimpan key sebagai teks biasa — jangan bagikan atau commit.

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

Cursor

Simpan di .cursor/mcp.json (per proyek) atau ~/.cursor/mcp.json (semua proyek). ${env:BIZNETGIO_API_KEY} membaca key dari environment saat Cursor dijalankan.

.CURSOR/MCP.JSON
{
  "mcpServers": {
    "biznetgio": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@biznetgio/mcp@latest"],
      "env": { "BIZNETGIO_API_KEY": "${env:BIZNETGIO_API_KEY}" }
    }
  }
}

Windsurf dan client lain

Client MCP yang mendukung server stdio lokal memakai tiga nilai yang sama. Letakkan di file konfigurasi MCP sesuai dokumentasi client Anda, misalnya dokumentasi MCP Windsurf ↗.

NILAI KONFIGURASI
command  npx
args     -y @biznetgio/mcp@latest
env      BIZNETGIO_API_KEY=API_KEY_ANDA

NODE.JS 18+ · LISENSI MITSETUP TIDAK MEMBUAT RESOURCE
  1. 01

    Siapkan prasyarat.

    Akun Cloud Portal, Node.js 18 atau lebih baru (untuk npx), dan AI client yang mendukung server MCP lokal (stdio).

  2. 02

    Buat API key Portal.

    Masuk ke Cloud Portal, gunakan menu Generate API Key, lalu simpan key di tempat aman. Key hanya bisa digenerate sekali; key yang hilang diminta ulang ke tim support.

    Panduan API Portal
  3. 03

    Tambahkan server ke client.

    npx mengunduh @biznetgio/mcp dari npm dan menjalankannya di komputer Anda. Server mengirim key di header x-token ke api.portal.biznetgio.com.

  4. 04

    Uji dengan tugas baca.

    Minta daftar layanan Anda sebelum memberi tugas yang mengubah resource atau menambah biaya.

    Lihat tugas pertama

Uji koneksi. Lalu tugas pertama.

Server yang aktif di AI client belum membuktikan API key valid — key baru dibaca saat sebuah tool dipanggil. Tugas baca pertama memastikan keduanya, tanpa mengubah apa pun.

PERMINTAAN PERTAMA / HANYA MEMBACA

Tanyakan daftar
layanan Anda.

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

Agent seharusnya memanggil tool neolite_pro_list, yang hanya membaca daftar akun NEO Lite Pro dari Portal API. Untuk layanan lain, gunakan tool baca yang setara:

neolite_listmetal_listobject_storage_listelastic_storage_list
Cek server
Server biznetgio aktif Claude Code: claude mcp list atau /mcp. Cursor: daftar server dan tool di halaman Customize, serta Output › MCP Logs. Claude Desktop: mulai ulang aplikasi setelah konfigurasi diubah.
Berhasil
Data layanan dari akun Anda Respons JSON dari Portal API berisi ID akun, status, dan detail layanan. Cocokkan dengan Cloud Portal untuk memastikan akunnya benar.
Kosong
Belum ada layanan jenis ini Key valid, tetapi akun belum memiliki NEO Lite Pro. Coba tool baca untuk layanan lain di atas.
Ditolak
Error: API Error 4xx Key salah atau tidak berlaku. Periksa key yang disalin, atau minta key baru ke tim support.
Key tidak terbaca
Error: API key not set Variabel BIZNETGIO_API_KEY kosong di proses server. Set variabelnya sebelum menjalankan client, lalu mulai ulang client.

Setelah terhubung: operasi harian.

Contoh permintaan untuk agent, dengan tool yang akan dipakai. Tool yang membaca aman untuk dicoba; tool yang mengubah layanan atau menambah biaya sebaiknya selalu Anda tinjau sebelum dijalankan.

01 / PANTAU

Cek kondisi layanan.

“Tampilkan detail VM NEO Lite Pro saya dan status terakhirnya.”

Baca
neolite_pro_vm_detailsDetail dan status VM
Baca
metal_stateStatus server NEO Metal
02 / DIAGNOSIS

Cari penyebab masalah.

Agent membandingkan paket, storage, dan opsi upgrade. Log di dalam server tidak dibaca oleh server MCP ini — gunakan AI Console atau SSH.

Baca
neolite_pro_storage_optionsOpsi upgrade storage
Baca
object_storage_bucket_usagePemakaian bucket
Tentang AI Console
03 / PULIHKAN

Restart atau kembalikan.

Restart dan restore snapshot mengubah layanan yang sedang berjalan. Minta agent menjelaskan dampaknya, lalu setujui sendiri.

Ubah
neolite_pro_set_stateStart, stop, atau reset VM
Ubah
neolite_pro_snapshot_restoreKembalikan VM ke snapshot
04 / KEMBANGKAN

Tambah kapasitas.

Membuat layanan, upgrade storage, atau ganti paket menambah tagihan sesuai daftar harga.

Berbiaya
neolite_pro_upgrade_storageTambah storage VM
Berbiaya
neolite_pro_createBuat VM baru
Lihat daftar harga

Operasional aplikasi NEO App — status build, live logs, dan rollback — dijelaskan di halaman NEO App. Server MCP infrastruktur ini tidak mencakup NEO App.

Akses dan kontrol, tanpa asumsi.

Apa yang dapat dilakukan agent ditentukan oleh API key yang Anda berikan dan pengaturan persetujuan di AI client Anda. Berikut yang terdokumentasi — dan yang belum.

AKSI SERVER MCP / 4 JENISPILIH JENIS AKSI

Baca

Dampak
Tidak mengubah layanan.
Saran
Aman untuk tugas pertama.
  • neolite_pro_listDaftar akun NEO Lite Pro
  • metal_stateStatus server NEO Metal
  • object_storage_bucket_usagePemakaian bucket Object Storage

Ubah

Dampak
Mengubah layanan yang berjalan atau akses data.
Saran
Tinjau setiap kali.
  • neolite_pro_set_stateStart, stop, atau reset VM
  • neolite_pro_renameGanti nama VM
  • object_storage_bucket_set_aclUbah akses bucket

Berbiaya

Dampak
Membuat atau menambah resource yang ditagih.
Saran
Cek harga sebelum menyetujui.
  • neolite_pro_createBuat VM NEO Lite Pro baru
  • neolite_pro_upgrade_storageTambah storage VM
  • object_storage_createBuat layanan Object Storage

Hapus

Dampak
Menghapus layanan atau data.
Saran
Siapkan backup, lalu tinjau.
  • neolite_pro_deleteHapus VM NEO Lite Pro
  • metal_deleteHapus server NEO Metal
  • object_storage_object_deleteHapus objek di bucket
VERSI 1.2.0 · TANPA PENANDA READ-ONLYPERSETUJUAN DIATUR CLIENT
01 / CAKUPAN AKSES

Setara akun Portal Anda.

Dokumentasi publik tidak menyebutkan scope atau batas izin per API key. Anggap key memberi agent akses ke semua layanan yang didukung di akun Anda.

02 / KREDENSIAL

Key tetap di perangkat Anda.

Simpan di environment atau file konfigurasi lokal. Jangan tempel di chat, repository, atau kode publik. Situs ini tidak pernah meminta API key Anda.

03 / PENCABUTAN

Bila key bocor.

Cara mencabut key secara mandiri belum dijelaskan di dokumentasi publik. Hubungi support 24/7 di support@biznetgio.com atau (021) 5714567, lalu hapus key dari konfigurasi client.

04 / PERSETUJUAN

Diatur client, bukan Biznet Gio.

Cursor meminta persetujuan untuk tool MCP secara bawaan. Claude Code meminta persetujuan untuk server dari .mcp.json dan mendukung aturan izin. Mode auto-run dapat melewati persetujuan.

Portal API menjalankan permintaan yang membawa key valid; belum ada langkah persetujuan tambahan dari sisi Biznet Gio yang terdokumentasi. Versi 1.2.0 juga belum menandai tool baca atau tulis, jadi client tidak bisa membedakannya otomatis.

05 / BIAYA

Koneksi MCP tidak membuat resource.

Tagihan muncul dari layanan yang dibuat, di-upgrade, atau diganti paketnya, sesuai daftar harga.

Lihat daftar harga

Saat ada yang tidak berjalan.

Masalah yang paling sering muncul saat setup dan tugas pertama, beserta langkah pemulihannya.

Tool biznetgio tidak muncul di AI client

Pastikan Node.js 18 atau lebih baru terpasang dan npx ada di PATH, JSON konfigurasi valid, lalu mulai ulang client. Di Cursor, buka Output › MCP Logs. Di Claude Code, jalankan claude mcp list.

Muncul Error: API key not set

Server tidak menemukan key. Server membaca BIZNETGIO_API_KEY dari environment prosesnya — set variabel itu sebelum client dijalankan, atau isi nilai env di konfigurasi, lalu mulai ulang client.

Muncul Error: API Error dengan kode 4xx

Portal API menolak permintaan. Periksa apakah key tersalin utuh tanpa spasi. Bila key hilang atau diragukan, minta key baru ke tim support lalu perbarui konfigurasi.

Muncul Error: fetch failed

Server tidak bisa menjangkau api.portal.biznetgio.com. Periksa koneksi internet, proxy, atau firewall di komputer tempat client berjalan, lalu cek status layanan ↗.

Hasil kosong, padahal layanan terlihat di Cloud Portal

Pastikan tool sesuai produknya: neolite_list untuk NEO Lite, neolite_pro_list untuk NEO Lite Pro. Pastikan juga key berasal dari akun yang sama dengan yang Anda buka di Cloud Portal.

Agent ingin membuat, mengubah, atau menghapus layanan

Hentikan dulu dan minta agent menjelaskan tool, parameter, dan dampaknya. Cek harga di daftar harga, buat snapshot bila perlu, lalu setujui sendiri. Jangan aktifkan auto-run untuk tool yang berbiaya atau menghapus.

Saya ingin deploy aplikasi NEO App lewat MCP

Server MCP infrastruktur tidak mencakup NEO App. Ikuti langkah di halaman NEO App untuk Chat-to-Deploy dari Cursor, Claude, atau Windsurf.

Masih butuh bantuan

Buka tiket support di Cloud Portal — lihat cara mengakses tiket support ↗ — atau hubungi tim kami ↗. Sertakan pesan error lengkap, tanpa API key.

Dokumentasi untuk Anda dan agent Anda.

Referensi teknis, panduan, dan ringkasan berformat Markdown yang bisa dibaca langsung oleh agent.

BUTUH BANTUAN SETUP?

Tim support 24/7
siap membantu.

Hubungi kami
GIO / PRODUCT DIRECTORY

Apa yang ingin Anda bangun?