# ギャラリーとアセット

> AI アシスタントから、Nodaro のギャラリーとアップロードを閲覧し、結果をチャットに表示します。ジョブの詳細の読み取り、アプリの実行の追跡、お気に入りの登録もできます。

Source: https://nodaro.ai/ja/docs/mcp/tools/gallery-and-assets

**ギャラリーとアセットのツール**を使うと、アシスタントは、あなたが Nodaro ですでに作ったものを探し、表示し、再利用できます。`browse_gallery` と `browse_uploads` は、結果とアップロードをグリッドで表示します。`get_asset` と `display_asset` は、1 つの結果を取得または表示します。`get_app_run` はワークフローやアプリの実行を追跡し、`list_favorites` と `favorite_asset` はお気に入りを管理します。どのツールもクレジットはかかりません。

## `browse_gallery`
ギャラリーを、操作できるサムネイルのグリッドで表示します。タイルをクリックすると、表示、コピー、次の編集での使用ができます。ユーザーが自分の作品を見たいときに使います。アシスタントがデータだけを必要とする場合は、[`list_jobs`](https://nodaro.ai/docs/mcp/tools/jobs#list_jobs) を使います。

**権限**：`assets:read`。**クレジット**：無料。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `scope` | string | 自分のライブラリなら `mine`（デフォルト）、ほかのユーザーの最近の公開された結果なら `public` です。 |
| `kinds` | array | 含めるメディアの種類で、`image`、`video`、`audio` を自由に組み合わせます。デフォルトは `["image", "video"]` です。 |
| `kind` | string | 1 つのメディアの種類で、`image`、`video`、`audio` のいずれかです。 |
| `query` | string | プロンプトの中から検索する語で、最大 200 文字です。たとえば `rabbit` です。 |
| `limit` | integer | 1〜200 です。デフォルトは `50` です。 |
| `cursor` | string | 前のページの `next_cursor` です。 |

**戻り値**：MCP Apps を表示できるクライアントではグリッドが表示され、データとしては項目と `next_cursor` が返されます。

## `browse_uploads`
Nodaro が生成した結果ではなく、あなたがアップロードしたファイルを表示します。以前のアップロードを、新しい生成の入力として選ぶときに使います。グリッドの **Use** ボタンを押すと、ファイルの ID がチャットに渡されます。

**権限**：`assets:read`。**クレジット**：無料。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `kind` | string | `image`、`video`、`audio` のいずれかです。すべてのアップロードを対象にするには、省略します。 |
| `search` | string | ファイル名の一部で、最大 200 文字です。 |
| `limit` | integer | 1〜100 です。デフォルトは `40` です。 |
| `cursor` | string | 前のページの `nextCursor` です。 |

**戻り値**：URL と ID 付きのアップロードと、`nextCursor` です。

## `get_asset`
1 つの結果の詳細（出力 URL、プロンプト、モデル）を返します。自分のジョブはステータスに関係なく返し、ほかのユーザーのジョブは公開済みで完了したものを返します。失敗したジョブには、`retryable`、`guidance`、そしてある場合は `suggestedProvider` が追加されます。これらについては、[ジョブが失敗したとき](https://nodaro.ai/docs/mcp/tools/jobs#when-a-job-fails)で説明しています。

**権限**：`assets:read`。**クレジット**：無料。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `job_id` | string | **必須**。結果のジョブ ID です。 |

**戻り値**：`input` を除いた[ジョブエンベロープ](https://nodaro.ai/docs/mcp/tools/jobs#the-job-envelope)です。

## `display_asset`
1 つの結果をチャットに表示します。ユーザーには、データではなく、画像、動画、オーディオそのものが表示されます。画像には、**Animate**、**Edit**、**Recreate** のボタンと全画面表示も付きます。アシスタントが詳細だけを必要とする場合は、`get_asset` を使います。

**権限**：`assets:read`。**クレジット**：無料。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `job_id` | string | **必須**。ステータスを問わない自分のジョブ、またはほかのユーザーの公開済みで完了したジョブです。 |

**戻り値**：メディアカードです。結果の詳細は、データとして返されます。

## `get_app_run`
ワークフローの実行、または公開されたアプリの実行の進行状況を返します。内容は、実行のステータス、各ノードの状態、それまでに生成されたすべての出力 URL と、それぞれのプロンプト、モデル、ジョブ ID です。ジョブ ID ではなく実行 ID を返す [`run_workflow`](https://nodaro.ai/docs/mcp/tools/projects-and-workflows#run_workflow) と [`run_app`](https://nodaro.ai/docs/mcp/tools/apps-and-components#run_app) の後に使います。

**権限**：`assets:read`。**クレジット**：無料。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `execution_id` | string | **必須**。実行 ID です。 |

**戻り値**：実行のステータス、ノードの状態、それまでの出力です。

## `list_favorites`
お気に入りの結果のジョブ ID を、新しい順に一覧表示します。

**権限**：`assets:read`。**クレジット**：無料。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `limit` | integer | 1〜100 です。 |
| `cursor` | string | 前のページのカーソルです。 |

**戻り値**：お気に入りのジョブ ID です。

## `favorite_asset`
結果をお気に入りに追加するか、お気に入りから削除します。

**権限**：`assets:write`。**クレジット**：無料。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `job_id` | string | **必須**。お気に入りに登録または解除する結果です。 |
| `favorited` | boolean | **必須**。`true` でお気に入りに追加し、`false` で削除します。 |

**戻り値**：確認メッセージです。

## Frequently asked questions

### Claude で Nodaro のギャラリーを見るにはどうすればよいですか？

ギャラリーを見せてほしいと頼みます。browse_gallery が、最近の画像と動画をクリックできるグリッドで表示します。プロンプトを検索することもでき、たとえばウサギが写っている画像をすべて探せます。

### browse_gallery と browse_uploads の違いは何ですか？

browse_gallery は、Nodaro があなたのために生成した結果を表示します。browse_uploads は、あなたが自分でアップロードしたファイルを表示するので、その中から新しい生成の入力を選べます。

### アシスタントは、公開ギャラリーの結果を使えますか？

はい。get_asset と display_asset は、自分のジョブに加えて、ほかのユーザーの公開済みで完了したジョブも返します。そのため、アシスタントは公開された結果の URL をほかのツールに渡せます。

### アシスタントが開始したワークフローの実行を追跡するにはどうすればよいですか？

run_workflow または run_app が返した実行 ID で、get_app_run を呼び出します。実行のステータス、各ノードの状態、それまでに生成されたすべての出力が表示されます。