Panduan Integrasi MCP IDCloudHost dengan AI Agent

Pendahuluan

Model Context Protocol (MCP) adalah protokol standar yang memungkinkan AI Agent seperti Hermes Agent, OpenClaw, Claude, dan ChatGPT terhubung langsung dengan layanan IDCloudHost. Dengan MCP, pengelolaan cloud seperti membuat VM, menghapus resource, mengatur jaringan, hingga memantau billing dapat dilakukan langsung melalui perintah chat tanpa perlu membuka dashboard secara manual. Simak panduan integrasi MCP IDCloudHost dengan AI Agent berikut ini.

Integrasi MCP IDCloudHost dengan AI Agent

Ikuti beberapa langkah untuk melakukan integrasi MCP IDCloudHost dengan AI agent berikut ini:

Konfigurasi API Key

Sebelum mulai menggunakan MCP IDCloudHost, Anda perlu membuat API Key dari dashboard.

Login ke Console IDCloudHost

Akses Console IDCloudHost di console.idcloudhost.com, Daftar atau masuk menggunakan akun email Anda. Setelah masuk, Anda langsung diarahkan ke dashboard untuk mengelola layanan Cloud.

console idcloudhost

Generate API Key

Selanjutnya, masuk ke menu Access, seperti gambar dibawah ini.

console idcloudhost

Klik NEW, pilih API Token, lalu tentukan scope: Restricted (1 billing/resource) atau Global (semua akun di console).

api key console

Beri nama (misalnya: mcp-ai-agent), lalu klik Create.

console idcloudhost

Catatan Penting:
API Key memberikan akses penuh ke resource IDCloudHost Anda. Oleh karena itu, jangan dibagikan akses ini kepada siapapun. Dan lakukan rotasi secara berkala (disarankan setiap 30 hari).

Format URL MCP IDCloudHost

Selanjutnya, gunakan format berikut:

https://mcp.idcloudhost.com/mcp?key=TOKEN_KAMU

Ganti TOKEN_KAMU dengan API Key yang sudah Anda dapatkan sebelumnya.

api token

Tahap Integrasi AI

Setelah mendapatkan API Key dan URL MCP, langkah selanjutnya adalah melakukan integrasi ke AI Agent pilihan kamu. Ikuti panduan sesuai platform berikut:

Daftar 107 Tools MCP IDCloudHost

Berikut versi yang sudah disempurnakan dengan struktur lebih rapi, konsisten, dan mudah dibaca untuk dokumentasi panduan.

VM Management (21 Tools)

Kategori ini digunakan untuk mengelola lifecycle Virtual Machine (VM), mulai dari pembuatan, konfigurasi, hingga penghapusan resource.

Tool	Fungsi
`vm_create`	Membuat VM baru
`vm_delete`	Menghapus VM
`vm_list`	Menampilkan daftar seluruh VM
`vm_get`	Melihat detail VM
`vm_start`	Menyalakan VM
`vm_stop`	Mematikan VM
`vm_modify`	Mengubah spesifikasi VM (CPU, RAM, nama)
`vm_change_password`	Mengubah password user OS
`vm_reinstall`	Melakukan reinstall OS
`vm_clone`	Membuat clone dari VM
`vm_boot_iso_media`	Boot VM menggunakan ISO
`vm_toggle_backup`	Mengaktifkan atau menonaktifkan backup
`vm_replica_create`	Membuat snapshot VM
`vm_replica_list`	Melihat daftar snapshot
`vm_replica_delete`	Menghapus snapshot
`vm_rebuild`	Melakukan rebuild VM dari snapshot
`vm_disk_add`	Menambahkan disk ke VM
`vm_disk_modify`	Resize atau mengubah konfigurasi disk
`vm_disk_delete`	Menghapus disk VM
`vm_disk_attach`	Attach disk ke VM
`vm_disk_detach`	Detach disk dari VM
`vm_host_pool_list`	Melihat daftar host pool

OS Images (4 Tools)

Kategori ini menyediakan akses untuk melihat berbagai image sistem operasi dan aplikasi yang tersedia.

Tool	Fungsi
`vm_images_list`	Menampilkan seluruh image OS dan aplikasi
`os_images_list`	Menampilkan base OS image
`app_images_list`	Menampilkan pre-built application image
`bootable_images_list`	Menampilkan image rescue atau ISO bootable

OS yang tersedia:

Ubuntu (20.04–26.04), AlmaLinux (8–10), Debian, Rocky Linux, CentOS, Fedora, Kali Linux, serta 20+ pilihan OS lainnya.

Application Image yang tersedia:

cPanel, CyberPanel, Docker, WordPress, OpenClaw, Hermes Agent, n8n, Coolify, Nextcloud, dan 40+ aplikasi lainnya.

Network Management (10 Tools)

Kategori jaringan digunakan untuk mengelola private network, public IP, dan firewall VM.

Tool	Fungsi
`network_list`	Melihat daftar private network
`network_create`	Membuat private network
`network_delete`	Menghapus private network
`floating_ip_create`	Membuat floating IP
`floating_ip_list`	Melihat daftar floating IP
`floating_ip_assign`	Menghubungkan IP ke VM
`floating_ip_unassign`	Melepas IP dari VM
`floating_ip_delete`	Menghapus floating IP
`firewall_create`	Membuat firewall rule
`firewall_assign_vm`	Menghubungkan firewall ke VM

Storage Management (5 Tools)

Digunakan untuk mengelola penyimpanan tambahan di luar disk utama VM.

Tool	Fungsi
`disk_create`	Membuat standalone disk
`disk_list`	Melihat daftar disk
`disk_get`	Melihat detail disk
`disk_modify`	Mengubah konfigurasi disk
`disk_delete`	Menghapus disk

