---
title: "Claude neler yapabilir"
description: "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."
url: https://www.filmsquare.ai/docs/tr/claude/tools/
lang: tr
section: claude
updated: 2026-11-15
mcp: [find_actions, run_action, whats_waiting, list_productions, get_episode, get_feedback, reply_feedback, view_media, upload_file, get_script, edit_script, submit_breakdown, get_continuity, report_continuity, submit_style, request_signoff, sign_off, where_does_it_go, prepare_upload, add_to_visualize, studio_analytics]
---

# Claude neler yapabilir

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 `@handle`ları | `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.

1. `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.
2. `run_action`, eylemin tarif ettiği gibi `path_params` (çalışma alanı değil), `query` ve `body` ile 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](https://www.filmsquare.ai/docs/tr/api/overview/#errors-you-will-meet).

## 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: true` ile ç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_off` senin 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](https://www.filmsquare.ai/docs/tr/claude/prompts/).
