---
title: "Claudeでできること"
description: "Filmsquareがお手持ちのClaudeに渡すすべてのMCPツールと、find_actionsとrun_actionでAPIの残りに届く方法、そして意図的に外してあるものを説明します。"
url: https://www.filmsquare.ai/docs/ja/claude/tools/
lang: ja
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でできること

お手持ちの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つを通します。カットをつくる、テイクを採用する、ラフをつくる、見積もり、アセットとバージョン、フォルダ、キャンバス、費用、指示書、スタッフです。

1. `find_actions`は、「pick take」「create shot」「resolve thread」のような、いくつかの言葉で、APIのカタログを検索します。該当するアクションが、メソッド、パス、概要、必要な最低の役割、入力項目つきで返ります。
2. `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はそれを読んで、何が足りないかを伝えます。[出会うエラー](https://www.filmsquare.ai/docs/ja/api/overview/#errors-you-will-meet)をご覧ください。

## 意図的に外してあるもの

次のものには、設計上、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`です。[プロンプトと作業の進め方](https://www.filmsquare.ai/docs/ja/claude/prompts/)をご覧ください。
