Panduan Integrasi MCP IDCloudHost dengan Hermes 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

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”

Catatan:

Perintah ini akan menambahkan MCP Server IDCloudHost ke dalam konfigurasi Hermes Anda.

Pastikan untuk mengganti TOKEN_KAMU dengan API Key yang sudah dibuat sebelumnya agar koneksi dapat berjalan dengan benar.

mcp serverke config

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

mcp server

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

hermes agent

Verifikasi Koneksi

Jalankan perintah berikut untuk memastikan MCP Server sudah terhubung:

hermes mcp list

hermes agent

Jalankan perintah berikut untuk menguji koneksi MCP Server:

hermes mcp test IDCLOUDHOST

hermes 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.

penggunaan hermes

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.

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

mcp server

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

mcp server

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

integrasi mcp server

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

hermes agent

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

Cara Install dan Setup Awal Hermes Agent di IDCloudHost

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.

Penutup

Dengan integrasi MCP IDCloudHost, pengelolaan infrastruktur cloud menjadi lebih praktis melalui bantuan AI Agent seperti Hermes Agent. 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.