Public + authenticated MCP

Satu manual untuk seluruh MCP IrengCloud.

Cari dokumentasi publik tanpa token, atau hubungkan akun dengan API key untuk membaca layanan dan invoice Anda. Mode admin tersedia secara eksplisit dan tetap read-only.

https://irengcloud.com/mcp

Requesttools/call

{
  "name": "search_irengcloud_docs",
  "arguments": {
    "query": "paket NAT LXC"
  }
}

Response200 · complete

{
  "id": "nat-lxc",
  "title": "NAT LXC",
  "url": "…/pricing/lxc"
}

Mulai dalam satu menit

Tambahkan server. Lalu biarkan AI mencari sumber yang tepat.

Codex

Terminal

codex mcp add irengcloud-docs \
  --url https://irengcloud.com/mcp

Claude Code

Terminal

claude mcp add irengcloud-docs --scope user \
  --transport http https://irengcloud.com/mcp

Cursor

mcp.json

{
  "mcpServers": {
    "irengcloud-docs": {
      "url": "https://irengcloud.com/mcp"
    }
  }
}

Dua tool, satu alur

Temukan dokumen dahulu, ambil isinya setelah relevan.

search_irengcloud_docs

Cari sumber publik

Mencari dokumentasi inti, produk aktif dan terlihat, serta artikel blog yang sudah diterbitkan. Input: query wajib, limit 1–10 (default 5).

get_irengcloud_doc

Ambil dokumen lengkap

Mengambil isi lengkap berdasarkan id hasil pencarian, disertai URL sumber untuk verifikasi.

Pertanyaan pengguna→search→pilih ID→get document→jawaban + sumber

Akses terautentikasi

Masuk dengan OAuth, atau gunakan API key untuk automation.

OAuth · direkomendasikan

Codex membuka login IrengCloud di browser, meminta persetujuan scope, lalu menyimpan access dan refresh token. Dynamic registration dan PKCE ditangani otomatis.

scope=mcp:client · default

Login sebagai client

Gunakan akun IrengCloud Anda. OAuth token hanya dapat membaca data akun yang melakukan login.

codex mcp add irengcloud-account \
  --url https://irengcloud.com/mcp/auth

codex mcp login irengcloud-account

scope=mcp:admin · explicit

Login sebagai admin

Consent admin hanya dapat diberikan oleh akun yang role-nya masih admin.

codex mcp add irengcloud-operations \
  --url 'https://irengcloud.com/mcp/auth?mode=admin'

codex mcp login irengcloud-operations

GETDocs

`https://irengcloud.com/mcp`

Halaman ini. Seluruh panduan public dan authenticated MCP berada di sini.

POSTPublic

`https://irengcloud.com/mcp`

Transport MCP untuk dokumentasi, produk publik, dan artikel. Tidak memakai API key.

POSTClient default

`https://irengcloud.com/mcp/auth`

Transport MCP untuk data pemilik credential. Menerima OAuth token atau API key pada header Bearer.

POSTAdmin explicit

`https://irengcloud.com/mcp/auth?mode=admin`

Transport admin. Wajib admin scope/key dan role pemilik yang masih admin.

API key · alternatif

Pilih ini untuk CI, server, atau automation tanpa browser. Token mentah hanya ditampilkan sekali saat key dibuat.

mode=client · default

Data milik akun sendiri

Melihat ringkasan akun, layanan cloud, dan invoice milik pemegang key. Tidak dapat mengakses data user lain.

export IRENG_MCP_CLIENT_KEY='ic_mcp_client_xxx'

codex mcp add irengcloud-client \
  --url https://irengcloud.com/mcp/auth \
  --bearer-token-env-var IRENG_MCP_CLIENT_KEY

mode=admin · explicit

Ringkasan operasional admin

Memerlukan admin API key dan parameter admin. Tanpa parameter tersebut, admin key tetap dibatasi sebagai client.

export IRENG_MCP_ADMIN_KEY='ic_mcp_admin_xxx'

codex mcp add irengcloud-admin \
  --url 'https://irengcloud.com/mcp/auth?mode=admin' \
  --bearer-token-env-var IRENG_MCP_ADMIN_KEY

Access matrix

Jika parameter mode tidak diberikan, server selalu memilih client. Parameter hanya memilih mode; ia tidak pernah menaikkan hak akses.

Credential	Mode diminta	Hasil	HTTP
Client scope/key	`omitted` / `client`	Client tools, data pemilik credential	`200`
Client scope/key	`admin`	Ditolak; tidak bisa escalation	`403`
Admin scope/key	`omitted` / `client`	Tetap client tools	`200`
Admin scope/key	`admin`	Client + admin tools	`200`

API key lifecycle

Buat sekali, simpan aman, cabut saat tidak digunakan.

1. Buat client key

Gunakan access token dashboard IrengCloud pada endpoint manajemen key. Masa aktif default client key adalah 90 hari dan dapat dipilih antara 1–365 hari.

curl -X POST https://irengcloud.com/api/mcp-keys \
  -H 'Authorization: Bearer YOUR_ACCOUNT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Codex laptop","expires_in_days":90}'

2. Buat admin key

Endpoint ini hanya dapat dipakai akun admin. Default masa aktifnya lebih pendek, 30 hari, dengan maksimum 90 hari.

curl -X POST https://irengcloud.com/api/admin/mcp-keys \
  -H 'Authorization: Bearer YOUR_ADMIN_ACCOUNT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Codex operations","expires_in_days":30}'

