MCP

Krea, ajanlar ve kodlama asistanları için barındırılan bir Model Context Protocol (MCP) sunucusu sunar. MCP uyumlu bir istemcinin API isteklerini elle yazmak yerine doğrudan Krea’yı çağırmasını istediğinizde bunu kullanın.

Bağlanmak için API anahtarına ihtiyacınız yoktur. MCP sunucu URL’si olarak https://api.krea.ai/mcp adresini ekleyin, ardından istemcinizin OAuth akışıyla Krea hesabınızla oturum açın.

Sunucu Detayları

Ayar	Değer
Aktarım	Streamable HTTP
URL	`https://api.krea.ai/mcp`
Kimlik Doğrulama	OAuth

Faturalandırma, nasıl kimlik doğruladığınıza bağlıdır:

Kimlik doğrulama yöntemi	Faturalandırma kaynağı
OAuth	Onay sırasında seçtiğiniz çalışma alanındaki hesaplama birimleri
API token	Çalışma alanınızın ayrı API bakiyesi

Kimlik Doğrulama

Çoğu MCP istemcisi OAuth’u otomatik olarak kullanır. İstemci sizden bağlanmanızı istediğinde, tarayıcıdaki oturum açma akışını takip edin ve Krea’ya yetki verin.

Onay sırasında bir çalışma alanı seçin

OAuth onay ekranı, ait olduğunuz tüm çalışma alanlarını listeleyen bir Çalışma alanı seçici içerir. Varsayılan çalışma alanınız önceden seçilidir; bu MCP oturumunun başka bir yerde çalışmasını istiyorsanız (örneğin, kişisel çalışma alanınız yerine paylaşılan bir stüdyo çalışma alanı) farklı bir tane seçin. Seçtiğiniz çalışma alanı OAuth oturumuna bağlanır ve şunları belirler:

Faturalandırma. Hesaplama birimleri yalnızca oturum açılan hesaptan değil, seçilen çalışma alanından düşülür.
Varlık kapsamı. upload_asset gibi araçlar üzerinden yüklenen dosyalar bağlı çalışma alanına kaydedilir ve yükleme gerektiren araçlar (örneğin get_upload_url) yalnızca bir çalışma alanı bağlandıktan sonra çalışır.

Bağlı çalışma alanını daha sonra değiştirmek için, MCP istemcinizde Krea bağlantısını kesip yeniden bağlanın — seçiciyi tekrar göreceksiniz.

Çalışma alanı seçici yayına alınmadan önce oluşturulan eski OAuth oturumlarının açık bir bağlanması yoktur. Bu oturumlar hesabınızın varsayılan çalışma alanına geri döner. Oturumu belirli bir çalışma alanına bağlamak için yeniden bağlanın.

MCP istemciniz OAuth’u desteklemiyorsa, bunun yerine bir API token ile kimlik doğrulayabilirsiniz:

Header anahtarı	Header değeri
`Authorization`	`Bearer KREA_API_TOKEN`

KREA_API_TOKEN değerini krea.ai/app/api/tokens adresinden alacağınız bir token ile değiştirin. Yalnızca çalışma alanı sahipleri ve yöneticiler API token oluşturabilir. API token kullanımı, doğrudan API çağrılarıyla aynı şekilde çalışma alanınızın API bakiyesinden faturalandırılır. API bakiyesi detayları için API Anahtarları ve Faturalandırma sayfasına bakın.

API token MCP kimlik bilgilerini, API anahtarlarını sakladığınız şekilde saklayın. Gerçek tokenlar içeren MCP yapılandırma dosyalarını commit etmeyin.

Claude Code

Terminalinizde şu komutu çalıştırın:

claude mcp add --transport http krea-ai https://api.krea.ai/mcp

Claude Code sizden bağlanmanızı istediğinde Krea hesabınızla oturum açın. Sunucuyu ekledikten sonra Claude Code’u yeniden başlatın veya MCP sunucularınızı yeniden yükleyin.

Codex

Codex’te Settings > MCP servers bölümünü açın.
Yeni bir sunucu ekleyin.
Aktarım olarak Streamable HTTP seçin.
Sunucu URL’sini yapıştırın:

https://api.krea.ai/mcp

Sunucuyu kaydedin ve Codex sizden bağlanmanızı istediğinde Krea hesabınızla oturum açın.

Cursor

Komut paletini açın, Open MCP settings araması yapın, ardından mcp.json dosyanıza şu girişi ekleyin:

{
  "mcpServers": {
    "krea-ai": {
      "url": "https://api.krea.ai/mcp"
    }
  }
}

