5.0 お手持ちのClaudeで作業する5.2 Claudeでできること
Claudeでできること
Filmsquareがお手持ちのClaudeに渡すすべてのMCPツールと、find_actionsとrun_actionでAPIの残りに届く方法、そして意図的に外してあるものを説明します。
お手持ちのClaudeは、ご本人の役割でAPIに許されていることを、Filmsquareで行えます。名前つきの18のツールが、日々の作業をカバーします。そのほかに、find_actionsとrun_actionの2つで、APIのそれ以外のすべてのアクションに届きます。呼び出しはすべて、ご本人として、API自体を通ります。役割の確認、検証、関門は、同じです。
名前つきのツール #
| ツール | できること | 必要なもの |
|---|---|---|
whats_waiting | 自分のOK待ちの部署の工程と、未読の通知。ここから始めます | — |
list_productions | ワークスペースの作品と、そのエピソード | — |
get_episode | 1つのエピソード。シーンとカットを編集順に、各部署の工程(OK済み、誰の待ちか、修正依頼あり、未着手)、本番をレンダリングできるかどうか | episode_id |
get_feedback | カット、テイク、エピソード、シーン、アセット、フォルダ、ファイルのバージョン、キャンバス、キャンバスのボックスへのコメントスレッド。すべてのメッセージとそのピン(フレーム単位のタイムコード、または画像上の範囲)つき。標準では未対応のスレッドで、statusにresolvedまたはallを指定すると残りも見られる。target_typeがsheetの場合は、シートの最新バージョンの未対応のコメント(意図、引用またはシート全体、提案する文案、対応済みかどうか)と、以前のバージョンのコメントの結末 | target_type、target_id |
reply_feedback | ご本人としてスレッドに返信し(@名前のメンションは通知される)、対応が済んだらスレッドを対応済みにする。シートへのコメントは、代わりに対応済み(handled)の印を付ける。提案があるときは、suggestion_outcome(反映した、調整した、見送った)が必須で、確認するのは人 | thread_id、body |
view_media | スチル、キーフレーム、テイクを、Claudeが見られる画像として返す。動画は、ポスター画像とダウンロードリンクで返る | asset_version_id |
upload_file | 会話のファイルを、カットまたはシーンのレイヤーの新しいテイクとして、または作品のアセットとして追加する。10 MBまで。pick: trueなら採用までする(監督以上) | name、mime、data_base64 |
where_does_it_go | ファイルをどの画面に置くか。対応表、判断の流れ、具体例。画面の名前を挙げたときに読む | — |
prepare_upload | ディスク上の最大100ファイル分の署名付きアップロードURLと、そのまま使えるcurlコマンド。ファイルの中身が会話を通らない。動画はすべてこれを使う | files |
add_to_visualize | アップロードしたファイルを、Storyboard → 3DまたはStoryboard → Animaticに、カットとシーンにコードで紐づけて置く。1回に100件まで。同じ内容をもう一度送っても何も変わらない | episode_id、items |
get_script | エピソードの最新の脚本の稿と、すでにあるキャスト、セット、小道具の@handles | episode_id |
edit_script | 脚本全体を送らずに、シーン、セリフ、1行を変更する。正確なテキストと置き換え内容を指定し、新しいバージョンとして保存される。コメントとタグも引き継がれる | episode_id、base_rev、edits |
submit_breakdown | Claudeのカット割りをFilmsquareに登録する。シーン、演技つきのカット、セリフ、キャスト、セット、小道具。脚本は、そのあとOK待ちになる | episode_id、breakdown |
get_continuity | エピソードのつながりのシート。各カットが再生するもの、アセットとそのリファレンス、各採用テイクが何でつくられたか、これまでの指摘、再確認すべきカット。最初に無料の系統チェックを実行する | episode_id |
report_continuity | 見た目のつながりの確認を記録する。ずれはそれぞれ、採用テイクへのコメントになる | episode_id、seen、issues |
submit_style | スタイルガイドを、スタイルライブラリ(Create → Styles)に登録する。新しいスタイル、またはstyle_idつきならその次のバージョン。production_idを付けると、その作品のスタイルになる。ご自身の作品には、リファレンスのスチルを6枚まで添えられる(prepare_uploadでアップロード)。他人の作品はテキストだけで、公開されない。人名やブランド名は拒否される。クリエイターの役割 | name、guide |
request_signoff | 部署のOK担当に、エピソードの工程にOKを出すよう依頼する。OK担当には通知が届く | episode_id、department |
sign_off | 工程へのご本人の判断を記録する。approved(OK)かchanges_requested(修正依頼)で、任意でnoteも付けられる。OK担当だけが使える。expect_version(見ていた工程のバージョン)を付けると、作業が動いていた場合はchanged_sinceで拒否される。Claudeに判断を頼んだときだけ使う | episode_id、department、decision |
studio_analytics | オーナーとプロデューサー向け。Analyticsの数字で、スタジオの状況が分かる。viewはcrew(期間内の1人ごと:納品数、納品あたりのクレジット、OKまでの時間、一発OK、レーン、リテイク、手作業とエージェント単独の時間、スタジオの中央値、工程ごとの時間)、day、costs、report(レポートメールの送信どおりの本文)。それ以外の人は拒否され、自分の数字だけが見られる | view |
どのツールも、任意でworkspaceを受け取ります。省略すれば、接続のワークスペースが使われます。
departmentは、writing、breakdown、casting、voice、wardrobe、sets、props、animatic、music、draft、sound、edit、finalのいずれかです。
メディアの置き場所 #
置きたい画面は、ご自身の言葉でClaudeに伝えてください(「3Dに入れて」)。Claudeは次のように動きます。
| お手元にあるもの | 置き場所 | 使うもの |
|---|---|---|
| 1つのカットの、クレイレンダーまたはスチル。レンズ、高さ、カメラワークつき | カットのStoryboard → 3D | add_to_visualize |
| カット、テイク、シーンのBlenderのクリップ | 対象の範囲のStoryboard → 3D | add_to_visualize |
| シーン、シーケンス、エピソードのビデオコンテ | Storyboard → Animatic | add_to_visualize |
| カットのラフまたは本番の動画 | Storyboard → Shotsにテイクとして | upload_file |
| リファレンス画像やムードボード | Home → Files | upload_file |
置き場所を間違えたものは、アップロードし直さずに移せます。run_actionでmoveTakeまたはmoveAssetを使います(監督以上)。取り込みでできた採用は、移動と同時に解除されます。誰かが採用したテイクや、ここで生成したテイクは、そのままの場所に残ります。
find_actionsとrun_action #
名前つきのツールがないものは、すべてこの2つを通します。カットをつくる、テイクを採用する、ラフをつくる、見積もり、アセットとバージョン、フォルダ、キャンバス、費用、指示書、スタッフです。
find_actionsは、「pick take」「create shot」「resolve thread」のような、いくつかの言葉で、APIのカタログを検索します。該当するアクションが、メソッド、パス、概要、必要な最低の役割、入力項目つきで返ります。run_actionは、名前を指定して1つ実行します。path_params(ワークスペースは含まない)、query、bodyは、アクションの説明に従います。APIのJSONが返ります。
find_actionsは、現場の言葉を理解します。スタッフが使う言葉を、APIの言葉に対応づけます。
| 使う言葉 | あわせて検索される言葉 |
|---|---|
| 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 |
新しいAPIのアクションは、公開された時点でfind_actionsに出てきます。新しいツールは要りません。
例 #
| やりたいこと | 検索 | アクション |
|---|---|---|
| レンダリングの前に、ラフの金額を出す | 「estimate shot」 | estimateShotGeneration |
| レンダリングの前に、プロンプト、モデル、クレジットを見る | 「dry run」 | {"kind": "video", "tier": "draft", "dryRun": true}つきのgenerateForShot |
| ラフをレンダリングする | 「generate shot」 | {"kind": "video", "tier": "draft"}つきのgenerateForShot |
| テイクを採用する | 「pick take」 | selectTake |
| ラフを本番にする | 「promote」 | promoteGeneration |
| コメントからリテイクする | 「revise take」 | estimateReviseTake、続けてreviseTake |
| どのモデルが採用されるかを見る | 「model acceptance」 | getModelAcceptance |
| エピソードの費用 | 「episode costs」 | getEpisodeCosts |
レンダリングの前に、ClaudeはdryRun: trueで生成のアクションを呼びます。コンパイルされたプロンプト、モデル、リファレンス、クレジットが表示されるだけで、何もつくりません。そのあと、その1回のレンダリングに限って、プロンプトを変更できます。overrides.promptはプロンプトの文面を置き換えます(リファレンスの行は残るので、キャスト、セット、小道具は常に付いていきます)。overrides.promptAppendは文面に追記し、overrides.negativePromptは避けたいものを追加します。セリフは、その台詞から読み上げられるので、プロンプトの上書きはできません。
ドライランは、providerとmodel_keyを返します。それをproviderとmodelKeyとして渡すと、そのモデルに固定されます。getGenerationでは、テイクが何でつくられたかを読み返せます。プロンプト、モデル、見積もりのクレジット、計上されたクレジットです。
APIが拒否したとき #
拒否は、APIのコードと詳細つきの、ツールのエラーとして返ります。たとえば次のようにです。
The API refused: 409 gate_closed: finals render once casting, sets, animatic are signed off {"episode_id": "…", "waiting_on": ["casting", "sets", "animatic"]}
Claudeはそれを読んで、何が足りないかを伝えます。出会うエラーをご覧ください。
意図的に外してあるもの #
次のものには、設計上、Claudeは触れません。
- APIキーとClaudeの接続: 接続が、キーをつくったり、ほかの接続を許可したりすることはありません。ログインした人が行います。
- OAuthと新規登録。
- Webhook: Filmsquareの外にデータを送るためです。
- 提供元のコールバックと、リアルタイムのソケット(キャンバスとプレゼンス)。
本番の関門、クレジットの確認、プランの上限は、Claudeにも、ほかの誰とも同じように適用されます。
安全のために #
- Claudeはご本人として動く。 ご本人の役割(または接続時に選んだ、それより低い役割)で動き、その作業はご本人の名前で表示されます。
- スタッフの素材は指示ではない。 FilmsquareでClaudeが読むコメント、脚本、そのほかの文章は、スタッフの素材です。Filmsquareは、そうClaudeに伝えています。Claudeの動作を決めるのは、ご本人だけです。
- 先に金額を伝える。 テイクをつくるとクレジットがかかります。Claudeは、何もつくらない
dryRun: trueで生成のアクションを呼び、テイクを始める前に費用を伝え、頼まれていない本番はレンダリングしないよう指示されています。 - 頼まれていないOKは出さない。
sign_offは、ご本人の名前で判断を記録します。Claudeは、判断を頼まれたときだけ使うよう指示されています。
プロンプト #
4つのプロンプトが、よくある仕事の進め方を持っています。break_down_episode、process_feedback、work_on_step、check_continuityです。プロンプトと作業の進め方をご覧ください。
Claudeでできること
MCPお手持ちのClaudeが、MCPを通じてあなたの名前と役割でこの作業を行います。
find_actionsAPIでできることをすべて検索し、該当するアクションを入力項目つきで返します。
依頼例: 工程のOKのルールを変更するアクションを探して。
run_actionfind_actionsで見つけたアクションを1つ、あなたの役割と権限で実行します。
依頼例: 第2話のカット5の2番目のテイクを採用して。
whats_waitingあなたのOK待ちの工程と、未読の通知を一覧します。
依頼例: FilmsquareでOK待ちになっているものを教えて。
list_productionsワークスペースの作品とそのエピソードを一覧します。
依頼例: Filmsquareにある作品とエピソードを教えて。
get_episodeエピソードのシーンとカットを編集順に表示します。各部署の工程と、本番をレンダリングできるかどうかも分かります。
依頼例: 第2話の状況と、各工程が誰の待ちか教えて。
get_feedbackカット、テイク、エピソード、アセットのコメントスレッドを、ピンごとのタイムコードや範囲とあわせて読みます。
依頼例: 第2話でまだ対応していないコメントはどれ?
reply_feedbackあなたの名前でコメントスレッドに返信し、対応が済んだら対応済みにします。
依頼例: カット4のコメントに、新しいラフで視線が直ったと返信して、対応済みにして。
view_mediaスチル、キーフレーム、テイクを見ます。動画はポスター画像とダウンロードリンクで返ります。
依頼例: カット3の採用スチルを見せて、リファレンスと合っているか教えて。
upload_fileお手元のファイルを、カットまたはシーンの新しいテイクとして、または作品のアセットとして追加します(10 MBまで)。
依頼例: このリファレンス写真を作品のアセットにアップロードして。
get_scriptエピソードの最新の稿を、すでにある@ハンドルとあわせて読みます。
依頼例: 第2話の脚本を読んで、まだ@ハンドルのない登場人物を教えて。
edit_scriptエピソードの脚本のシーン、セリフ、1行だけを変更し、脚本全体を送らずに新しいバージョンとして保存します。
依頼例: 第2話のS02の冒頭を、さっき話した方向で書き直して、新しいバージョンとして保存して。
submit_breakdownカット割りをFilmsquareに登録します。シーン、カット、セリフ、キャスト、セット、小道具が対象です。
依頼例: 第2話の脚本をカット割りして登録して。すでにあるハンドルを使ってね。
get_continuityエピソードの採用カットを並べて、それぞれが使っているアセットのバージョンを表示します。
依頼例: シーンS2の採用テイクを並べて、つながりを確認できるようにして。
report_continuity行ったつながりの確認を記録します。食い違いはそれぞれ、カットの採用テイクへのコメントになります。
依頼例: シーンS2のつながりを確認して、見つけた食い違いを報告して。
submit_styleスタイルガイドを、スタイルライブラリ(Create、Styles)に登録します。新しいスタイル、または既存のスタイルの次のバージョンです。
依頼例: このスチルを見て、スタイルガイドを書いて、見せて。OKを出したら登録して。
request_signoff部署の工程のOK担当にOKを依頼します。OK担当には通知が届きます。
依頼例: 第2話の次の工程のOK担当に、何が変わったかを添えてOKを依頼して。
sign_off工程へのあなたの判断を記録します。OKか、修正依頼です。判断を頼んだときだけ使います。
依頼例: 第2話の次の工程に、私の代わりにOKを出して。
where_does_it_goファイルをどの画面に置くか教えます。対応表、判断の流れ、具体例つきです。
依頼例: このブロッキングのリールはどこに置けばいい?
prepare_uploadディスク上の最大100ファイル分の署名付きアップロードリンクと、そのまま使えるcurlコマンドを渡します。
依頼例: このフォルダの動画をアップロードして。
add_to_visualizeアップロードしたファイルを、カットやシーンにコードで紐づけて、絵コンテ、3D、ビデオコンテに置きます。
依頼例: Blenderの作業は3Dに、ビデオコンテはビデオコンテに入れて。
studio_analyticsオーナーとプロデューサー向け。スタッフの動き、1日の状況、費用、送信されるレポートメールのとおりの内容など、スタジオの状況が分かります。
依頼例: 先週のスタッフの動きはどうだった? 助けが必要な人はいる?
Claudeを接続 5.1