MCP ツールリファレンス

Nodaro MCP ツールは、AI アシスタントが Nodaro MCP サーバーに接続したあと、あなたの Nodaro アカウントで行える操作です。ツールは約 200 個あり、ここでは作業別にまとめています。メディアの生成と編集、アセットの管理、ワークフローの構築と実行、作品全体の制作の指揮です。各ページには、ツールの正確な名前、各ツールに必要な権限、主なパラメーター、戻り値、料金を記載しています。

ツールのグループ

権限

各ツールには、1 つ以上の OAuth 権限（スコープ）が必要です。権限は、接続するときに同意画面で許可します。権限が許可されていないツールは、ツールの一覧にまったく含まれません。アシスタントにはそのツールが見えないので、呼び出して失敗することもありません。

権限が不要で、そのツールがあるエディションでは常に表示されるツールは、ping、list_models、start_film_director、start_video_director、start_workflow_editor、get_node_skill、get_picker_catalog、list_shot_shapes、get_shot_shape、list_brand_presets、get_recipe、get_studio_production_skill、get_recast_authoring_skill、validate_recast_script、build_ugc_creator、build_ugc_clips、build_ugc_cards です。

2 つの権限が必要なツールは、両方が許可されている場合にだけ表示されます。片方しか許可していない接続には、それらのツールは 1 つも表示されません。

ジョブが結果を返す仕組み

ほとんどの生成ツールはジョブを開始し、image collage started (id 7f3c…). のような 1 行ですぐに応答します。ジョブは Nodaro 上で実行され、その結果は必ずライブラリにも保存されます。

• MCP Apps を表示できるクライアント（Web 版の Claude など）では、ツールがカードを表示します。カードには、進行状況がリアルタイムで表示され、完了すると結果が表示されます。画像、動画、オーディオのツールには、それぞれ専用のカードがあります。ほかのジョブツールはすべて、出力の種類を判別する共通のカードを使います。表示されるのは、動画、画像、オーディオのプレーヤー、Copy ボタン付きのテキスト（脚本、歌詞、文字起こし、アライメントデータの場合）、またはコンポーネントの出力を縦に並べたもののいずれかです。
• それ以外のクライアントでは、アシスタントが get_job で 5〜10 秒ごとにジョブを確認するか、wait_for_job で最大 120 秒待機します。画像は通常 1 分以内に完了します。動画は通常 2〜10 分かかります。
• ワークフローとアプリの実行では、ジョブ ID ではなく実行 ID が返されます。実行 ID は get_app_run で確認します。

MCP の tasks API に対応したクライアントは、この API を通じても進行状況を受け取ります。結果をレビューする設定の環境で、ジョブが担当者のレビューを待っている場合、タスクのステータスは input_required になります。判断するのはレビュー担当者なので、ジョブを再実行しないでください。

mcp プロジェクト

ワークフローのツールは、mcp という名前の 1 つのプロジェクトの中で動作します。このプロジェクトは、アシスタントが初めて必要としたときに Nodaro が作成します。ダッシュボードでは、そのワークフローが MCP のワークフローに一覧表示されます。このタブから、ほかのワークフローと同じように開いたり、移動したり、削除したりできます。

ほかのプロジェクトにあるワークフローをアシスタントに扱わせるには、export_workflow でエクスポートし、そのバンドルを import_workflow でインポートします。コピーは mcp プロジェクトに入り、元のワークフローはそのまま残ります。

ツール項目の読み方

これらのページのツールは、すべて同じ構成で説明しています。

• 見出しは、generate_image のような正確なツール名です。アシスタントは、この名前でツールを呼び出します。
• 最初の数行では、ツールの機能、必要な権限、料金、Nodaro Cloud だけのツールかどうかを説明します。
• パラメーターの表には、主なパラメーターとその型を記載しています。必須のパラメーターには必須と記載しています。デフォルト値と制限は、説明の列に記載しています。
• 戻り値には、返される内容を記載しています。多くの場合はジョブ ID で、プランや一覧などの結果が返されることもあります。

最終的な基準になるのは、アシスタントが接続時に読み込む、ツール自体の説明です。これらのページの料金や制限がツールの説明と異なる場合は、ツールの説明のほうが正しい情報です。

多くのツールに共通する決まり

• メディアは URL か ID で指定：メディアを受け取るツールは、image_url のような公開された https の URL か、image_asset_id のような Nodaro の ID を受け付けます。ID には、そのメディアを作ったジョブか、アップロードの ID を指定できます。
• モデルは ID で指定：model パラメーターには、list_models で取得したモデル ID を指定します。list_models は、各モデルのアスペクト比、解像度、長さ、料金も返します。
• プリセット：generate_image、generate_video、generate_music、generate_speech、text_to_audio は、list_node_presets で取得した presetId を受け付けます。自分で指定したフィールドは、プリセットより優先されます。
• 再試行用のトークン：run_workflow、run_app、run_component と、いくつかのプロダクション用のツールは、client_request_id を受け付けます。値は、英字、数字、_ - . : からなる 8〜128 文字です。タイムアウトの後に再試行するときは、同じ値を使ってください。Nodaro が同じ処理を 2 回開始したり、2 回課金したりすることはありません。
• クレジットを使う前の見積もり：一部のツールは、処理を開始せずに料金を見積もれます。たとえば、dry_run: true を付けたスタジオのツールや、confirm を付けない start_recast です。

Nodaro Cloud だけのツール

Nodaro Cloud にだけあるツールは、check_balance、credit_transactions、plan_edit、voice_changer_pro、voice_changer_pro_analyze、voice_changer_pro_export、create_explainer、create_launch_video、start_film_director、pro_3d_render、ワークスペースのツール、Recast のツール、スタジオプロダクションのツール、パイプラインツール、UGC ビルダーです。ワークスペースのツールには、組織機能が有効になっていることも必要です。pro_3d_render は、そのレンダリングエンジンを利用できる間だけ表示されます。