Server MCP: gambar, video, dan suara di aplikasi AI

Berikan akses ke model gambar, video, dan suara Zurelay untuk Claude, ChatGPT, Cursor, VS Code, dan aplikasi AI lainnya. Hubungkan server MCP sekali, masuk, lalu minta gambar, klip, atau narasi suara di chat: konten dibuat dengan Nano Banana, GPT Image, Seedance, Kling, Wan, atau Gemini TTS dan dibayar dari saldo Zurelay Anda, dengan harga yang sama seperti API.

https://api.zurelay.com/mcp

Server ini berjalan secara jarak jauh (Streamable HTTP), jadi tidak ada yang perlu diinstal. Masuk dari aplikasi, atau kirim kunci API. Server ini terdaftar di MCP Registry resmi sebagai com.zurelay/mcp.

Fungsinya

Model chat bukan alat di sini: aplikasi yang berjalan dengan model sudah memilikinya. Untuk menjalankan Claude Code, Cursor, atau aplikasi lain dengan model chat Zurelay, cukup ubah URL dasarnya (lihat Integrasi).

Hubungkan aplikasi Anda

Semua aplikasi di bawah ini mendukung login: Anda cukup memberikan izin sekali di zurelay.com tanpa perlu menempelkan kunci. Aplikasi yang tidak mendukung login, atau konfigurasi yang tidak seharusnya membuka browser (server, CI), menggunakan kunci API.

Claude (web, desktop, dan seluler)

Tambahkan Zurelay ke Claude membuka formulir yang sudah terisi. Atau lakukan secara manual:

1. Buka Sesuaikan, lalu Konektor, pilih Tambahkan, lalu Tambahkan konektor kustom.
2. Beri nama Zurelay dan tempelkan https://api.zurelay.com/mcp sebagai URL server MCP. Kedua pilihan klien OAuth bisa digunakan: Gunakan identitas publik Claude atau Daftarkan otomatis. Lalu tambahkan.
3. Pilih Hubungkan. Zurelay akan terbuka: login, tentukan batas pengeluaran harian, lalu pilih Izinkan.
4. Di chat, buka +, lalu Konektor, aktifkan Zurelay dan minta apa yang Anda inginkan: “Buat poster 16:9 tentang…”, “Animasikan ini menjadi klip 5 detik”, “Bacakan ini dengan suara tenang”.

Konektor berfungsi di web, aplikasi desktop, dan ponsel Anda, di semua paket (Free mengizinkan satu konektor kustom). Di Team dan Enterprise, pemilik menambahkan Zurelay melalui Pengaturan organisasi, Konektor (Tambahkan, Kustom, Web); setiap anggota kemudian menghubungkan akun Zurelay masing-masing.

Claude Code

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp

Lalu ketik /mcp di Claude Code, pilih zurelay, dan login di browser yang terbuka (atau jalankan claude mcp login zurelay). Jika menggunakan kunci API, browser tidak diperlukan:

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp \
  --header "Authorization: Bearer $ZURELAY_API_KEY"

--scope user menambahkannya untuk semua folder. Tanpa opsi ini, konektor hanya muncul saat Claude Code berjalan di folder tempat Anda menambahkannya; gunakan --scope project untuk membagikannya melalui .mcp.json proyek (jangan simpan kunci dalam file bersama: .mcp.json membaca ${ZURELAY_API_KEY} dari lingkungan). Jalankan perintah di terminal biasa, bukan di dalam Claude Code, lalu mulai ulang Claude Code jika sudah terbuka.

ChatGPT

1. Di Pengaturan, Keamanan dan login, aktifkan Mode pengembang (Plus, Pro, Business, Enterprise, dan Edu; admin ruang kerja mungkin perlu mengizinkannya).
2. Buka Plugin ChatGPT dan tekan +. Beri nama Zurelay dan masukkan https://api.zurelay.com/mcp sebagai URL koneksi, dengan OAuth.
3. Login ke Zurelay dan pilih Izinkan. Di chat, buka +, pilih Mode pengembang, lalu pilih Zurelay.

ChatGPT hanya mendukung login: tidak dapat mengirim kunci API.

Cursor

Tambahkan Zurelay ke Cursor, lalu pilih Hubungkan di sampingnya pada pengaturan MCP Cursor untuk login. Atau tambahkan ke ~/.cursor/mcp.json (semua proyek) atau .cursor/mcp.json (satu proyek):

