# 갤러리와 에셋

> AI 어시스턴트에서 Nodaro 갤러리와 업로드를 찾아보고, 결과를 채팅에 표시하고, 작업 정보를 읽고, 앱 실행을 확인하고, 즐겨찾기를 표시합니다.

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

**갤러리와 에셋 도구**를 사용하면 어시스턴트가 내가 Nodaro에서 이미 만든 것을 찾고, 보여 주고, 다시 쓸 수 있습니다. `browse_gallery`와 `browse_uploads`는 내 결과와 업로드를 그리드로 보여 주고, `get_asset`과 `display_asset`은 결과 하나를 가져오거나 보여 줍니다. `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 | 미디어 종류 하나로, `image`, `video`, `audio` 중 하나입니다. |
| `query` | string | 프롬프트에서 검색할 단어로, 최대 200자입니다. 예: `rabbit`. 모든 단어가 대소문자와 관계없이 프롬프트에 있어야 합니다. |
| `limit` | integer | 1~200입니다. 기본값은 `50`입니다. |
| `cursor` | string | 이전 페이지의 `next_cursor`입니다. |

**반환값:** MCP Apps를 표시하는 클라이언트에서는 그리드를 보여 주고, 데이터로는 항목과 `next_cursor`를 반환합니다.

공개 범위는 웹의 공개 갤러리가 보여 주는 것을 같은 검토 기준으로 보여 줍니다. 그래서 한 페이지의 항목이 `limit`보다 적을 수 있습니다. `next_cursor`가 없어질 때까지 계속 따라가세요.

내 갤러리에는 내 [**EDL 적용**](https://nodaro.ai/docs/nodes/video/apply-edl) 렌더도 나열됩니다. 동영상 렌더는 `video`에, 오디오 렌더는 `audio`에 들어갑니다. 미리 보기 품질로 만든 렌더에는 `preview: true`가 있고, 텍스트 줄에 `(preview)`가 표시됩니다. 공개 범위에는 **EDL 적용** 렌더가 나열되지 않습니다.

## `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`입니다. 미리 보기 품질로 만든 **EDL 적용** 렌더에는 `preview: true`가 있고, 텍스트 줄에 `(preview)`가 표시됩니다.

## `get_asset`
결과 하나의 출력 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`
결과 하나를 채팅에 보여 줍니다. 사용자는 데이터 대신 이미지, 동영상, 오디오를 봅니다. 이미지에는 **Animate**(애니메이션), **Edit**(편집), **Recreate**(다시 만들기) 버튼과 전체 화면 보기도 붙습니다. 어시스턴트에게 세부 정보만 필요하면 `get_asset`을 사용하세요.

**권한:** `assets:read`. **크레딧:** 무료.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `job_id` | string | **필수.** 상태와 관계없이 내 작업, 또는 다른 사용자의 공개된 완료 작업입니다. |

**반환값:** 미디어 카드와, 데이터로 제공되는 결과의 세부 정보입니다.

## `get_app_run`
워크플로 실행이나 게시된 앱 실행의 진행 상황을 반환합니다. 실행 상태, 각 노드의 상태, 그리고 지금까지 만들어진 모든 출력 URL과 각각의 프롬프트, 모델, 작업 id입니다. 작업 ID 대신 실행 ID(`execution_id`)를 반환하는 [`run_workflow`](https://nodaro.ai/docs/mcp/tools/projects-and-workflows#run_workflow), [`render_final`](https://nodaro.ai/docs/mcp/tools/projects-and-workflows#render_final), [`run_app`](https://nodaro.ai/docs/mcp/tools/apps-and-components#run_app) 다음에 사용하세요. `get_job`은 실행 ID를 찾지 못합니다. 실행이 `pending`이나 `running`인 동안 5~10초마다 호출하세요.

**권한:** `assets:read`. **크레딧:** 무료.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `execution_id` | string | **필수.** 실행 id입니다. |

**반환값:** 실행 상태, 노드 상태, 지금까지의 출력입니다.

- `executionId`, `status`, `errorMessage`, 그리고 개수 `total`, `completed`, `failed`, `skipped`, `skippedForEmptyInput`이 담긴 `summary`입니다.
- `nodeStates`는 워크플로 순서대로 노드마다 하나씩 있는 항목으로, `id`, `label`, `nodeType`, `status`, `error`, `jobId`, `text`, `media`가 담깁니다. `text`는 노드의 텍스트 출력으로 1,500자에서 잘리며, 잘렸으면 `textTruncated: true`가 붙습니다. `media`는 노드가 만든 모든 이미지, 동영상, 오디오 URL을 각각 `{ kind, url }`로 나열합니다. `skipReason: "empty_input"`은 이번 실행에서 노드의 입력에 아무것도 도달하지 않았다는 뜻입니다.
- `outputs`는 실행의 모든 미디어 URL로, 그것을 만든 작업의 `prompt`, `model`, `createdAt`이 함께 담깁니다.

실행이 완료되면 `outcome`도 담깁니다. 입력에 아무것도 도달하지 않아 건너뛴 노드가 하나 이상 있고 실패한 것이 없으면, 예를 들어 새 게시물을 찾지 못한 피드라면 결과는 `"nothing_new"`입니다. 그 밖에는 `"succeeded"`입니다. 실패하거나 취소된 실행에는 결과가 아니라 `status`가 있습니다.

## `list_favorites`
즐겨찾기한 결과의 작업 id를 최신순으로 나열합니다.

**권한:** `assets:read`. **크레딧:** 무료.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `limit` | integer | 1~100입니다. |
| `cursor` | string | 이전 페이지의 커서입니다. |

**반환값:** 즐겨찾기한 결과의 작업 id입니다. 즐겨찾기한 내 **EDL 적용** 렌더도 나열되며, 미리 보기에는 `preview: true`가 있습니다. 다른 사람의 렌더는 나열되지 않습니다.

## `favorite_asset`
결과를 즐겨찾기에 추가하거나 제거합니다. 결과는 내 작업일 수도 있고 다른 사용자의 공개 작업일 수도 있습니다. `favorited: true`를 지정한 [`list_jobs`](https://nodaro.ai/docs/mcp/tools/jobs#list_jobs)는 내가 즐겨찾기한 작업을 나열합니다.

**권한:** `assets:write`. **크레딧:** 무료.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `job_id` | string | **필수.** 표시할 결과입니다. |
| `favorited` | boolean | **필수.** `true`이면 즐겨찾기에 추가하고, `false`이면 제거합니다. |

**반환값:** 확인 메시지입니다.

## 자주 묻는 질문

### 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을 호출하세요. 실행 상태, 각 노드의 상태, 지금까지 만들어진 모든 출력을 보여 줍니다.