Filmsquare ヘルプドキュメント

5.0 お手持ちのClaudeで作業する5.2 Claudeでできること

Claudeでできること

Filmsquareがお手持ちのClaudeに渡すすべてのMCPツールと、find_actionsとrun_actionでAPIの残りに届く方法、そして意図的に外してあるものを説明します。

更新日 2分で読めます.md

このページの内容
  1. 名前つきのツール
  2. メディアの置き場所
  3. find_actionsとrun_action
  4. 例
  5. APIが拒否したとき
  6. 意図的に外してあるもの
  7. 安全のために
  8. プロンプト

お手持ちのClaudeは、ご本人の役割でAPIに許されていることを、Filmsquareで行えます。名前つきの18のツールが、日々の作業をカバーします。そのほかに、find_actionsとrun_actionの2つで、APIのそれ以外のすべてのアクションに届きます。呼び出しはすべて、ご本人として、API自体を通ります。役割の確認、検証、関門は、同じです。

名前つきのツール #

ツールできること必要なもの
whats_waiting自分のOK待ちの部署の工程と、未読の通知。ここから始めます—
list_productionsワークスペースの作品と、そのエピソード—
get_episode1つのエピソード。シーンとカットを編集順に、各部署の工程(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エピソードの最新の脚本の稿と、すでにあるキャスト、セット、小道具の@handlesepisode_id
edit_script脚本全体を送らずに、シーン、セリフ、1行を変更する。正確なテキストと置き換え内容を指定し、新しいバージョンとして保存される。コメントとタグも引き継がれるepisode_id、base_rev、edits
submit_breakdownClaudeのカット割りを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 → 3Dadd_to_visualize
カット、テイク、シーンのBlenderのクリップ対象の範囲のStoryboard → 3Dadd_to_visualize
シーン、シーケンス、エピソードのビデオコンテStoryboard → Animaticadd_to_visualize
カットのラフまたは本番の動画Storyboard → Shotsにテイクとしてupload_file
リファレンス画像やムードボードHome → Filesupload_file

置き場所を間違えたものは、アップロードし直さずに移せます。run_actionでmoveTakeまたはmoveAssetを使います(監督以上)。取り込みでできた採用は、移動と同時に解除されます。誰かが採用したテイクや、ここで生成したテイクは、そのままの場所に残ります。

find_actionsとrun_action #

名前つきのツールがないものは、すべてこの2つを通します。カットをつくる、テイクを採用する、ラフをつくる、見積もり、アセットとバージョン、フォルダ、キャンバス、費用、指示書、スタッフです。

  1. find_actionsは、「pick take」「create shot」「resolve thread」のような、いくつかの言葉で、APIのカタログを検索します。該当するアクションが、メソッド、パス、概要、必要な最低の役割、入力項目つきで返ります。
  2. run_actionは、名前を指定して1つ実行します。path_params(ワークスペースは含まない)、query、bodyは、アクションの説明に従います。APIのJSONが返ります。

find_actionsは、現場の言葉を理解します。スタッフが使う言葉を、APIの言葉に対応づけます。

使う言葉あわせて検索される言葉
pick, chooseselect
note, notes, comment, comments, feedbackthread, message
replymessage
rendergeneration, generate
makecreate, generate
new, addcreate
remove, deletearchive
signsignoff
approvesignoff, approval
cast, character, propelement
setelement, location
production, productionsproject
crewmember, steps
costcosts, estimate
priceestimate
prompt, preview, dry rungenerate
kosten, schatting, prijs (Dutch)generate, estimate
mismatchcontinuity
model, modelsmodels, 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_actions

    APIでできることをすべて検索し、該当するアクションを入力項目つきで返します。

    依頼例: 工程のOKのルールを変更するアクションを探して。

  • run_action

    find_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

このページのMarkdown: /docs/ja/claude/tools.md