{
  "mcpServers": {
    "zurelay": {
      "url": "https://api.zurelay.com/mcp"
    }
  }
}

VS Code

Tambahkan Zurelay ke VS Code, atau tambahkan ke .vscode/mcp.json di proyek Anda (atau jalankan MCP: Add Server dari Palet Perintah dan pilih HTTP). VS Code meminta Anda login saat mode agen Copilot pertama kali menggunakannya. Jika menggunakan kunci API, Anda hanya diminta memasukkan kunci sekali, lalu kunci disimpan dalam bentuk terenkripsi:

{
  "servers": {
    "zurelay": {
      "type": "http",
      "url": "https://api.zurelay.com/mcp"
    }
  }
}

Agen AI

Agen yang selalu aktif dan agen pribadi menambahkan server dengan cara yang sama: Grok Bot dan Meta Muse melalui pesan yang Anda tempelkan untuk memintanya, OpenAI dots melalui plugin ChatGPT, serta Gemini Spark, Manus, dan Perplexity melalui pengaturan konektor masing-masing. OpenClaw dan Hermes Agent juga dapat menggunakannya, atau memakai skill Zurelay, yang memberi mereka kunci sendiri melalui tautan yang Anda setujui. Langkah-langkah untuk setiap agen tersedia di Agen AI.

Codex, Gemini CLI, dan aplikasi lainnya

Semua aplikasi yang mendukung MCP melalui Streamable HTTP dapat digunakan. Codex login dengan codex mcp login zurelay dan Gemini CLI dengan /mcp auth zurelay; untuk kunci, sebagian besar aplikasi menerima header Authorization:

# or: codex mcp add zurelay --url 'https://api.zurelay.com/mcp' --bearer-token-env-var ZURELAY_API_KEY
[mcp_servers.zurelay]
url = "https://api.zurelay.com/mcp"
bearer_token_env_var = "ZURELAY_API_KEY"

Login atau kunci API

Login adalah cara yang mudah dan lebih aman. Aplikasi membuka zurelay.com, tempat Anda login dengan kode yang dikirim lewat email, memilih ruang kerja yang saldonya akan digunakan dan batas pengeluaran harian, lalu memberikan izin. Zurelay kemudian menambahkan kunci dengan nama aplikasi, seperti “Claude (MCP)”, ke halaman Kunci Anda, dengan batas tersebut. Aplikasi tidak pernah melihat kunci API: aplikasi menyimpan token yang berlaku selama satu jam dan token penyegaran yang berubah setiap kali digunakan, dan keduanya hanya berlaku di server MCP, bukan di bagian API lainnya. Ubah batas di halaman Kunci, atau cabut kunci di sana untuk memutus koneksi aplikasi.

API Kunci dimasukkan ke header Authorization: Bearer zr_live_…. Semua pengaturan kunci berlaku: anggaran, batas laju, model yang diizinkan, dan alamat IP yang diizinkan. Buat kunci khusus untuk aplikasi, dengan anggaran harian, agar agen yang sibuk tidak membelanjakan lebih dari yang Anda rencanakan (lihat Batas dan aturan kunci). Aplikasi seperti Claude dan ChatGPT mengirim permintaan dari server mereka sendiri, jadi kosongkan alamat IP yang diizinkan pada kunci yang ditujukan untuk aplikasi tersebut.

Harga, tautan, dan waktu tunggu

• Harganya sama dengan API: lihat setiap model di Model halaman, atau minta AI memanggil list_models. Permintaan yang gagal tidak dikenakan biaya, dan video baru ditagih setelah selesai.
• Tool merespons dalam sekitar 35 detik. Gambar dan ucapan biasanya sudah selesai saat itu; proses yang lebih lama (sebagian besar video) mengembalikan id, lalu AI memanggil get_result, yang menunggu hingga 45 detik lagi setiap kali dipanggil.
• Hasilnya berupa tautan ke penyimpanan kami, berlaku selama 24 jam. Gambar dan video tersimpan di Koleksi Anda selama 30 hari, dan setiap permintaan muncul di halaman Permintaan seperti permintaan lainnya.
• Gambar juga dikembalikan sebagai pratinjau kecil, sehingga AI bisa melihat hasilnya dan menyesuaikannya. Minta AI untuk tidak menyertakan pratinjau agar menghemat konteks.

File dari komputer Anda

