Pendahuluan

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.

Generate API Key

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

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

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

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.

Integrasi dengan Hermes Agent

Lalu, gunakan hermes Agent yang memiliki dukungan MCP bawaan (native client), sehingga integrasi bisa dilakukan dengan cepat.

Tambahkan MCP Server ke Config

Kemudian, untuk Hermes CLI, jalankan perintah berikut:

hermes mcp add IDCLOUDHOST  --url “https://mcp.idcloudhost.com/mcp?key=TOKEN_KAMU”

Berdasarkan tampilan tersebut, akan muncul formulir. Pilih “no” atau ketik “n”, karena Anda menggunakan API Key dan tidak memerlukan autentikasi tambahan.

Selanjutnya, pada opsi Enable all 87 tools? [Y/n/select]: silakan pilih “yes” atau “Y” agar seluruh tools MCP tersimpan dalam konfigurasi Hermes.

Restart Hermes Agent

Restart Hermes Gateway untuk menerapkan konfigurasi yang telah ditambahkan.

hermes gateway restart

Verifikasi Koneksi

Jalankan perintah berikut untuk memastikan MCP Server sudah terhubung:

hermes mcp list

Jalankan perintah berikut untuk menguji koneksi MCP Server:

hermes mcp test IDCLOUDHOST

Mulai Penggunaan

Setelah terhubung, tools MCP akan tersedia secara otomatis di dalam chat. Anda dapat mencoba perintah berikut:

User: "List semua VM saya di Singapore"

Agent: Akan menampilkan daftar Virtual Machine yang Anda miliki di region Singapore secara otomatis.

Dengan cara ini, Anda dapat mengelola infrastruktur cloud hanya melalui percakapan, tanpa perlu masuk ke dashboard secara manual.

Selain menampilkan VM, AI Agent juga bisa memantau sisa saldo Anda, jumlah IP, dan memberi pengingat otomatis saat saldo hampir habis.

Add MCP via Hermes GUI

Selain melalui CLI, Hermes Agent juga mendukung pengelolaan melalui WebUI (GUI). Akses URL publik Hermes lalu login ke dashboard Anda, kemudian buka menu MCP di bilah sisi kanan untuk mulai menambahkan koneksi MCP.

Klik ADD SERVER, lalu masukkan parameter MCP IDCloudHost sesuai dengan konfigurasi pada langkah sebelumnya untuk menyelesaikan proses penambahan server.

Isi kolom Name dan URL, lalu biarkan kolom lainnya tetap menggunakan pengaturan standar (default).

Lakukan verifikasi koneksi ke MCP untuk memastikan integrasi berhasil dan dapat digunakan.

Selanjutnya, Anda dapat mencoba perintah pembuatan VM melalui menu chat atau channel lain seperti bot Telegram, jika Hermes Agent sudah terintegrasi.

Untuk panduan lengkap instalasi Hermes Agent, silakan ikuti langkah-langkah pada halaman berikut:

Cara Install dan Setup Awal Hermes Agent di IDCloudHost

Integrasi dengan OpenClaw

OpenClaw sudah mendukung MCP Client bawaan, sehingga Anda dapat langsung menghubungkan layanan IDCloudHost tanpa konfigurasi tambahan yang kompleks.

Tambahkan MCP Server

openclaw mcp add IDCLOUDHOST \ 

--transport streamable-http \ 

--url "https://mcp.idcloudhost.com/mcp?key=YOUR_API_KEY" 

Lakukan verifikasi MCP yang telah ditambahkan melalui dashboard OpenClaw untuk memastikan koneksi berjalan dengan baik dan siap digunakan.

Anda dapat mengecek status koneksi (Connected/Active) pada daftar MCP Server.

Kemudian masuk ke menu Settings pada dashboard OpenClaw untuk melanjutkan konfigurasi MCP yang telah ditambahkan.

Cari dan pilih menu MCP pada halaman Settings di OpenClaw untuk melihat dan mengelola konfigurasi MCP Server yang telah ditambahkan.

Di dalam chat OpenClaw, coba jalankan perintah berikut untuk menguji apakah MCP sudah terhubung dengan benar:

User: "Delete VM uuid : 45430a50-feb5-4af1-8d83-8e093cb15ee8 ip 103.189.235.16" 

Untuk panduan lengkap instalasi OpenClaw di Cloud VPS, silakan kunjungi halaman berikut:

