FLORA

Tüm dokümantasyon dizini için bkz. llms.txt. Dokümantasyon sayfalarının Markdown sürümleri, sayfa URL'lerine .md eklenerek elde edilebilir; bu sayfa Markdown olarak da mevcuttur.

FLORA MCP dokümantasyonu

FLORA'yı Claude, Claude Code, ChatGPT, Codex, Cursor veya herhangi bir MCP istemcisine bağlayın; böylece aracınız Teknikler üretebilir, çalıştırabilir ve FLORA tuvaleriniz üzerinde işlem yapabilir.

FLORA MCP, FLORA'nın barındırılan MCP sunucusudur. Bir kez bağlayın; yapay zeka aracınız görsel, video, ses, metin ve 3D üretebilir, ekibinizin Tekniklerini çalıştırabilir ve sonuçları FLORA tuvalerinize yerleştirebilir. Bu dokümanlar kurulumu, her aracın işlevini ve aracınızın uyması gereken kuralları kapsar.

Ayar	Değer
Sunucu URL'si	https://agents.flora.ai/mcp (sonda eğik çizgi yok)
Taşıma	Streamable HTTP. Uzak bir sunucudur, bu yüzden kurulacak bir şey yoktur.
Oturum açma	FLORA hesabınızla OAuth. Başsız istemciler, Authorization: Bearer <key> olarak bir FLORA API anahtarı gönderebilir.
Sunucu adı	flora
Çalıştığını kontrol edin	Aracınıza sorun: "FLORA çalışma alanlarımı listele. Hiçbir şey üretme."

• Kimler bağlanabilir: API ve MCP, Starter paketinden itibaren dahildir. Ücretsiz bir hesap da bağlanabilir ve her yeni çalışma alanının aldığı $2.50 kullanım hakkıyla üretim yapabilir. Her üretim, seçtiğiniz çalışma alanına ABD doları olarak faturalandırılır. Bkz. FLORA fiyatlandırması nasıl çalışır ve Kimlik doğrulama.
• Beceriler: test edilmiş iş akışları (toplu üretim, iyileştirme döngüleri, Teknik çalıştırmaları ve daha fazlası) github.com/florafauna-ai/flora-mcp-skills adresindedir. Aracınız bunları flora_discover_skills ile listeler. Bkz. Beceriler ve eklentiler.
• Aracılar için: buradaki her sayfa aynı zamanda Markdown'dır. Herhangi bir URL'ye .md ekleyin, örneğin https://docs.flora.ai/mcp.md. Tam dizin https://docs.flora.ai/llms.txt adresindedir.

İstemcinize kurun

Claude	Web ve Masaüstü. Özel bir bağlayıcı ekleyin.	Claude
Claude Code	Tek komut veya becerilerle eklenti.	Claude Code
ChatGPT	FLORA, ChatGPT'de listelenmiştir. Bağlan'a tıklayın.	ChatGPT
Codex	Tek komut veya config.toml.	Codex
Cursor	Tek tıkla kurulum veya mcp.json.	Cursor
VS Code	Tek komut veya .mcp.json.	VS Code
Diğer istemciler	Windsurf, Gemini CLI, Copilot Studio, Hermes, OpenClaw ve herhangi bir MCP istemcisi.	Diğer istemciler

FLORA MCP'de yeni misiniz? Hızlı başlangıç sizi bağlantı kurmaktan tuvaldeki ilk görselinize kadar götürür.

Buradan başlayın: sekiz araç

Bağlantınızda bu araçlardan daha fazlası vardır (liste hesabınıza, planınıza ve istemcinize bağlıdır; flora_list_tools sahip olduklarınızı döndürür). Çoğu iş bu sekiz araçla başlar.

