> ## 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 > Krea'yı MCP uyumlu ajanlara bağlayarak modelleri keşfetmelerini, şemaları incelemelerini ve çalışma alanınızdan görsel veya video üretmelerini sağlayın. 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](https://www.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](/developers/api-keys-and-billing) 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: ```bash theme={null} 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: ```text theme={null} https://api.krea.ai/mcp ``` 5. 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: ```json theme={null} { "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: ```text theme={null} 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](/developers/deprecations) 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ü](/developers/job-lifecycle) sayfasına bakın (iptal edilen işler faturalandırılmaz). Örnek istem: ```text theme={null} 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ış: ```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. ``` 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](https://modelcontextprotocol.io/) 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](https://www.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 Token ile kimlik doğrulanan istekler için API tokenları oluşturun ve API bakiyesini yönetin. Bir ajandan çalıştırmasını istemeden önce istekleri Krea uygulamasında deneyin. MCP'nin model geçiş meta verilerini nasıl sunduğunu görün. Uç nokta şemalarına ve model parametrelerine göz atın.