Server MCP
Hubungkan Claude Desktop, Cursor, atau agen lokal ke XPlor3, lalu minta agen membuat gambar dan video dari percakapan.
XPlor3 menyediakan server Model Context Protocol resmi. Begitu terpasang, agen AI di klien MCP bisa melihat katalog model, memulai generate, menunggu hasilnya, dan memberimu tautan unduhan, semuanya dari percakapan biasa.
Alamat
https://mcp.xplor3.space/mcpTransportnya HTTP (streamable HTTP), dengan kunci API di header Authorization. Belum punya kunci? Buat dulu di Kredensial.
Memasang di klien
Tempel blok ini ke berkas konfigurasi MCP di klienmu, lalu ganti xpk_kunci_kamu dengan kunci aslimu. Halaman Kredensial studio menampilkan blok yang sama, siap disalin.
{
"mcpServers": {
"xplor3": {
"type": "http",
"url": "https://mcp.xplor3.space/mcp",
"headers": {
"Authorization": "Bearer xpk_kunci_kamu"
}
}
}
}Buka Settings > Developer > Edit Config, tempel blok di atas ke claude_desktop_config.json, simpan, lalu mulai ulang Claude Desktop. Server xplor3 muncul di daftar alat percakapan.
Buka Settings > MCP dan tambahkan server baru, atau tempel blok di atas ke .cursor/mcp.json di proyekmu (atau ~/.cursor/mcp.json untuk semua proyek).
Klien apa pun yang mendukung server MCP lewat HTTP dengan header kustom bisa memakai alamat dan header yang sama. Klien yang hanya mendukung stdio butuh jembatan HTTP ke stdio dari klien itu sendiri.
Alat yang tersedia
| Alat | Gunanya |
|---|---|
whoami | Akun pemilik kunci dan apakah akun itu boleh memakai kredit |
get_balance | Saldo kredit saat ini |
list_models | Semua model yang bisa dijalankan, dengan jenis, pembuat, dan biaya awalnya |
describe_model | Field, setelan bawaan, dan varian satu model, supaya input untuk generate bisa disusun dengan benar |
generate | Memulai generate dan mengembalikan id job, biaya, dan sisa saldo. Bisa ditambah webhookUrl |
wait_for_generation | Menunggu di server sampai job selesai, lalu mengembalikan job-nya. Satu panggilan, tanpa polling |
get_generation | Status satu job dan id berkas hasilnya |
cancel_generation | Membatalkan job yang masih antre dan mengembalikan kreditnya |
list_generations | Riwayat generate akun, terbaru lebih dulu |
get_asset_links | Tautan unduhan berumur pendek untuk berkas hasil |
upload_reference | Mengunggah gambar, video, atau audio acuan sebagai base64 |
list_projects | Daftar proyek akun |
create_project | Membuat proyek baru |
add_to_project | Memasukkan hasil ke proyek |
Alur yang biasa dijalankan agen: list_models, lalu describe_model untuk model pilihannya, lalu generate, lalu wait_for_generation, lalu get_asset_links.
wait_for_generation menunggu paling lama 50 detik secara bawaan, dan bisa diatur sampai 120 detik dengan timeoutSeconds. Gambar biasanya selesai dalam satu panggilan. Untuk video, jawabannya bisa finished: false dengan status dan progres terakhir, lalu agen cukup memanggilnya sekali lagi.
Field input setiap model, termasuk nilai yang diterima dan aturan per tier atau mode, ada di Referensi model. describe_model mengembalikan data yang sama dalam bentuk JSON.
Contoh permintaan
Setelah terpasang, cukup minta dalam bahasa biasa:
Buatkan tiga variasi foto produk sepatu lari putih di atas lintasan atletik saat matahari terbenam, pakai Nano Banana 2 resolusi 1K, lalu masukkan hasilnya ke proyek Ads.
Agen akan memeriksa saldo dan biaya, menjalankan generate, menunggu hasilnya, lalu memberimu tautan unduhan.
Yang perlu diketahui
- Kredit dipotong saat
generatedipanggil, bukan saat selesai, dengan tarif yang sama seperti di studio. Balasannya memuat biaya dan sisa saldo. - Batal hanya saat antre. Job yang sudah dikirim ke model tidak bisa dibatalkan (
JOB_ALREADY_SENT) dan hasilnya tetap dikirim. - Model gambar dan video. Model suara dan Workflow belum tersedia lewat MCP.
- Batas berjalan bersamaan dan batas request sama dengan REST API. Lihat Batas dan error.