Araç	Ne yapar
flora_list_workspaces	Kullanabileceğiniz çalışma alanlarını ve hangisinde olduğunuzu listeler. Salt okunur.
flora_list_projects	Bir çalışma alanındaki projeleri (tuvalleri) listeler. Salt okunur.
flora_list_models	Modelleri model_id, tahmini maliyet ve parametreleriyle listeler. Salt okunur.
flora_create_generations	Bir tuvalde 1 ila 20 üretim başlatır veya quote: true ile maliyetlerini fiyatlandırır. Para harcar.
flora_list_generations	run_id ile 20'ye kadar çalıştırmayı okur veya geçmişi listeler. Salt okunur.
flora_create_asset	Kendi dosyalarınızı bir URL veya yükleme bağlantısından FLORA'ya getirir.
flora_run_technique	Ekibinizin Tekniklerinden birini çalıştırır. Para harcar.
flora_get_usage	Bir çalışma alanı veya kuruluş için bakiyeyi ve harcamayı ABD doları olarak okur. Salt okunur.

Argümanlar ve örneklerle tam liste araç referansında bulunur.

Aracınızın yapabilecekleri

İş	Tarif
Bir istemden veya referanslardan görsel, video, ses klibi veya 3D model yapın	Görsel veya video üretin
Bir ürün fotoğrafını canlandırın	Ürün fotoğrafını videoya dönüştürün
Bir listeden veya sayfadan 20 ila 500 varlık yapın	20 ila 500 varlığı toplu üretin
Ekibinizin oluşturduğu bir Tekniği çalıştırın	Ekibinizin Tekniğini çalıştırın
Kendi görsellerinizi, videolarınızı, seslerinizi veya PDF'lerinizi kullanın	Kendi görsellerinizi, videolarınızı ve dosyalarınızı yükleyin
Sonuçları bir tuval üzerine yerleştirin	Sonuçları bir tuval üzerine yerleştirin
Beğendiklerinize benzer daha fazlasını yapın	Favoriler üzerinde yineleyin
İstemlerinizden daha iyi sonuçlar alın	Daha iyi çıktı için aracınıza özet verin

Tüm tarifler Tarifler bölümünde dizinlenmiştir.

Yaygın işler için araç dizileri

İş	Sırayla çağrılar
İlk görsel	flora_list_workspaces → flora_list_projects (veya flora_create_project) → flora_create_generations ile quote: true → onay → flora_create_generations → flora_list_generations
Fotoğraf URL'sinden video	flora_list_workspaces → flora_list_projects → flora_list_models video model_id ile (görsel alan adını okumak için) → fiyat teklifi → flora_create_generations URL ile params içinde → flora_list_generations
Maliyet ve bakiye	flora_list_models (estimated_cost_usd) veya bir quote: true çağrısı → flora_get_usage
Bir Tekniği çalıştırın	flora_list_techniques → flora_get_technique → flora_run_technique → flora_list_generations ile run_ids ve technique_id
Yerel bir dosya kullanın	flora_create_asset ile source: "signed-url" → yükleme (kabuk) veya upload_page bağlantısı (sohbet) → flora_complete_asset
Tuval üzerinde ızgara	flora_get_canvas → flora_arrange_canvas ile node_ids ve layout, veya yalnızca all: true
Bir tuval görselini canlandırın	flora_add_to_canvas (görsele bağlı video düğümü) → flora_run_canvas_nodes → flora_list_generations

Aracınızın uyduğu kurallar

Sunucu, aracılara bu kuralları verir. Bunlar, ne bekleyeceğinizi bilmeniz ve aracınızı bunlara bağlı tutabilmeniz için buradadır.