Cara Install OpenClaw di Cloud VPS IDCloudHost

Integrasi dengan Claude AI

Claude.ai saat ini mendukung integrasi MCP melalui dashboard web.

Buka Web Claude AI

Untuk memulai integrasi MCP dengan Claude, Anda bisa akses Claude.ai

Tambahkan MCP Server

Selanjutnya untuk menambahkan MCP, silakan akses menu Customize yang berada di sisi kanan.

Pilih menu Connectors, klik Add, lalu pilih opsi Add custom connector.

Masukkan parameter MCP sesuai dengan langkah sebelumnya, lalu klik “Add“.

Setelah itu, klik “Connect“.

Setelah MCP berhasil terhubung, langkah selanjutnya adalah menentukan mode izin (permission) untuk penggunaan connector.

Terdapat dua opsi yang bisa dipilih yakni Always allow atau Needs approval.

Always allow

Semua perintah dari Claude ke MCP akan langsung dieksekusi. Cocok untuk otomatisasi penuh tanpa konfirmasi. Direkomendasikan jika sudah yakin dengan keamanan & konfigurasi

Needs approval

Setiap perintah harus dikonfirmasi terlebih dahulu. Lebih aman untuk tahap testing atau penggunaan awal. Cocok jika Anda ingin kontrol manual sebelum eksekusi.

Akan tetapi dalam panduan ini kita memilih opsi Always allow .

Verifikasi MCP

Uji koneksi MCP dengan menjalankan perintah berikut melalui chat Claude:

User:
“Buatkan VM baru 2CPU 4GB RAM dengan Ubuntu 24.04 di Singapore”

Setelah proses pembuatan VM selesai melalui Claude AI, lakukan verifikasi dengan mengecek daftar VM pada akun IDCloudHost.

Integrasi dengan ChatGPT

ChatGPT mendukung integrasi MCP melalui Developer Mode (BETA) dengan mekanisme deteksi sebagai plugin.

Buka Web ChatGPT

Selanjutnya untuk memulai konfigurasi MCP di ChatGPT Anda bisa mengakses halaman ChatGPT  . Login menggunakan akun ChatGPT Anda. Kemudian Akses menu Settings. Pilih submenu Security and login untuk mengaktifkan pengaturan yang diperlukan.

Konfigurasi MCP

Pada menu Plugins, pilih Add New Plugin untuk menambahkan MCP Server.

Tambahkan Endpoint MCP

Pada halaman Add New Plugin, masukkan konfigurasi MCP Server berikut:

• Icon (optional) sc logo: https://idcloudhost.com/about-press-release/

• Name :IDCLOUDHOST

• Description (optional): Akses ke Console IDCloudHost API melalui MCP

• Connection: https://mcp.idcloudhost.com/mcp?key=API_KEY_KAMU

• Type Connection: Server URL

• Authentication: No Auth

Setelah semua parameter diisi, klik Save/Add untuk menambahkan MCP Server ke ChatGPT.

Pastikan status Connected sudah muncul pada menu plugin ChatGPT untuk memastikan MCP Server berhasil terhubung dan siap digunakan.

Uji Coba

Kembali ke menu Plugin, lalu pilih plugin IDCLOUDHOST yang telah ditambahkan untuk mulai menggunakan MCP Server melalui ChatGPT.

Lalu klik tombol Try in chat untuk membuka percakapan baru dan mulai menguji koneksi MCP melalui ChatGPT.

User: "reinstall VM region Singapure dengan uuid befb1b8c-a462-4a01-adc9-70f736e634c2 

ip publik : 103.13.206.241 dari OS ubuntu 24.04 ke Almalinux 10.x”

Selanjutnya, Anda dapat memilih Always allow atau Allow once.

Verifikasi VM Before Reinstall

Sebelum melakukan proses reinstall VM, lakukan pengecekan terlebih dahulu untuk memastikan VM yang akan diproses sudah sesuai.

Verifikasi VM After Reinstall

Setelah proses reinstall selesai, lakukan pengecekan ulang untuk memastikan VM berhasil dikonfigurasi kembali.

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 AI Agent seperti Hermes Agent, OpenClaw, Claude, 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 107 tools MCP dan fleksibilitas Cloud VPS IDCloudHost, Anda dapat membangun workflow cloud yang lebih otomatis, cepat, dan efisien.