Langsung ke konten utama
Krea menyediakan server Model Context Protocol (MCP) terkelola untuk agen dan asisten coding. Gunakan ini ketika Anda ingin klien yang kompatibel dengan MCP memanggil Krea secara langsung tanpa harus menulis permintaan API secara manual.
Anda tidak memerlukan API key untuk terhubung. Tambahkan https://api.krea.ai/mcp sebagai URL server MCP, lalu masuk dengan akun Krea Anda melalui alur OAuth pada klien Anda.

​
Detail Server

PengaturanNilai
TransportStreamable HTTP
URLhttps://api.krea.ai/mcp
AutentikasiOAuth
Penagihan bergantung pada cara Anda melakukan autentikasi:
Metode autentikasiSumber penagihan
OAuthCompute unit pada workspace yang Anda pilih saat memberi izin
Token APISaldo API terpisah milik workspace Anda

​
Autentikasi

Sebagian besar klien MCP menggunakan OAuth secara otomatis. Ketika klien meminta Anda untuk terhubung, ikuti alur masuk di browser dan otorisasi Krea.

​
Pilih workspace saat memberi izin

Layar persetujuan OAuth menyertakan pemilih Workspace yang menampilkan semua workspace yang Anda ikuti. Workspace default Anda sudah terpilih sebelumnya; pilih yang lain jika Anda ingin sesi MCP ini berjalan di tempat lain (misalnya, workspace studio bersama alih-alih workspace pribadi Anda). Workspace yang Anda pilih terikat pada sesi OAuth dan menentukan:
  • Penagihan. Compute unit dipotong dari workspace yang dipilih, bukan hanya dari akun yang sedang Anda gunakan.
  • Cakupan aset. File yang diunggah melalui tool seperti upload_asset disimpan ke workspace yang terikat, dan tool yang memerlukan unggahan (misalnya, get_upload_url) hanya berfungsi setelah sebuah workspace terikat.
Untuk mengganti workspace yang terikat di kemudian hari, putuskan koneksi Krea di klien MCP Anda dan hubungkan kembali — Anda akan melihat pemilih tersebut lagi.
Sesi OAuth lama yang dibuat sebelum pemilih workspace dirilis tidak memiliki binding eksplisit. Sesi tersebut akan kembali menggunakan workspace default akun Anda. Hubungkan kembali untuk mengikat sesi ke workspace tertentu.
Jika klien MCP Anda tidak mendukung OAuth, Anda dapat melakukan autentikasi menggunakan token API:
Header keyHeader value
AuthorizationBearer KREA_API_TOKEN
Ganti KREA_API_TOKEN dengan token dari krea.ai/app/api/tokens. Hanya pemilik dan admin workspace yang dapat membuat token API. Penggunaan token API ditagihkan ke saldo API workspace Anda, sama seperti panggilan API langsung. Lihat Kunci API & Penagihan untuk detail saldo API.
Simpan kredensial MCP berbasis token API dengan cara yang sama seperti Anda menyimpan API key. Jangan commit file konfigurasi MCP yang berisi token asli.

​
Claude Code

Jalankan perintah ini di terminal Anda: 
claude mcp add --transport http krea-ai https://api.krea.ai/mcp
Masuk dengan akun Krea Anda saat Claude Code meminta Anda untuk terhubung. Mulai ulang Claude Code atau muat ulang server MCP Anda setelah menambahkan server.

​
Codex

  1. Buka Settings > MCP servers di Codex.
  2. Tambahkan server baru.
  3. Pilih Streamable HTTP sebagai transport.
  4. Tempelkan URL server:
https://api.krea.ai/mcp
  1. Simpan server dan masuk dengan akun Krea Anda saat Codex meminta Anda untuk terhubung.

​
Cursor

Buka command palette, cari Open MCP settings, lalu tambahkan entri berikut ke mcp.json: 
{
  "mcpServers": {
    "krea-ai": {
      "url": "https://api.krea.ai/mcp"
    }
  }
}
Mulai ulang Cursor setelah menyimpan file, lalu masuk dengan akun Krea Anda saat Cursor meminta Anda untuk terhubung.

​
Menggunakan Krea Melalui MCP

Setelah terhubung, minta agen Anda untuk mendaftar model Krea atau memeriksa skema model sebelum menghasilkan. ID model sesuai dengan path API yang digunakan di seluruh dokumentasi developer, seperti image/krea/krea-2/medium atau video/google/veo-3.1. Sebagai contoh: 
List the available Krea image models, then generate an image with Krea 2 using a 16:9 aspect ratio.
Jika sebuah model dideprekasi, Krea mengembalikan metadata deprekasi melalui MCP model discovery. Lihat Deprecations untuk panduan migrasi.

​
Tools

Server MCP Krea mengekspos tool yang memetakan ke API publik. Agen Anda menemukannya secara otomatis melalui tools/list; yang paling umum adalah:
ToolApa fungsinya
list_modelsMendaftar model gambar dan video yang tersedia.
get_model_schemaMemeriksa skema input model sebelum menghasilkan.
generateMengirimkan job pembuatan gambar atau video.
execute_node_appMenjalankan sebuah node app.
get_jobMengambil status dan output terkini sebuah job berdasarkan jobId.
cancel_jobMembatalkan job yang sedang berjalan dan menghapusnya dari daftar job Anda.
get_upload_urlMeminta URL presigned berumur singkat untuk mengunggah file lokal yang akan digunakan sebagai input model.
Output tool generation dan node-app menyertakan job_id dari job yang dikirimkan bersama payload job. Berikan ID tersebut ke get_job untuk memeriksa status, atau ke cancel_job untuk menghentikan job yang sudah tidak Anda perlukan.