Dosyayı kaydettikten sonra Cursor’ı yeniden başlatın, ardından Cursor sizden bağlanmanızı istediğinde Krea hesabınızla oturum açın.

Krea’yı MCP Üzerinden Kullanma

Bağlandıktan sonra, ajanınızdan üretim yapmadan önce Krea modellerini listelemesini veya bir model şemasını incelemesini isteyin. Model kimlikleri, geliştirici dokümanlarının geri kalanında kullanılan API yollarıyla eşleşir; örneğin image/krea/krea-2/medium veya video/google/veo-3.1. Örneğin:

List the available Krea image models, then generate an image with Krea 2 using a 16:9 aspect ratio.

Bir model kullanımdan kaldırıldıysa, Krea kullanımdan kaldırma meta verilerini MCP model keşfi aracılığıyla döndürür. Geçiş rehberi için Kullanımdan Kaldırmalar sayfasına bakın.

Araçlar

Krea MCP sunucusu, herkese açık API ile eşleşen araçlar sunar. Ajanınız bunları tools/list üzerinden otomatik olarak keşfeder; en yaygın olanları şunlardır:

Araç	Ne yapar
`list_models`	Kullanılabilir görsel ve video modellerini listeler.
`get_model_schema`	Üretim yapmadan önce bir modelin girdi şemasını inceler.
`generate`	Bir görsel veya video üretim işi gönderir.
`execute_node_app`	Bir node uygulamasını çalıştırır.
`get_job`	Bir işin güncel durumunu ve çıktısını `jobId` ile getirir.
`cancel_job`	Devam eden bir işi iptal eder ve iş listenizden siler.
`get_upload_url`	Model girdisi olarak kullanılmak üzere yerel bir dosyayı yüklemek için kısa ömürlü bir presigned URL talep eder.

Üretim ve node uygulaması araçlarının çıktıları, iş yüküyle birlikte gönderilen işin job_id değerini içerir. Bu kimliği durumu sorgulamak için get_job’a ya da artık ihtiyacınız olmayan bir işi durdurmak için cancel_job’a iletin.

Bir işi iptal etme

cancel_job arka planda DELETE /jobs/{id} çağrısını yapar ve başarılı olduğunda { "job_id": "...", "deleted": true } döndürür. İptal yalnızca iş tamamlanmamış bir durumdayken etkili olur — kurallar ve faturalandırma sonuçları için İş Yaşam Döngüsü sayfasına bakın (iptal edilen işler faturalandırılmaz). Örnek istem:

Cancel job 7f3c9b1a-… because the prompt was wrong.

Medya girdileri sağlama

Bir medya URL’si kabul eden herhangi bir model girdisi (örneğin start_image, image_style_references[].url veya reference_images) üç biçimden birini kabul eder:

Harici bir URL — bir görsel, video, ses veya 3D model dosyasına herkese açık şekilde erişilebilen bir https:// bağlantısı.
Bir base64 data URI — örneğin data:image/png;base64,iVBORw0KGgo….
Yüklenmiş bir varlık URL’si — yerel bir dosyayı Krea’ya yükledikten sonra döndürülen URL.

Virgülle ayrılmış URL listeleri desteklenmez. Her girdiyi kendi alanı veya dizi öğesi olarak iletin.

`get_upload_url` ile yerel bir dosya yükleme

Kullanmak istediğiniz dosya yerel makinenizde olduğunda ve henüz bir yerde barındırılmadığında, ajanınızdan get_upload_url çağırmasını isteyin. Araç, üç saat boyunca geçerli olan bir presigned URL döndürür. İstemciniz daha sonra dosyayı bu URL’ye tek bir file alanı içeren multipart/form-data olarak POST eder ve yanıt gövdesinde sonraki bir generate çağrısına iletebileceğiniz bir varlık URL’si bulunur. Örnek akış:

# 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.

Yükleme POST isteği, kısıtlı ağ çıkışı nedeniyle başarısız olursa, istemcinizin alan adı izin listesine api.krea.ai adresini ekleyin. Presigned URL, herkese açık API’nin geri kalanıyla aynı sunucudan sunulur.

Dosyanız zaten herkese açık bir URL’de erişilebilir durumdaysa veya onu bir base64 data URI olarak kodlayabiliyorsanız, get_upload_url adımını atlayın ve bu değeri doğrudan üretim girdisine iletin.

MCP Apps UI bileşeni

