> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Hubungkan Krea ke agen yang kompatibel dengan MCP sehingga mereka dapat menemukan model, memeriksa skema, dan menghasilkan gambar atau video dari workspace Anda.

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.

<Info>
  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.
</Info>

## Detail Server

| Pengaturan  | Nilai                     |
| ----------- | ------------------------- |
| Transport   | Streamable HTTP           |
| URL         | `https://api.krea.ai/mcp` |
| Autentikasi | OAuth                     |

Penagihan bergantung pada cara Anda melakukan autentikasi:

| Metode autentikasi | Sumber penagihan                                              |
| ------------------ | ------------------------------------------------------------- |
| OAuth              | Compute unit pada workspace yang Anda pilih saat memberi izin |
| Token API          | Saldo 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.

<Note>
  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.
</Note>

Jika klien MCP Anda tidak mendukung OAuth, Anda dapat melakukan autentikasi menggunakan token API:

| Header key      | Header value            |
| --------------- | ----------------------- |
| `Authorization` | `Bearer KREA_API_TOKEN` |

Ganti `KREA_API_TOKEN` dengan token dari [krea.ai/app/api/tokens](https://www.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](/developers/api-keys-and-billing) untuk detail saldo API.

<Warning>
  Simpan kredensial MCP berbasis token API dengan cara yang sama seperti Anda menyimpan API key. Jangan commit file konfigurasi MCP yang berisi token asli.
</Warning>

## Claude Code

Jalankan perintah ini di terminal Anda:

```bash theme={null}
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:

```text theme={null}
https://api.krea.ai/mcp
```

5. 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`:

```json theme={null}
{
  "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:

```text theme={null}
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](/developers/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:

| Tool               | Apa fungsinya                                                                                              |
| ------------------ | ---------------------------------------------------------------------------------------------------------- |
| `list_models`      | Mendaftar model gambar dan video yang tersedia.                                                            |
| `get_model_schema` | Memeriksa skema input model sebelum menghasilkan.                                                          |
| `generate`         | Mengirimkan job pembuatan gambar atau video.                                                               |
| `execute_node_app` | Menjalankan sebuah node app.                                                                               |
| `get_job`          | Mengambil status dan output terkini sebuah job berdasarkan `jobId`.                                        |
| `cancel_job`       | Membatalkan job yang sedang berjalan dan menghapusnya dari daftar job Anda.                                |
| `get_upload_url`   | Meminta 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](/developers/job-lifecycle) untuk aturan dan implikasi penagihannya (job yang dibatalkan tidak ditagihkan).

Contoh prompt:

```text theme={null}
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:

```bash theme={null}
# 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.
```

<Info>
  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.
</Info>

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](https://modelcontextprotocol.io/). 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

| Masalah                           | Solusi                                                                                                                                                                                                                                                                                            |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Autentikasi gagal                 | Hubungkan 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 terhubung       | Pastikan klien dikonfigurasi untuk Streamable HTTP dan menggunakan `https://api.krea.ai/mcp`.                                                                                                                                                                                                     |
| Generasi ditolak karena penagihan | Jika 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](https://www.krea.ai/app/api). |
| Pemanggilan model gagal           | Minta agen Anda untuk memeriksa skema model sebelum mencoba lagi. Permintaan MCP menggunakan input model yang sama seperti API.                                                                                                                                                                   |

## Langkah Selanjutnya

<CardGroup cols={2}>
  <Card title="Kunci API & Penagihan" icon="key" href="/developers/api-keys-and-billing">
    Buat token API dan kelola saldo API untuk permintaan yang menggunakan autentikasi token.
  </Card>

  <Card title="Playground Interaktif" icon="rocket" href="/developers/interactiveexample">
    Coba permintaan di aplikasi Krea sebelum meminta agen menjalankannya.
  </Card>

  <Card title="Deprecations" icon="triangle-exclamation" href="/developers/deprecations">
    Lihat bagaimana MCP mengekspos metadata migrasi model.
  </Card>

  <Card title="Model APIs" icon="book-open" href="/api-reference/introduction">
    Telusuri skema endpoint dan parameter model.
  </Card>
</CardGroup>