• Hangi çalışma alanına fatura kesileceğini sorun. Bir bağlantı tek bir çalışma alanına bağlı değildir. flora_list_workspaces birden fazla sonuç döndürürse ve hiçbiri geçerli değilse, aracı bunları adlandırır ve hangisine fatura kesileceğini sorar. Proje araçları, projenin kendi çalışma alanına fatura keser.
• Önce ABD doları cinsinden fiyat teklifi verin. Aracı, flora_create_generations işlevini quote: true ile çağırır, size maliyeti ABD doları cinsinden gösterir (asla kredi olarak değil) ve yalnızca siz onayladıktan sonra aynı isteği quote olmadan çalıştırır. run_cost ve charged_cost dolardır: 0.009, 0,009 ABD doları anlamına gelir. Başarısız bir çalıştırma ücretlendirilmez; yeniden deneme yeni bir çalıştırmadır ve tekrar faturalandırılır. Ayrıntılar: Maliyet, bakiye ve limitler.
• Faturalama hatalarında durun. insufficient_credits veya herhangi bir BILLING_* hatasında aracı durur ve mesajı iletir. Yeniden denemez. paid_plan_required, çalışma alanının planının istenen şeyi içermediği anlamına gelir. Bakiye ve harcama flora_get_usage kaynağından gelir.
• Yavaşça, tek çağrıda yoklayın. Aracı her run_id kaydeder, yoklamalar arasında max(15, 2 × number of runs) saniye bekler (7 çalıştırmaya kadar 15 saniye, 20 çalıştırma için 40 saniye) ve hepsini tek bir flora_list_generations çağrısında okur (20 run_ids'e kadar, ayrıca Technique çalıştırmaları için technique_id). Daha hızlı yoklama, 429 veya retry_after_seconds ile birlikte soğuma hataları döndürür. Ayrıntılar: Çalıştırmalar.
• Kısmi bir grubu asla yeniden tetiklemeyin. Başlatılan öğeler zaten maliyetlidir ve zaman aşımına uğramış bir çağrı yine de bir çalıştırma başlatmış olabilir. Aracı, tekrar denemeden önce geçmişi okur. Bkz. Çalıştırmalar.
• canvas_url ile bağlantı kurun. Aracı, her üretimin döndürdüğü canvas_url ile sonuçları açar ve kimliklerden asla proje bağlantıları oluşturmaz.

FLORA MCP, fal, Replicate veya bir model sağlayıcısının API'si mi?

Model API'leri ve fal ile Replicate gibi toplayıcılar, bir modelin ham çıktısını kodunuza döndürür. FLORA MCP, bir aracıyla yaratıcı çalışma için tasarlanmıştır:

• Sonuçlar bir tuval üzerine düşer. Her üretim, ekibinizin açabileceği, karşılaştırabileceği, düzenleyebileceği ve üzerine inşa edebileceği bir FLORA projesinde bir düğüm haline gelir; sohbet günlüğündeki bir dosya URL'si değil.
• Ekibinizin iş akışları da gelir. Aracınız, ekibinizin kaydettiği Technique'leri çalıştırabilir ve FLORA'nın becerilerini kullanabilir.
• Ekip faturalaması ve kontrolleri. Çalışma alanları, üyeler, roller, çalışma alanı başına harcama limitleri ve kullanım raporlaması aracı çalıştırmaları için de geçerlidir. Fiyatlar, uygulamadakiyle aynı olan Model Fiyatlandırması sayfasındaki FLORA'nın yayınlanmış üretim başına oranlarıdır.
• Tek bağlantı, birçok model ailesi. Tek bir oturum açma arkasında birden fazla sağlayıcıdan görüntü, video, ses, metin ve 3D modeller.

Yalnızca kendi uygulamanızın içinde, tuval veya ekip çalışma alanı olmadan tek bir modelin çıktısına ihtiyacınız varsa, bir sağlayıcının API'si veya bir toplayıcı daha uygun olabilir. FLORA'yı kendi kodunuzdan çağırmak için FLORA API kullanın.

Terimler

Terim	Anlam
Çalışma Alanı	Projelerin yaşadığı ve kullanımın faturalandırıldığı yer. Birden fazlasına ait olabilirsiniz. Kimlikler ws_123 gibi görünür.
Proje	Bir FLORA tuvali ve içeriği. Kimlikler prj_abc gibi görünür.
Tuval	Düğümlerin bulunduğu ve bağlandığı proje içindeki pano.
Düğüm	Tuval üzerindeki bir blok: bir görüntü, video, metin, Technique veya başka bir adım. Üretimler düğüm olarak yerleşir.
Çalıştırma	run_id ile izlenen bir üretim veya Technique yürütmesi.
Technique	Ekibinizin FLORA'da oluşturduğu, kaydedilmiş, yeniden kullanılabilir bir iş akışı. Bkz. Technique'ler.
Varlık	FLORA'da yüklenen veya oluşturulan, asset_id içeren bir dosya.
Beceri	Bir aracının daha büyük bir iş için izlediği, flora_discover_skills tarafından listelenen yazılı talimatlar.

Bu belgelerdeki her şey

• Hızlı başlangıç: bağlanın, kontrol edin ve ilk görüntünüzü oluşturun.
• Kurulum: her istemci için adımlar.
• Kimlik doğrulama: OAuth, API anahtarları, çalışma alanları ve bağlantıyı kesme.
• Maliyet, bakiye ve limitler: fiyat teklifleri, bakiye ve faturalama hataları.
• Çalıştırmalar: yoklama, zaman aşımları ve hatalar.
• Tarifler: adım adım işler.
• Araç referansı: her araç ve bağımsız değişkenleri.
• Beceriler ve eklentiler: test edilmiş iş akışları ve bunların nasıl kurulacağı.
• Sorun giderme: belirtiler, nedenler ve çözümler.
• Güvenlik ve veri: FLORA'dan ne çıkar ve aracınız neler yapabilir.
• Değişiklik günlüğü: ne değişti ve ne zaman.
• Kullanımdan kaldırılan araçlar: eski araç adları ve bunların yerini alanlar.
• FLORA API: bir API anahtarıyla FLORA'yı kendi kodunuzdan çağırın.

İzleyin: FLORA MCP Hakkında Her Şey

{% embed url="https://www.youtube.com/watch?v=74R3pWxmiqc" %} FLORA ekibinden FLORA MCP'ye bir giriş. {% endembed %}

Yardıma mı ihtiyacınız var? support@florafauna.ai adresine e-posta gönderin.

---

Aracı Talimatları

Bu dokümantasyon GitBook ile yayınlanmaktadır. GitBook, hem insanların hem de yapay zeka aracılarının teknik içeriği etkili bir şekilde okuyabilmesi, gezinebilmesi ve üzerinde akıl yürütebilmesi için tasarlanmış dokümantasyon platformudur. gitbook.com adresinden daha fazla bilgi edinin.

Bu Dokümantasyonu Sorgulama

Bu sayfada doğrudan bulunmayan ek bilgilere ihtiyacınız varsa, bir soru sorarak dokümantasyonu sorgulayabilirsiniz.

Aşağıdaki URL'ye ask ve goal sorgu parametreleriyle bir HTTP GET isteği gerçekleştirin:

GET https://docs.flora.ai/mcp.md?ask=<question>&goal=<user_goal>

ask acil sorudur: belirli, kendi kendine yeten ve doğal dilde yazılmış olmalıdır. goal, kullanıcının nihai olarak ulaşmaya çalıştığı şeydir, cevaba ihtiyaç duyma nedenidir. Bunu paylaşmak, GitBook'un size daha iyi ve daha alakalı bir cevap vermesine yardımcı olur. Bir hedef, kullanıcının istediği sonucu tanımladığında, soruyu yeniden ifade etmekten daha yararlıdır. Örneğin, ask=how do I create an API token ile automate deployments from our CI pipeline gibi bir hedef, GitBook'un cevabı bu kullanım durumuna göre uyarlamasını sağlar.

Yanıt, soruya doğrudan bir cevap ve dokümantasyondan ilgili alıntılar ve kaynaklar içerecektir.

Cevap mevcut sayfada açıkça bulunmadığında, açıklamaya veya ek bağlama ihtiyaç duyduğunuzda veya ilgili dokümantasyon bölümlerini almak istediğinizde bu mekanizmayı kullanın.