MCP gambar Ezkielyna: buat dan edit gambar dari agent coding

• Node.js 18 atau lebih baru (cek dengan node -v)
• API key Ezkielyna di grup Media
• Saldo Ezkielyna API Credit
• Salah satu aplikasi: OpenCode, Ezkielyna Agent, Claude Desktop, Claude Code atau Cursor

1. 1Beli saldo API dengan QRIS

   Buka ezkielyna.store/api-credit, pilih nominal (paket terkecil $0.5), lalu bayar dengan QRIS dari aplikasi bank atau e-wallet. USDT (TRC-20, BEP-20, Solana) dan Binance Pay juga bisa. Kode redeem muncul di halaman order setelah pembayaran terkonfirmasi. Saldo tidak kedaluwarsa dan tidak ada biaya bulanan.

2. 2Buat API key grup Media

   Masuk ke api.ezkielyna.store, buka Wallet dan tempel kode redeem. Lalu buka API Keys, buat key baru dan pilih grup Media. Model gambar hanya bisa dipanggil dengan key Media; key Standard akan ditolak.

3. 3Unduh file MCP

   Simpan ezkielyna-image-mcp.mjs di folder yang tidak akan kamu pindahkan, misalnya folder home. Catat path lengkapnya, karena path itu dipakai di konfigurasi. File ini tidak butuh npm install.

   # macOS, Linux
   curl -fsSL -o ezkielyna-image-mcp.mjs https://ezkielyna.store/agent/download/ezkielyna-image-mcp.mjs
   
   # Windows (PowerShell)
   iwr https://ezkielyna.store/agent/download/ezkielyna-image-mcp.mjs -OutFile ezkielyna-image-mcp.mjs

4. 4Daftarkan di aplikasi agent

   Tambahkan server ezkielyna-image ke konfigurasi aplikasimu. Contoh untuk tiap aplikasi ada di bagian Konfigurasi di bawah. Ganti /path/ke/ezkielyna-image-mcp.mjs dengan path lengkap file tadi dan sk-... dengan key Media, lalu tutup dan buka lagi aplikasinya.

5. 5Coba prompt pertama

   Minta agent membuat gambar dengan menyebut file di foldermu. Agent memanggil alat edit_image, menyimpan hasilnya, lalu memberi path file hasil. Untuk merevisi, cukup minta perubahan berikutnya; agent memakai hasil terakhir sebagai referensi.

   Pakai ./logo.png dan ./produk.jpg, buat banner promo 16:9
   
   # lalu
   ganti latarnya jadi biru

Belum punya saldo? Lihat paket API Credit.

Tambahkan blok mcp ke opencode.json di folder proyek atau di ~/.config/opencode/. Ezkielyna Agent membaca format yang sama dari ezkielyna.json atau opencode.json di folder proyek, atau di ~/.config/ezkielyna/.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ezkielyna-image": {
      "type": "local",
      "command": ["node", "/path/ke/ezkielyna-image-mcp.mjs"],
      "enabled": true,
      "environment": {
        "EZKIELYNA_API_KEY": "sk-..."
      }
    }
  }
}

Buka Settings, Developer, Edit Config. Filenya claude_desktop_config.json: di macOS ada di ~/Library/Application Support/Claude/, di Windows di %APPDATA%\Claude\. Di Windows tulis path dengan garis miring ganda, misalnya C:\\Users\\nama\\ezkielyna-image-mcp.mjs.

{
  "mcpServers": {
    "ezkielyna-image": {
      "command": "node",
      "args": ["/path/ke/ezkielyna-image-mcp.mjs"],
      "env": {
        "EZKIELYNA_API_KEY": "sk-..."
      }
    }
  }
}

Satu perintah di terminal. Tambahkan --scope user kalau server ini ingin dipakai di semua proyek. Cek hasilnya dengan claude mcp list.

claude mcp add ezkielyna-image -e EZKIELYNA_API_KEY=sk-... -- node /path/ke/ezkielyna-image-mcp.mjs

Buat atau edit ~/.cursor/mcp.json (semua proyek) atau .cursor/mcp.json di folder proyek. Setelah disimpan, pastikan ezkielyna-image aktif di Cursor Settings bagian MCP.

{
  "mcpServers": {
    "ezkielyna-image": {
      "command": "node",
      "args": ["/path/ke/ezkielyna-image-mcp.mjs"],
      "env": {
        "EZKIELYNA_API_KEY": "sk-..."
      }
    }
  }
}

Tambahkan variabel ini di samping EZKIELYNA_API_KEY, di blok env atau environment yang sama. EZKIELYNA_IMAGE_DIR mengganti folder hasil (bawaan ~/Pictures/Ezkielyna). EZKIELYNA_MAX_IMAGES membatasi jumlah gambar per sesi supaya saldo tidak terkuras kalau agent mengulang terus (bawaan 30).

"EZKIELYNA_API_KEY": "sk-...",
"EZKIELYNA_IMAGE_DIR": "/Users/nama/Desktop/hasil-gambar",
"EZKIELYNA_MAX_IMAGES": "30"

generate_image: membuat gambar baru dari teks.

edit_image: mengedit atau menggabungkan 1 sampai 4 gambar referensi. Referensi boleh path file lokal atau URL. Untuk terus merevisi, berikan hasil sebelumnya sebagai referensi; agent biasanya melakukannya sendiri.

list_image_models: menampilkan model gambar yang bisa dipakai key-mu.

Paling aman sebut file dengan path lengkap. Path relatif seperti ./logo.png cocok untuk agent yang dijalankan dari folder proyek, misalnya OpenCode atau Claude Code.

Model gambar dipanggil dengan key grup Media. Saldo terpotong per gambar yang dibuat, termasuk setiap revisi dengan edit_image. Harga dibaca dari tarif gateway setiap jam:

• gpt-image-2.5: sekitar Rp124 per gambar ($0.00825)
• nano-banana-pro: sekitar Rp495 per gambar ($0.033)

Rupiah dengan kurs paket API Credit $1 (Rp15.000 per $1); paket lebih besar lebih murah per $1. Diperbarui 2026-11-04. Model gambar lain dan harganya ada di /models.

• Server ezkielyna-image tidak muncul atau gagal start: jalankan node -v (harus 18 atau lebih baru) dan pastikan path file di konfigurasi benar. Claude Desktop dan Cursor kadang tidak menemukan node dari nvm; isi command dengan path lengkap hasil which node (macOS/Linux) atau where node (Windows).
• 401 atau 403: key salah, terpotong, atau saldo habis. Salin ulang key dan cek saldo di Wallet.
• model not found atau no available channel: key-nya bukan grup Media. Buat key baru dengan grup Media.
• File referensi tidak ditemukan: pakai path lengkap. Di Windows, path di file JSON ditulis dengan garis miring ganda.
• Agent berhenti membuat gambar: batas EZKIELYNA_MAX_IMAGES tercapai. Naikkan nilainya atau mulai sesi baru.

Panduan terkait: OpenCode dan Ezkielyna Agent · Claude Code + API bayar QRIS · daftar model dan harga · halaman unduhan Ezkielyna Agent

Ezkielyna adalah gateway API independen dan tidak berafiliasi dengan Anthropic, OpenAI atau pembuat alat yang disebut di halaman ini.