Simpan respons api_key saat itu juga. IrengCloud hanya menyimpan hash SHA-256 dan tidak dapat menampilkan token mentah lagi. Jangan masukkan token ke repository, chat, screenshot, atau command history bersama.

3. List dan revoke

Client hanya dapat melihat dan mencabut key miliknya. Admin dapat mencabut key apa pun melalui route admin.

Method	Route	Akses	Fungsi
`GET`	`/api/mcp-keys`	Account token	List metadata key milik sendiri; token mentah tidak disertakan.
`POST`	`/api/mcp-keys`	Account token	Buat client key.
`DELETE`	`/api/mcp-keys/{id}`	Pemilik key	Revoke client-owned key.
`POST`	`/api/admin/mcp-keys`	Admin account	Buat admin key.
`DELETE`	`/api/admin/mcp-keys/{id}`	Admin account	Revoke key berdasarkan ID.

Authenticated tool reference

Empat tool read-only dengan scope yang tegas.

Client

`get_my_irengcloud_account`

Ringkasan akun, saldo IDR, role, tanggal registrasi, dan jumlah layanan per jenis.

Arguments: Tidak ada
Scope: Pemilik API key
Secrets: Tidak mengembalikan password atau token

Client

`list_my_irengcloud_services`

Daftar layanan LXC, KVM, App Server, dan Pterodactyl milik akun.

type: all|lxc|kvm|app|pterodactyl
limit: 1–100, default 25
Scope: Pemilik API key

Client

`list_my_irengcloud_invoices`

Invoice akun beserta nominal, status, jatuh tempo, dan waktu pembayaran.

status: all|pending|paid|expired|cancelled|unpaid
limit: 1–100, default 25
Scope: Pemilik API key

Admin

`get_irengcloud_admin_summary`

Agregat jumlah user, layanan, invoice, revenue paid, dan produk aktif/visible.

Arguments: Tidak ada
Mode: ?mode=admin
Scope: Admin key + pemilik masih admin

HTTP & JSON-RPC

Contoh mentah untuk debug tanpa MCP client.

curl -X POST https://irengcloud.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -X POST https://irengcloud.com/mcp/auth \
  -H 'Authorization: Bearer ic_mcp_client_xxx' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_my_irengcloud_services","arguments":{"type":"all","limit":25}}}'

Transport contract

Endpoint bersifat stateless Streamable HTTP dan mendukung protocol modern 2026-07-28 serta versi legacy yang kompatibel.

Item	Nilai	Catatan
Format	`JSON-RPC 2.0`	Request ber-ID mendapat JSON response; notification tanpa ID mendapat HTTP 202 tanpa body.
Methods	`initialize`, `ping`, `tools/list`, `tools/call`	Modern discovery juga mendukung `server/discover`.
Auth	`Authorization: Bearer …`	Hanya wajib pada `/mcp/auth`.
Cache scope	`public` / `private`	Public docs dapat dibagi; respons akun hanya untuk auth context yang sama.
Rate limit	`120 requests/minute`	Berlaku per endpoint melalui middleware aplikasi.
Browser Origin	Allowlist	CLI/native client umumnya tidak mengirim Origin. Browser origin asing ditolak.

Errors & troubleshooting

Pesan yang umum, penyebabnya, dan langkah perbaikannya.

HTTP / gejala	Penyebab	Perbaikan
`401`	Bearer credential hilang, salah, expired, atau revoked.	Jalankan `codex mcp login` lagi, atau pastikan API key masih aktif.
`403`	Client credential meminta admin mode, atau pemilik admin credential bukan admin lagi.	Gunakan client mode atau login/issue key dari akun admin aktif.
OAuth registration gagal	Konfigurasi lama tersimpan sebelum OAuth tersedia.	Hapus server auth dari Codex, tambahkan ulang, lalu jalankan `codex mcp login`.
`400`	Mode bukan client/admin atau metadata protocol modern tidak cocok.	Periksa URL, header MCP, dan metadata request.
`No such file or directory` di Codex	URL ditafsirkan sebagai command stdio karena flag lama/salah.	Hapus config lama lalu tambahkan ulang memakai `--url`.
Server tidak muncul	Codex belum memuat ulang konfigurasi MCP.	Jalankan `codex mcp list`, lalu restart sesi Codex.

Reset konfigurasi Codex

Gunakan ini jika sebelumnya endpoint HTTP ditambahkan sebagai transport stdio.

codex mcp remove irengcloud-docs
codex mcp add irengcloud-docs --url https://irengcloud.com/mcp
codex mcp list

Batas akses

Setiap jalur tetap read-only dan berlapis.

Read-only

Tool MCP awal tidak dapat mengubah produk, akun, server, invoice, atau infrastruktur.

Publik tetap terbuka

Dokumentasi publik di /mcp tetap dapat dipakai tanpa API key.

Role dari key

Parameter admin tidak memberi hak tambahan; role dan pemilik selalu diverifikasi dari API key.

Hash at rest

Database hanya menyimpan SHA-256 dari key berentropi tinggi. Token mentah hanya muncul saat key dibuat.

Expiry & revoke

Key kedaluwarsa atau sudah dicabut langsung menghasilkan 401 dan tidak dapat dipakai kembali.

Private responses

Discovery authenticated memakai private cache scope agar hasil akun tidak dibagikan lintas konteks autentikasi.