Object Storage S3 (6 Tools)

Kategori ini memungkinkan pengelolaan Object Storage berbasis kompatibilitas S3.

Tool	Fungsi
`s3_info`	Melihat informasi endpoint S3
`bucket_create`	Membuat bucket baru
`bucket_list`	Melihat daftar bucket
`bucket_get`	Melihat detail bucket
`s3_user_get`	Melihat informasi user S3
`s3_key_create`	Membuat access key S3

Load Balancer (7 Tools)

Digunakan untuk mengatur distribusi trafik ke beberapa server.

Tool	Fungsi
`load_balancer_create`	Membuat load balancer
`load_balancer_list`	Melihat daftar load balancer
`load_balancer_add_target`	Menambahkan target backend
`load_balancer_add_forwarding_rule`	Menambahkan aturan forwarding

SSH Keys (4 Tools)

Kategori ini digunakan untuk mengelola akses SSH ke VM.

Tool	Fungsi
`ssh_key_list`	Melihat daftar SSH key
`ssh_key_create`	Menambahkan SSH key baru
`ssh_key_rename`	Mengubah nama SSH key
`ssh_key_delete`	Menghapus SSH key

Billing & Account Management (15 Tools)

Kategori ini digunakan untuk memantau informasi akun, saldo, invoice, lokasi data center, dan harga layanan.

Tool	Fungsi
`user_get`	Melihat informasi akun
`billing_account_list`	Melihat daftar billing account
`credit_list`	Mengecek saldo atau credit
`invoice_list`	Melihat daftar invoice
`locations_list`	Melihat daftar lokasi data center
`pricing_get`	Melihat informasi harga

Lokasi Data Center Tersedia

MCP IDCloudHost mendukung beberapa lokasi deployment VM:

Lokasi	Slug
Jakarta Selatan	`jkt01`
Jakarta Barat	`jkt03`
Singapore	`sgp01`

Dengan dukungan 107 tools ini, AI Agent dapat membantu melakukan berbagai aktivitas cloud management, mulai dari provisioning VM, konfigurasi jaringan, pengelolaan storage, hingga monitoring akun dan billing melalui perintah natural language.

Contoh Penggunaan

MCP IDCloudHost dapat digunakan melalui perintah natural language untuk mengelola resource cloud.

Buat VM Baru

Prompt:

Buat VM dengan OS Ubuntu 26.04, lokasi Singapore, CPU 2 vCPU, RAM 4 GB, Disk 40 GB, serta generate random username dan password.

List Semua VM

Prompt:

List semua VM saya di Singapore

Hasil: Menampilkan informasi VM seperti nama, IP, OS, status, dan spesifikasi.

Hapus VM

Prompt:

Hapus VM dengan UUID: b4be2e2a-54e0-48c7-b0e6-1c53ce6cb1d0

Cek OS Tersedia

Prompt:

OS apa saja yang tersedia untuk VM?

Hasil: Menampilkan daftar OS beserta versi yang tersedia.

Cara Troubleshooting

Beberapa kendala umum saat menggunakan MCP:

401 Unauthorized : API Key salah atau expired. Cek kembali API Key pada dashboard IDCloudHost.
Session expired : Session MCP timeout. Restart AI Agent.
Tools tidak muncul : MCP belum berhasil di-reload. Restart agent atau reload MCP.
VM gagal dibuat : Parameter tidak valid. Pastikan format input sesuai dengan aturan OS.

Aturan Password:

Ubuntu menggunakan minimal 8 karakter dengan kombinasi huruf dan angka.
AlmaLinux hanya mendukung karakter alphanumeric tanpa simbol khusus seperti !@#$%).
Debian membutuhkan minimal 8 karakter.
Windows membutuhkan minimal 8 karakter dengan kombinasi huruf besar, kecil, dan angka.

Batasan VM:

VM membutuhkan minimal disk 20 GB, RAM 2048 MB (2 GB), dan vCPU minimal 2 cores. Password tidak boleh menggunakan karakter ' (single quote), sedangkan username tidak dapat menggunakan root atau Ubuntu.

Lampiran Cheatsheet Cepat

Test koneksi Hermes Agen menggunakan:

hermes mcp test IDCloudHost

Melihat daftar tools:

hermes mcp list

Melihat daftar VM:

List VM saya di Singapore

Membuat VM cepat:

Buat VM Ubuntu 24.04 2CPU 2GB RAM 40GB di Singapore

Menghapus VM:

“Hapus VM dengan UUID xxxxxx”

Format Parameter vm_create

name: "vm-nama-saya" # Nama VM
os_name: "ubuntu" # Family OS
os_version: "24.04-lts" # Versi OS
vcpu: 2 # Jumlah CPU
ram: 2048 # RAM dalam MB
disks: 40 # Disk dalam GB
username: "admin-saya" # User OS (bukan root/ubuntu)
password: "Password123" # Password OS
location: "sgp01" # Lokasi data center
billing_account_id: 1234567890 # ID billing

Penutup

Dengan integrasi MCP IDCloudHost, pengelolaan infrastruktur cloud menjadi lebih praktis melalui bantuan berbagai AI Agent seperti Hermes Agent, OpenClaw, Claude AI, dan ChatGPT. Berbagai aktivitas seperti membuat VM, mengatur jaringan, mengelola storage, hingga memantau billing dapat dilakukan langsung melalui percakapan tanpa perlu berpindah dashboard. Dengan dukungan tools MCP yang tersedia, Anda dapat membangun workflow cloud yang lebih otomatis, cepat, dan efisien.