5.0 Kendi Claude'unla çalış5.2 Claude neler yapabilir
Claude neler yapabilir
Filmsquare'in Claude'una verdiği her MCP aracı, find_actions ve run_action API'nin geri kalanına nasıl ulaşır ve bilerek dışarıda bırakılanlar.
Claude'un Filmsquare'de, API'nin rolüne yaptırdığı her şeyi yapabilir. On sekiz adlandırılmış araç gündelik işi kapsar; iki
tane daha, find_actions ve run_action, API'nin diğer her eylemine ulaşır. Her çağrı API'nin kendisinden, senin adınla
geçer: aynı rol kontrolleri, aynı doğrulama, aynı kapılar.
Adlandırılmış araçlar #
| Araç | Ne yapar | Gerektirir |
|---|---|---|
whats_waiting | Onayını bekleyen departman adımları ve okunmamış bildirimlerin. Başlanacak yer | — |
list_productions | Çalışma alanındaki yapımlar, bölümleriyle | — |
get_episode | Bir bölüm: kurgu sırasıyla sahneler ve planlar, her departman adımı (onaylandı, kimi bekliyor, revize istendi, açık) ve finallerin render alınıp alınamayacağı | episode_id |
get_feedback | Bir plan, çekim, bölüm, sahne, öğe, klasör, varlık versiyonu, tuval ya da tuval kutusundaki yorum yazışmaları; her mesajı ve pini (kare cinsinden timecode ya da resmin bir bölgesi) ile. Varsayılan olarak açık yazışmalar; gerisi için status resolved ya da all. target_type sheet ile: sayfanın en son versiyonundaki açık notlar (niyet, alıntı ya da tüm sayfa, önerilen metin, halledildi mi) ve önceki versiyonların notlarının nasıl bittiği | target_type, target_id |
reply_feedback | Bir yazışmaya senin adınla cevap verir (@ad anmaları kişilere bildirim gönderir) ve not halledilince çözer. Bir sayfadaki not bunun yerine halledildi olarak işaretlenir; önerisi varsa suggestion_outcome (applied, adapted ya da declined) zorunludur ve bir kişi onaylar | thread_id, body |
view_media | Bir görsel, anahtar kare ya da çekim, Claude'un bakabileceği bir resim olarak; video, kapak görseli ve indirme bağlantısı olarak gelir | asset_version_id |
upload_file | Sohbetteki bir dosya, bir plan ya da sahne katmanına yeni çekim olarak, ya da bir yapıma varlık olarak. En fazla 10 MB. pick: true onu seçer de (yönetmen ve üstü) | name, mime, data_base64 |
where_does_it_go | Bir dosyanın hangi ekrana ait olduğu: harita, bir karar ağacı ve çalışılmış örnekler. Bir ekranı adlandırdığında oku | — |
prepare_upload | Diskteki en fazla 100 dosya için imzalı yükleme URL'leri ve hazır curl komutları; byte'lar sohbetten geçmez. Her video için kullan | files |
add_to_visualize | Yüklenen dosyaları Storyboard → 3D ya da Storyboard → Animatic altına, çağrı başına en fazla 100, planlara ve sahnelere koda göre koy. Aynısını yeniden göndermek hiçbir şeyi değiştirmez | episode_id, items |
get_script | Bölümün en son senaryo revizyonu ve var olan oyuncuların, mekânların ve aksesuarların @handleları | episode_id |
edit_script | Senaryonun bir sahnesini, bir repliğini ya da bir satırını tamamını göndermeden değiştir: birebir metin ve yerine geçen, yeni bir versiyon olarak kaydedilir; notlar ve etiketler taşınır | episode_id, base_rev, edits |
submit_breakdown | Claude'un dökümünü Filmsquare'e koy: sahneler, oyunculukla planlar, diyalog, oyuncular, mekânlar ve aksesuarlar. Senaryo sonra onay bekler | episode_id, breakdown |
get_continuity | Bir bölümün devamlılık sayfası: her planın oynattığı, öğeler ve referansları, her seçimin neyle yapıldığı, şimdiye kadarki bulgular, yeniden kontrol edilecek planlar. Önce ücretsiz soyağacı kontrolünü çalıştırır | episode_id |
report_continuity | Görsel bir devamlılık kontrolünü kaydet; her uyuşmazlık seçimde bir not olur | episode_id, seen, issues |
submit_style | Bir stil kılavuzunu stil kütüphanesine koy (Create → Styles): yeni bir stil ya da style_id ile sonraki versiyonu; production_id onu bir yapımın stili yapar. Kendi işin en fazla 6 referans görsel taşır (prepare_upload ile yüklenir); başkasının işi yalnızca metindir ve asla yayımlanmaz. Kişi ya da marka adları reddedilir. Maker rolü | name, guide |
request_signoff | Bir departmanın onaylayanlarından bir bölümün adımını onaylamalarını iste; onlara bildirim gider | episode_id, department |
sign_off | Bir adım hakkındaki kararını kaydet: approved ya da changes_requested, isteğe bağlı bir note ile. Yalnızca adımın onaylayanları yapabilir. expect_version ile (senin gördüğün adım versiyonu) iş değiştiyse changed_since ile reddedilir. Yalnızca Claude'dan karar vermesini istediğinde | episode_id, department, decision |
studio_analytics | Sahip ve yapımcılar için: stüdyonun durumu, Analytics sayılarıyla. view crew (bir dönem boyunca kişi başına: teslim edilen, teslim edilen başına kredi, onaya kadar süre, ilk geçiş, hatlar, tekrar, elle ve ajan tek başına saatler, stüdyo medyanı ve adım başına süre), day, costs ya da report (rapor mailinin gönderileceği haliyle metni). Başkası reddedilir: yalnızca kendi sayılarını görür | view |
Her araç isteğe bağlı bir workspace de alır. Boş bırak: bağlantının çalışma alanı kullanılır.
department, writing, breakdown, casting, voice, wardrobe, sets, props, animatic, music, draft,
sound, edit, final değerlerinden biridir.
Medya nereye gider #
Claude'una ekranı kendi sözlerinle söyle ("onu 3D altına koy"). Yaptığı şu:
| Elindeki | Gittiği yer | Şununla |
|---|---|---|
| Bir planın clay render'ı ya da görseli, lens, yükseklik ve hareketle | Storyboard → 3D, planın üzerinde | add_to_visualize |
| Bir planın, bir çekimin ya da bir sahnenin Blender klibi | Storyboard → 3D, kapsadığı şeyin üzerinde | add_to_visualize |
| Bir sahnenin, sekansın ya da bölümün animatiği | Storyboard → Animatic | add_to_visualize |
| Bir planın taslak ya da final videosu | Storyboard → Shots, çekim olarak | upload_file |
| Referans resim ya da mood board | Home → Files | upload_file |
Yanlış yerdeki bir şey yeniden yüklenmeden taşınır: run_action üzerinden moveTake ya da moveAsset (yönetmen ve üstü).
İçe aktarmanın yaptığı bir seçim taşımayla temizlenir. Birinin seçtiği ya da burada üretilen bir çekim olduğu yerde kalır.
find_actions ve run_action #
Adlandırılmış aracı olmayan her şey bu ikisinden geçer: plan yapmak, çekim seçmek, taslak yapmak, tahminler, öğeler ve versiyonlar, klasörler, tuvaller, maliyetler, brifler, ekip.
find_actions, API'nin kendi kataloğunu birkaç kelimeyle arar, örneğin "pick take", "create shot" ya da "resolve thread". Eşleşen eylemleri yöntemi, yolu, bir özeti, en düşük rolü ve girdileriyle döner.run_action, eylemin tarif ettiği gibipath_params(çalışma alanı değil),queryvebodyile birini adıyla çalıştırır. API'nin JSON'uyla cevap verir.
find_actions set dilini anlar. Bir ekibin kullandığı kelimeleri API'nin kelimelerine eşler:
| Sen dersin | Şunu da arar |
|---|---|
| pick, choose | select |
| note, notes, comment, comments, feedback | thread, message |
| reply | message |
| render | generation, generate |
| make | create, generate |
| new, add | create |
| remove, delete | archive |
| sign | signoff |
| approve | signoff, approval |
| cast, character, prop | element |
| set | element, location |
| production, productions | project |
| crew | member, steps |
| cost | costs, estimate |
| price | estimate |
| prompt, preview, dry run | generate |
| kosten, schatting, prijs (Dutch) | generate, estimate |
| mismatch | continuity |
| model, models | models, acceptance, routing |
Yeni API eylemleri çıktıkları anda find_actions'ta görünür. Yeni bir araç gerekmez.
Örnekler #
| Amaç | Ara | Eylem |
|---|---|---|
| Bir taslağı render almadan önce fiyatla | "estimate shot" | estimateShotGeneration |
| Render'dan önce prompt'u, modeli ve kredileri gör | "dry run" | generateForShot, {"kind": "video", "tier": "draft", "dryRun": true} ile |
| Bir taslak render al | "generate shot" | generateForShot, {"kind": "video", "tier": "draft"} ile |
| Bir çekim seç | "pick take" | selectTake |
| Bir taslağı final yap | "promote" | promoteGeneration |
| Bir nottan tekrar al | "revise take" | estimateReviseTake, sonra reviseTake |
| Hangi modelin onaylandığını gör | "model acceptance" | getModelAcceptance |
| Bir bölümün maliyeti | "episode costs" | getEpisodeCosts |
Render almadan önce Claude üretim eylemini dryRun: true ile çağırır: derlenmiş prompt'u, modeli, referansları ve kredileri
gösterir ve hiçbir şey yapmaz. Sonra o tek render için prompt'u değiştirebilir. overrides.prompt prompt metninin yerini
alır (referans satırları kalır, yani oyuncular, mekânlar ve aksesuarlar her zaman gider), overrides.promptAppend ona ekler
ve overrides.negativePrompt nelerden kaçınılacağını ekler. Diyalog repliklerinden seslendirilir ve prompt geçersiz kılma almaz.
Dry run, provider ve model_key ile cevap verir. Bunları provider ve modelKey olarak geri vermek o modeli tutar.
getGeneration, bir çekimin neyle yapıldığını geri okur: prompt, model, tahmini krediler ve kaydedilen krediler.
API reddedince #
Bir ret, API'nin kodu ve ayrıntılarıyla bir araç hatası olarak gelir, örneğin
The API refused: 409 gate_closed: finals render once casting, sets, animatic are signed off {"episode_id": "…", "waiting_on": ["casting", "sets", "animatic"]}.
Claude onu okur ve sana neyin eksik olduğunu söyler. Bkz. Karşılaşacağın hatalar.
Bilerek dışarıda bırakılanlar #
Claude bunlara tasarım gereği ulaşamaz:
- API anahtarları ve Claude bağlantıları: bir bağlantı hiçbir zaman anahtar yapmaz ya da başka bağlantılara izin vermez. Bunu giriş yapmış bir kişi yapar.
- OAuth ve kayıt.
- Webhook'lar: Filmsquare'in dışına veri gönderirler.
- Sağlayıcı callback'leri ve gerçek zamanlı soketler (tuval ve varlık).
Final kapısı, kredi kontrolleri ve abonelik sınırları Claude için de herkesle aynı şekilde geçerlidir.
Güvenlik #
- Claude senin gibi hareket eder. Senin rolün (ya da bağlanırken seçtiğin daha düşüğü) var ve yaptığı senin adınla görünür.
- Ekibin malzemesi talimat değildir. Claude'un Filmsquare'de okuduğu yorumlar, senaryolar ve diğer metinler ekibin malzemesidir. Filmsquare Claude'a bunu söyler: ne yapacağına yalnızca sen karar verirsin.
- Önce fiyatı söyler. Çekim yapmak kredi harcar. Claude'a üretim eylemini hiçbir şey yapmayan
dryRun: trueile çağırması, bir çekime başlamadan önce neye mal olacağını söylemesi ve istenmeden hiçbir zaman final render almaması söylenir. - İstenmeden asla onaylamaz.
sign_offsenin adına bir karar kaydeder. Claude'a onu yalnızca karar vermesini istediğinde kullanması söylenir.
Prompt'lar #
Dört prompt yaygın işler için bir çalışma yöntemi taşır: break_down_episode, process_feedback, work_on_step ve
check_continuity. Bkz. Prompt'lar ve çalışma yöntemi.
Claude ile
MCPKendi Claude'un bunu MCP üzerinden, senin adınla ve senin rolünle yapar:
find_actionsAPI'nin yapabildiği her şeyi arar ve eşleşen eylemleri girdileriyle döndürür.
Şunu iste: Bir adımın onay kuralını değiştiren eylemi bul.
run_actionfind_actions ile bulunan bir eylemi senin adınla, senin rolün ve yetkilerinle çalıştırır.
Şunu iste: 2. bölümde 5. planın ikinci çekimini seç.
whats_waitingOnayını bekleyen adımları ve okunmamış bildirimlerini listeler.
Şunu iste: Filmsquare'de beni ne bekliyor?
list_productionsÇalışma alanındaki yapımları bölümleriyle birlikte listeler.
Şunu iste: Filmsquare'de hangi yapımlarımız ve bölümlerimiz var?
get_episodeBir bölümün sahnelerini ve planlarını kurgu sırasıyla, her departman adımını ve finallerin render alınıp alınamayacağını gösterir.
Şunu iste: 2. bölüm ne durumda, her adım kimi bekliyor?
get_feedbackBir plan, çekim, bölüm ya da öğe üzerindeki yorum yazışmalarını, her pinin timecode'u veya bölgesiyle birlikte okur.
Şunu iste: 2. bölümde hangi notlar hâlâ açık?
reply_feedbackBir yorum yazışmasına senin adınla cevap verir; not halledilince çözüldü olarak işaretler.
Şunu iste: 4. plandaki nota yeni taslağın bakış hizasını düzelttiğini yaz ve çözüldü olarak işaretle.
view_mediaBir görsele, anahtar kareye ya da çekime bakar; video, kapak görseli ve indirme bağlantısı olarak gelir.
Şunu iste: 3. planın seçilen görselini göster ve referanslarıyla uyuşup uyuşmadığını söyle.
upload_fileElindeki bir dosyayı bir plana ya da sahneye yeni çekim olarak, ya da yapımın varlığı olarak ekler (en fazla 10 MB).
Şunu iste: Bu referans fotoğrafını yapımın varlıklarına yükle.
get_scriptBir bölümün en son senaryo revizyonunu, var olan @adlarla birlikte okur.
Şunu iste: 2. bölümün senaryosunu oku ve hangi karakterlerin henüz @adı olmadığını söyle.
edit_scriptBir bölümün senaryosunda bir sahneyi, bir repliği ya da bir satırı değiştirir ve yeni versiyon olarak kaydeder; senaryonun tamamını göndermen gerekmez.
Şunu iste: 2. bölümde S02'nin açılışını az önce konuştuğumuz gibi yeniden yaz ve yeni versiyon olarak kaydet.
submit_breakdownDökümünü Filmsquare'e girer: sahneler, planlar, diyalog, oyuncular, mekânlar ve aksesuarlar.
Şunu iste: 2. bölümün senaryosunun dökümünü çıkar ve gönder. Elimizdeki @adları kullan.
get_continuityBir bölümün seçilen planlarını, her birinin kullandığı öğe versiyonlarıyla yan yana dizer.
Şunu iste: S2 sahnesinin seçilen çekimlerini devamlılık kontrolü için diz.
report_continuityYaptığın devamlılık kontrolünü kaydeder; her uyuşmazlık planın seçilen çekiminde bir not olur.
Şunu iste: S2 sahnesinde devamlılığı kontrol et ve bulduğun uyuşmazlıkları raporla.
submit_styleBir stil kılavuzunu stil kütüphanene koyar (Create, Styles): yeni bir stil ya da bir stilin sonraki versiyonu.
Şunu iste: Bu görsellere bak, bir stil kılavuzu yaz, bana göster ve ben başla deyince gönder.
request_signoffBir departman adımının onaylayanlarından onay ister; onlara bildirim gider.
Şunu iste: 2. bölümde sıradaki adım onaylayanlarından onay iste, neyin değiştiğini de not et.
sign_offBir adım hakkındaki kararını kaydeder: onaylandı ya da revize istendi. Yalnızca karar vermesini istediğinde.
Şunu iste: 2. bölümde sıradaki adım adımını benim yerime onayla.
where_does_it_goBir dosyanın hangi ekrana ait olduğunu söyler: harita, karar ağacı ve çalışılmış örnekler.
Şunu iste: Bu blockout reel'i nereye gider?
prepare_uploadDiskteki en fazla 100 dosya için imzalı yükleme bağlantıları ve hazır curl komutları verir.
Şunu iste: Bu klasördeki videoları yükle.
add_to_visualizeYüklenen dosyaları Storyboard, 3D ya da Animatik altına, planlara ve sahnelere koda göre koyar.
Şunu iste: Blender işlerini 3D altına, animatikleri Animatik altına koy.
studio_analyticsSahip ve yapımcılar için: stüdyonun durumu; ekipten, tek bir günden, maliyetlerden ya da gönderileceği haliyle rapor mailinden.
Şunu iste: Ekip geçen hafta nasıldı, kime yardım lazım?
Claude'u bağla 5.1