Ana içeriğe atla
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ı

AyarDeğer
AktarımStreamable HTTP
URLhttps://api.krea.ai/mcp
Kimlik DoğrulamaOAuth
Faturalandırma, nasıl kimlik doğruladığınıza bağlıdır:
Kimlik doğrulama yöntemiFaturalandırma kaynağı
OAuthOnay 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
AuthorizationBearer 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

  1. Codex’te Settings > MCP servers bölümünü açın.
  2. Yeni bir sunucu ekleyin.
  3. Aktarım olarak Streamable HTTP seçin.
  4. Sunucu URL’sini yapıştırın:
https://api.krea.ai/mcp
  1. 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_modelsKullanılabilir görsel ve video modellerini listeler.
get_model_schemaÜretim yapmadan önce bir modelin girdi şemasını inceler.
generateBir görsel veya video üretim işi gönderir.
execute_node_appBir node uygulamasını çalıştırır.
get_jobBir işin güncel durumunu ve çıktısını jobId ile getirir.
cancel_jobDevam eden bir işi iptal eder ve iş listenizden siler.
get_upload_urlModel 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ızMCP 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 reddedildiOAuth 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ızYeniden 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.