# MCP ツールリファレンス

> Nodaro MCP サーバーが公開するすべてのツールを作業別にまとめています。各ツールに必要な権限、ジョブが結果を返す仕組み、ツール項目の読み方も説明します。

Source: https://nodaro.ai/ja/docs/mcp/tools

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

## ツールのグループ
| グループ | ツールでできること |
| --- | --- |
| [ジョブ](https://nodaro.ai/docs/mcp/tools/jobs) | ジョブと実行を確認し、完了を待ち、診断します。 |
| [アップロード](https://nodaro.ai/docs/mcp/tools/uploads) | 手持ちの画像、オーディオ、動画を Nodaro に取り込みます。 |
| [ギャラリーとアセット](https://nodaro.ai/docs/mcp/tools/gallery-and-assets) | ギャラリーとアップロードを閲覧し、結果をチャットに表示し、お気に入りに登録します。 |
| [モデル、クレジット、プリセット](https://nodaro.ai/docs/mcp/tools/models-and-credits) | モデルを機能と料金とともに一覧表示し、残高を読み取り、ノードプリセットを適用します。 |
| [ワークスペース](https://nodaro.ai/docs/mcp/tools/workspaces) | セッションで作業する組織のワークスペースを選びます。 |
| [プロジェクトとワークフロー](https://nodaro.ai/docs/mcp/tools/projects-and-workflows) | ワークフローを作成、編集、インポート、エクスポート、実行し、ノードの組み立て方を学びます。 |
| [アプリとコンポーネント](https://nodaro.ai/docs/mcp/tools/apps-and-components) | 公開されたアプリと保存したコンポーネントを実行します。 |
| [パイプライン](https://nodaro.ai/docs/mcp/tools/pipelines) | **ストーリー → 動画**（Story to Video）のパイプラインを開始し、方向を調整し、承認します。 |
| [プロンプトとテキスト](https://nodaro.ai/docs/mcp/tools/prompts-and-text) | より良いプロンプトや脚本を書き、複数の結果から最も良いものを選びます。 |
| [画像](https://nodaro.ai/docs/mcp/tools/image) | 画像を生成、変換、編集、合成し、画像の内容を説明します。 |
| [動画](https://nodaro.ai/docs/mcp/tools/video) | 動画を生成、延長、スタイル変更、アップスケールし、人物に話させたり動かしたりします。 |
| [動画編集](https://nodaro.ai/docs/mcp/tools/video-editing) | 動画をトリミング、結合、ループし、字幕やオーバーレイを加え、組み立てます。 |
| [分析と編集リスト](https://nodaro.ai/docs/mcp/tools/analysis-and-edl) | 動画をシーンごとに分析し、無音を検出し、録音を同期し、編集決定リストをレンダリングします。 |
| [オーディオ](https://nodaro.ai/docs/mcp/tools/audio) | 音声、会話、ボイス、吹き替え、効果音、文字起こし、クリーンアップを扱います。 |
| [音楽](https://nodaro.ai/docs/mcp/tools/music) | Suno などの音楽モデルで、歌入りの曲とインストゥルメンタルを作ります。 |
| [キャラクター](https://nodaro.ai/docs/mcp/tools/characters) | キャラクターを作成し、ポートレートとバリエーションを生成し、アニメーション化します。 |
| [ロケーション](https://nodaro.ai/docs/mcp/tools/locations) | ロケーションを作成し、エスタブリッシングショットと雰囲気のクリップを生成します。 |
| [オブジェクトとクリーチャー](https://nodaro.ai/docs/mcp/tools/objects-and-creatures) | 見た目を固定した小道具、商品、動物、クリーチャーを扱います。 |
| [ショットシーケンスと動画ディレクター](https://nodaro.ai/docs/mcp/tools/shot-sequence-and-video-director) | ボイスオーバーに合わせてタイミングを取った、ナレーション付きのモーショングラフィックス動画を作ります。 |
| [スタジオプロダクション](https://nodaro.ai/docs/mcp/tools/studio-productions) | スタジオのエディターで編集を続けられる映画を作ります。 |
| [Recast](https://nodaro.ai/docs/mcp/tools/recast) | 1 つの JSON スクリプトとして書いた映画を、recast プロジェクトとしてレンダリングします。 |
| [3D シーン](https://nodaro.ai/docs/mcp/tools/3d-scenes) | 編集できる 3D シーンを作り、動画にレンダリングします。 |
| [ユーティリティ、レシピ、スキル](https://nodaro.ai/docs/mcp/tools/utility) | 接続をテストし、レシピとスキルを読み込み、UGC 動画を作ります。 |

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

| スコープ | ツール |
| --- | --- |
| `workflows:read` | `list_projects`、`get_project`、`list_workflows`、`get_workflow`、`get_workflow_json`、`export_workflow`、`list_components`、`get_component_inputs`、`get_recast_status`、`validate_studio_plan`、`list_studio_productions`、`get_studio_production`、`plan_studio_export` |
| `workflows:write` | `create_workflow`、`delete_workflow`、`update_workflow_json`、`import_workflow`、`import_recast_script`、`create_studio_production`、`import_studio_production`、`edit_studio_production`、`share_studio_production`、`clone_studio_production` |
| `workflows:execute` | `run_workflow`、`run_app`、`run_component`、`delete_app_run`、画像、動画、オーディオ、音楽、アセット、3D シーンのすべての生成、編集、分析のツール、プロンプトのツール、`reduce`、ショットシーケンスのツール、`create_explainer`、`create_launch_video`、`start_recast`、`resolve_recast_gate` |
| `workflows:write` と `workflows:execute` の両方 | `describe_studio_production`、`generate_studio_still`、`generate_studio_keyframe`、`generate_studio_clip`、`new_studio_shot_from_frame`、`voice_studio_shot`、`revoice_studio_clip`、`score_studio_production` |
| `jobs:read` | `list_jobs`、`get_job`、`wait_for_job`、`diagnose_run` |
| `assets:read` | `browse_gallery`、`browse_uploads`、`list_favorites`、`get_asset`、`display_asset`、`get_app_run`、`list_characters`、`get_character`、`list_locations`、`get_location`、`list_objects`、`get_object`、`list_creatures`、`get_creature` |
| `assets:write` | `favorite_asset`、`create_character`、`update_character`、`approve_portrait`、`recaption_character`、`create_location`、`update_location`、`approve_main_image`、`recaption_location`、`approve_object_main_image`、`recaption_object`、`approve_creature_main_image`、`recaption_creature`、9 つのアップロードツール |
| `credits:read` | `check_balance`、`credit_transactions` |
| `apps:read` | `list_apps`、`get_app_inputs` |
| `presets:read` | `list_node_presets`、`get_node_preset` |
| `pipelines:read` | `get_pipeline_stage_chat`、`get_pipeline_status`、`pipeline_pending_approvals` |
| `pipelines:execute` | `branch_pipeline`、`start_pipeline` |
| `pipelines:approve` | `chat_pipeline_stage`、`apply_chat_proposal` |
| `workspaces:read` | `list_workspaces` |
| `workspaces:write` | `select_workspace` |

権限が不要で、そのツールがあるエディションでは常に表示されるツールは、`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`](https://nodaro.ai/docs/mcp/tools/jobs#get_job) で 5〜10 秒ごとにジョブを確認するか、[`wait_for_job`](https://nodaro.ai/docs/mcp/tools/jobs#wait_for_job) で最大 120 秒待機します。画像は通常 1 分以内に完了します。動画は通常 2〜10 分かかります。
- **ワークフローとアプリの実行**では、ジョブ ID ではなく実行 ID が返されます。実行 ID は [`get_app_run`](https://nodaro.ai/docs/mcp/tools/gallery-and-assets#get_app_run) で確認します。

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

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

| ツール | アクセスできる範囲 |
| --- | --- |
| `list_projects`、`get_project` | すべてのプロジェクト（読み取り専用） |
| `list_workflows`、`get_workflow`、`get_workflow_json` | mcp プロジェクト内のワークフロー |
| `create_workflow`、`delete_workflow`、`update_workflow_json`、`import_workflow` | mcp プロジェクト内のワークフロー |
| `export_workflow` | 自分のすべてのワークフロー |
| `run_workflow` | 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`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_models) で取得したモデル ID を指定します。`list_models` は、各モデルのアスペクト比、解像度、長さ、料金も返します。
- **プリセット**：`generate_image`、`generate_video`、`generate_music`、`generate_speech`、`text_to_audio` は、[`list_node_presets`](https://nodaro.ai/docs/mcp/tools/models-and-credits#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`、[ワークスペースのツール](https://nodaro.ai/docs/mcp/tools/workspaces)、[Recast のツール](https://nodaro.ai/docs/mcp/tools/recast)、[スタジオプロダクションのツール](https://nodaro.ai/docs/mcp/tools/studio-productions)、[パイプラインツール](https://nodaro.ai/docs/mcp/tools/pipelines)、UGC ビルダーです。ワークスペースのツールには、組織機能が有効になっていることも必要です。`pro_3d_render` は、そのレンダリングエンジンを利用できる間だけ表示されます。

## Frequently asked questions

### Nodaro MCP サーバーには、いくつのツールがありますか？

Nodaro Cloud では約 200 個です。正確な一覧は、許可した権限とエディションによって変わります。使えないツールは、ツールの一覧から除かれるためです。

### アシスタントは、生成の結果をどのように受け取りますか？

生成ツールはジョブを開始し、すぐにその ID を返します。MCP Apps を表示できるクライアントには、進行状況をリアルタイムで示し、完了すると結果を見せるカードが表示されます。それ以外のクライアントは、その ID で get_job または wait_for_job を呼び出します。

### アシスタントが mcp プロジェクト内のワークフローしか編集できないのはなぜですか？

ワークフローのツールは mcp という名前の 1 つのプロジェクトの中で動作するため、アシスタントがあなた自身のプロジェクトを変更することはありません。それでも、アシスタントは export_workflow でどのワークフローも読み取り、そのコピーを mcp プロジェクトにインポートできます。

### 無料のツールはどれですか？

ping、list_models、get_node_skill、get_picker_catalog、list_shot_shapes、get_recipe などの参照系のツールとガイドツールは、無料です。メディアを生成、編集、分析するツールは、すべてクレジットを消費します。