Üretim ve node uygulaması araç çağrıları, bir MCP Apps UI kaynağı ekler. MCP Apps’i destekleyen MCP istemcileri, araç yanıtının yanında etkileşimli bir iş sonucu bileşeni gösterir; bu bileşen şunları içerir:

İş sıraya alındığında veya işlenirken, işin en-boy oranına göre boyutlandırılmış bir yükleme karosu.
Bileşenin, ajan kendisi get_job çağırmadan iş ilerledikçe güncellenmesi için get_job için otomatik sorgulama.
Üretimi yeniden denemek veya işi bileşenin içinden iptal etmek için eylem düğmeleri.
Enhance sonuçları için tam ekran öncesi/sonrası karşılaştırma kaydırıcısı.

Bileşen, ui://krea-public-api/job-result-frame kaynağı olarak sunulur ve otomatik olarak bağlanır — istemci yapılandırmasına gerek yoktur. MCP Apps’i desteklemeyen istemciler kaynağı yok sayar ve yapılandırılmış araç çıktısını kullanır. Bileşen sorgulamayı sizin yerinize yaptığından, kullanıcı arayüzünün ilerlemeyi göstermesini istediğinizde asenkron üretimi (varsayılan) tercih edin. Senkron modu yalnızca kullanıcı, nihai sonucu araç yanıtında beklemenizi açıkça istediğinde kullanın.

Sorun Giderme

Sorun	Çözüm
Kimlik doğrulama başarısız	MCP sunucusunu yeniden bağlayın ve tarayıcınızda Krea OAuth akışını tamamlayın. Bir API token kullanıyorsanız, başlığın tam olarak `Authorization: Bearer KREA_API_TOKEN` olduğunu ve tokenın iptal edilmediğini doğrulayın.
İstemci bağlanamıyor	İstemcinin Streamable HTTP için yapılandırıldığını ve `https://api.krea.ai/mcp` adresini kullandığını doğrulayın.
Üretim faturalandırma nedeniyle reddedildi	OAuth ile bağlandıysanız, onay sırasında seçtiğiniz çalışma alanındaki hesaplama birimlerini kontrol edin — oturumu farklı bir çalışma alanına bağlamanız gerekiyorsa yeniden bağlanın. Bir API token ile bağlandıysanız, krea.ai/app/api adresinden API bakiyesi ekleyin.
Model çağrısı başarısız	Yeniden denemeden önce ajanınızdan model şemasını incelemesini isteyin. MCP istekleri, API ile aynı model girdilerini kullanır.

Sonraki Adımlar

API Anahtarları ve Faturalandırma

Token ile kimlik doğrulanan istekler için API tokenları oluşturun ve API bakiyesini yönetin.

İnteraktif Playground

Bir ajandan çalıştırmasını istemeden önce istekleri Krea uygulamasında deneyin.

Kullanımdan Kaldırmalar

MCP’nin model geçiş meta verilerini nasıl sunduğunu görün.

Model API'leri

Uç nokta şemalarına ve model parametrelerine göz atın.

Başlarken

Krea 2

Temel Kavramlar

Kod Örnekleri

Sunucu Detayları

Kimlik Doğrulama

Onay sırasında bir çalışma alanı seçin

Claude Code

Codex

Cursor

Krea’yı MCP Üzerinden Kullanma

Araçlar

Bir işi iptal etme

Medya girdileri sağlama

`get_upload_url` ile yerel bir dosya yükleme

MCP Apps UI bileşeni

Sorun Giderme

Sonraki Adımlar

API Anahtarları ve Faturalandırma

İnteraktif Playground

Kullanımdan Kaldırmalar

Model API'leri

​Sunucu Detayları

​Kimlik Doğrulama

​Onay sırasında bir çalışma alanı seçin

​Claude Code

​Codex

​Cursor

​Krea’yı MCP Üzerinden Kullanma

​Araçlar

​Bir işi iptal etme

​Medya girdileri sağlama

​get_upload_url ile yerel bir dosya yükleme

​MCP Apps UI bileşeni

​Sorun Giderme

​Sonraki Adımlar

API Anahtarları ve Faturalandırma

İnteraktif Playground

Kullanımdan Kaldırmalar

Model API'leri

Sunucu Detayları

Kimlik Doğrulama

Onay sırasında bir çalışma alanı seçin

Claude Code

Codex

Cursor

Krea’yı MCP Üzerinden Kullanma

Araçlar

Bir işi iptal etme

Medya girdileri sağlama

`get_upload_url` ile yerel bir dosya yükleme

MCP Apps UI bileşeni

Sorun Giderme

Sonraki Adımlar