​
Membatalkan job

cancel_job memanggil DELETE /jobs/{id} di belakang layar dan mengembalikan { "job_id": "...", "deleted": true } jika berhasil. Pembatalan hanya berlaku selama job berada dalam status non-terminal — lihat Job Lifecycle untuk aturan dan implikasi penagihannya (job yang dibatalkan tidak ditagihkan). Contoh prompt: 
Cancel job 7f3c9b1a-… because the prompt was wrong.

​
Menyediakan input media

Setiap input model yang menerima URL media (misalnya start_image, image_style_references[].url, atau reference_images) menerima salah satu dari tiga bentuk:
  • URL eksternal — tautan https:// yang dapat diakses publik ke file gambar, video, audio, atau model 3D.
  • Data URI base64 — misalnya data:image/png;base64,iVBORw0KGgo….
  • URL aset yang telah diunggah — URL yang dikembalikan setelah mengunggah file lokal ke Krea.
Daftar URL yang dipisahkan koma tidak didukung. Berikan setiap input sebagai field atau elemen array tersendiri.

​
Mengunggah file lokal dengan get_upload_url

Ketika file yang ingin Anda gunakan berada di mesin lokal Anda dan belum dihosting di mana pun, minta agen Anda untuk memanggil get_upload_url. Tool tersebut mengembalikan URL presigned yang berlaku selama tiga jam. Klien Anda kemudian melakukan POST file ke URL tersebut sebagai multipart/form-data dengan satu field file, dan body respons berisi URL aset yang dapat Anda berikan ke panggilan generate berikutnya. Contoh alur: 
# 1. Ask the agent to call get_upload_url through MCP. It returns something like:
#    https://api.krea.ai/public-api/assets/presigned/...

# 2. POST the local file to that presigned URL.
curl -X POST "$UPLOAD_URL" -F "file=@/path/to/image.png"

# 3. The response body contains the asset URL. Use it in the next generate call,
#    for example as start_image or image_style_references[].url.
Jika POST unggahan gagal karena egress jaringan yang dibatasi, tambahkan api.krea.ai ke daftar domain yang diizinkan pada klien Anda. URL presigned disajikan dari host yang sama dengan API publik lainnya.
Jika file Anda sudah dapat diakses pada URL publik atau Anda dapat mengkodekannya sebagai data URI base64, lewati get_upload_url dan berikan nilai tersebut langsung ke input generation.

​
Widget UI MCP Apps

Pemanggilan tool generation dan node-app menyertakan sumber daya UI MCP Apps. Klien MCP yang mendukung MCP Apps merender widget hasil-job interaktif sebaris dengan respons tool, termasuk:
  • Tile loading dengan ukuran sesuai aspect ratio job selama job berada dalam antrian atau sedang diproses.
  • Polling otomatis terhadap get_job sehingga widget diperbarui seiring perkembangan job, tanpa agen perlu memanggil get_job sendiri.
  • Tombol aksi untuk mencoba ulang generation atau membatalkan job dari dalam widget.
  • Slider perbandingan before/after fullscreen untuk hasil enhance.
Widget diekspos sebagai sumber daya ui://krea-public-api/job-result-frame dan disiapkan secara otomatis — tidak diperlukan konfigurasi klien. Klien yang tidak mendukung MCP Apps cukup mengabaikan sumber daya tersebut dan kembali ke output tool yang terstruktur. Karena widget melakukan polling untuk Anda, lebih baik gunakan generation asinkron (default) ketika Anda ingin UI menampilkan progres. Gunakan mode sinkron hanya ketika pengguna secara eksplisit meminta untuk menunggu hasil akhir di dalam respons tool.

​
Pemecahan Masalah

MasalahSolusi
Autentikasi gagalHubungkan kembali server MCP dan selesaikan alur OAuth Krea di browser Anda. Jika Anda menggunakan token API, pastikan header tepat berupa Authorization: Bearer KREA_API_TOKEN dan token belum dicabut.
Klien tidak dapat terhubungPastikan klien dikonfigurasi untuk Streamable HTTP dan menggunakan https://api.krea.ai/mcp.
Generasi ditolak karena penagihanJika Anda terhubung dengan OAuth, periksa compute unit pada workspace yang Anda pilih saat memberi izin — hubungkan kembali jika Anda perlu mengikat sesi ke workspace yang berbeda. Jika Anda terhubung dengan token API, tambahkan saldo API di krea.ai/app/api.
Pemanggilan model gagalMinta agen Anda untuk memeriksa skema model sebelum mencoba lagi. Permintaan MCP menggunakan input model yang sama seperti API.

​
Langkah Selanjutnya

Kunci API & Penagihan

Buat token API dan kelola saldo API untuk permintaan yang menggunakan autentikasi token.

Playground Interaktif

Coba permintaan di aplikasi Krea sebelum meminta agen menjalankannya.

Deprecations

Lihat bagaimana MCP mengekspos metadata migrasi model.

Model APIs

Telusuri skema endpoint dan parameter model.