Untuk mengedit gambar atau menganimasikan frame, model memerlukan file yang bisa diakses lewat tautan. File yang sudah online bisa diberikan lewat tautan https. Untuk file di komputer Anda, aplikasi yang bisa menjalankan perintah (Claude Code, Cursor, Codex) menggunakan create_upload_link: satu file PNG, JPEG, WebP, MP4, MOV, MP3 atau WAV berukuran hingga 20 MB, diunggah dalam 15 menit. Tautan yang dikembalikan berlaku selama 2 jam, dan file dihapus setelah 2 hari. Tautan unggahan memerlukan saldo di akun.

# 1. The agent calls create_upload_link and gets a one-time URL.
# 2. It uploads the file with curl:
curl -sS -T ./product-photo.png 'https://api.zurelay.com/mcp/uploads/…'
# {"url":"https://…/inputs/2026-10-05/….png","type":"image/png","bytes":482113,…}
# 3. It passes that url to generate_image's reference_images or generate_video's first_frame.

Keamanan

• Proses masuk mengikuti spesifikasi MCP: OAuth 2.1 dengan PKCE (hanya S256), hanya alamat pengalihan yang terdaftar, dan kode sekali pakai yang berlaku selama 5 menit. Jika kode dipakai dua kali, apa pun yang diperoleh dari penukaran kode itu akan dinonaktifkan.
• Token bersifat acak dan hanya disimpan sebagai hash SHA-256. Token akses berlaku selama satu jam dan hanya bisa digunakan di server MCP. Token refresh berubah setiap kali digunakan; jika token dipakai lagi setelah lebih dari satu menit, berarti token telah disalin, sehingga koneksi diputus dan kuncinya dicabut.
• Setiap koneksi berupa kunci di halaman Kunci Anda dengan batas harian tersendiri, yang terlihat oleh anggota ruang kerja Anda. Mencabut kunci atau keluar dari ruang kerja akan memutus koneksi aplikasi.
• Halaman persetujuan tidak bisa ditampilkan di dalam situs lain, dan memberi tahu Anda jika aplikasi tidak dikenali Zurelay serta ke mana Anda akan diarahkan kembali.
• Tautan unggahan ditandatangani, menerima satu file, dan kedaluwarsa dalam 15 menit; file yang diunggah dihapus setelah 2 hari.
• Setiap kunci dan ruang kerja memiliki batas laju tersendiri untuk panggilan MCP, dan setiap panggilan dalam batch tetap dihitung.

Untuk pengembang

Server menggunakan MCP 2025-11-25 (serta 2025-06-18, 2025-03-26 dan 2024-11-05) melalui Streamable HTTP: kirim JSON-RPC dengan POST ke https://api.zurelay.com/mcp dan dapatkan respons JSON. Server tidak menyimpan sesi, jadi tidak ada server-sent events dan GET mengembalikan 405. Tanpa token, server mengembalikan 401 dengan WWW-Authenticate yang mengarah ke https://api.zurelay.com/.well-known/oauth-protected-resource/mcp; metadata server otorisasi tersedia di https://api.zurelay.com/.well-known/oauth-authorization-server, dengan pendaftaran klien dinamis.

curl https://api.zurelay.com/mcp \
  -H "Authorization: Bearer $ZURELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "generate_image",
      "arguments": { "prompt": "A lighthouse at dusk, oil painting", "model": "nano-banana-pro" }
    }
  }'

Pemecahan masalah

• zurelay tidak tercantum di Claude Code pada /mcp: zurelay ditambahkan untuk folder lain, atau Claude Code sudah berjalan. Tutup Claude Code, jalankan perintah di atas (dengan --scope user) di terminal biasa, lalu buka kembali Claude Code. claude mcp list menampilkannya sebagai perlu autentikasi sampai Anda masuk.
• Aplikasi terus meminta Anda masuk: kunci yang dibuatnya telah dicabut, atau akses masuknya tidak digunakan selama setahun. Hubungkan kembali aplikasi.
• “Saldo Zurelay Anda kosong” atau “telah mencapai anggaran hariannya”: tambahkan saldo di halaman Tagihan, atau naikkan batas kunci di halaman Kunci.
• “Token ini milik aplikasi yang terhubung melalui server MCP Zurelay”: Anda mengirim token aplikasi ke API. Gunakan kunci API untuk mengaksesnya.
• Video tampak macet: minta AI memanggil get_result lagi; pembuatan video memerlukan 1 hingga 5 menit, terkadang lebih lama saat model sedang sibuk.