Nodaro 문서업로드
채팅 안 파일 선택기, 브라우저 업로드 링크, 셸에서 쓰는 미리 서명된 URL로 모든 MCP 클라이언트에서 내 이미지, 오디오, 동영상을 Nodaro에 업로드하세요.
업로드 도구는 내 파일을 Nodaro로 가져와, 어시스턴트가 다음 생성에서 사진, 음성 녹음, 클립을 쓸 수 있게 합니다. 업로드 방법은 채팅 안 파일 선택기, 브라우저에서 여는 링크, 셸 명령을 실행할 수 있는 클라이언트를 위한 미리 서명된 URL의 세 가지입니다. 모든 업로드 도구에는 assets:write 권한이 필요하며, 업로드에는 크레딧이 들지 않습니다.
사용할 방법
| 방법 | 도구 | 사용 가능한 곳 | 작동 방식 |
|---|---|---|---|
| 채팅 안 파일 선택기 | upload_image_widget, upload_audio_widget, upload_video_widget | 웹용 Claude처럼 MCP Apps를 표시하는 클라이언트 | 채팅 안에 파일 선택기가 열립니다. 공개 URL은 자동으로 채팅에 돌아갑니다. |
| 브라우저 링크 | request_image_upload, request_audio_upload, request_video_upload | 모든 클라이언트 | 브라우저에서 Nodaro 링크를 열고 그곳에 파일을 끌어다 놓습니다. |
| 미리 서명된 URL | prepare_image_upload, prepare_audio_upload, prepare_video_upload | Cursor, Cline, Claude Desktop, Claude Code처럼 셸에 접근할 수 있는 클라이언트 | 어시스턴트가 curl 명령 하나로 파일을 직접 보냅니다. |
이전 작업의 결과처럼 파일에 이미 공개 URL이 있으면, 업로드를 건너뛰고 그 URL을 바로 전달하세요.
upload_image_widget
채팅 안에 이미지용 파일 선택기를 엽니다. 휴대폰에서는 선택기가 카메라나 사진 보관함을 엽니다. 위젯이 파일을 업로드하고 공개 URL을 채팅에 알려 주므로, 선택기를 한 번만 누르면 됩니다. upload_audio_widget과 upload_video_widget도 오디오와 동영상에 대해 같은 방식으로 작동합니다.
권한: assets:write. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
max_files | integer | 선택기가 받는 파일 수로, 1~10입니다. 기본값은 1입니다. 한 사람의 레퍼런스 사진 여러 장처럼 파일이 여러 개 필요한 흐름에는 더 큰 값을 쓰세요. |
purpose | string | 업로드 카드에 표시되는 짧은 라벨로, 최대 120자입니다. 예를 들어 product image for the catalog app(카탈로그 앱용 상품 이미지)처럼 씁니다. 어시스턴트에게 파일의 용도를 다시 알려 주는 역할도 합니다. |
반환값: { upload_url, public_url } 쌍의 목록인 uploads와, 첫 번째 파일의 upload_url, public_url입니다. 선택기를 표시하지 않는 클라이언트도 이 값을 일반 링크로 보여 줄 수 있습니다.
request_image_upload
어떤 브라우저에서든 열어 이미지를 끌어다 놓을 수 있는 짧은 Nodaro 링크를 반환합니다. 파일이 내 브라우저를 거쳐 전송되므로 모든 클라이언트에서, 파일 크기와 상관없이 작동합니다. request_audio_upload와 request_video_upload도 오디오와 동영상에 대해 같은 일을 합니다.
권한: assets:write. 크레딧: 무료.
이 도구에는 매개변수가 없습니다.
반환값: 열어야 할 페이지인 upload_page_url과, 파일이 갖게 될 주소인 public_url입니다. 공개 URL을 미리 알 수 있으므로, 업로드가 끝났다고 확인해 주면 어시스턴트가 다음 호출에서 그 URL을 쓸 수 있습니다.
prepare_image_upload
어시스턴트가 curl로 파일을 보낼, 미리 서명된 업로드 URL을 반환합니다. 파일이 대화를 거치지 않으므로 파일 크기는 상관없습니다. prepare_audio_upload와 prepare_video_upload도 오디오와 동영상에 대해 같은 일을 합니다.
권한: assets:write. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
mime_type | string | 필수. 보낼 파일의 유형입니다. |
| 도구 | 허용되는 mime_type 값 |
|---|---|
prepare_image_upload | image/png, image/jpeg, image/webp, image/avif, image/heic, image/heif |
prepare_audio_upload | audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/webm, audio/ogg, audio/flac, audio/x-flac, audio/aac, audio/x-m4a |
prepare_video_upload | video/mp4, video/webm, video/quicktime, video/x-matroska |
반환값: 1시간 동안 유효한 upload_url과 public_url입니다. 어시스턴트는 다음 명령으로 파일을 업로드합니다.
curl -X PUT --data-binary @path/to/file -H 'Content-Type: image/png' '<upload_url>'그런 다음 public_url을 다음 도구에 전달합니다. 예를 들어 image_url로 전달합니다.
웹용 Claude에서는 사용 불가
웹용 Claude와 Claude Android 앱은 저장소 호스트에 접근할 수 없으므로, 미리 서명된 업로드가 실패합니다. 그곳에서는 채팅 안 파일 선택기나 브라우저 링크를 사용하세요.
업로드 후
- 공개 URL 전달:
modify_image,animate_image,lip_sync,add_captions처럼 미디어를 받는 모든 도구에 공개 URL을 전달하세요. - 이전 업로드 찾기:
browse_uploads는 Nodaro가 생성한 결과와 별도로, 내가 업로드한 파일을 나열합니다. - 내레이션 동영상에 로고 표시: 동영상 디렉터의 브랜드 로고는 Nodaro에 업로드한 이미지여야 하므로, 먼저 이 도구 중 하나로 로고를 업로드하세요.
자주 묻는 질문
모든 MCP 클라이언트에서 쓸 수 있는 업로드 도구는 무엇인가요?
request 업로드 도구입니다. request_image_upload, request_audio_upload, request_video_upload는 내 브라우저에서 열어 파일을 끌어다 놓는 링크를 반환하므로, 파일 크기와 상관없이 모든 클라이언트에서 작동합니다.
웹용 Claude에서 prepare_image_upload가 실패하는 이유는 무엇인가요?
미리 서명된 업로드에는 셸 명령으로 파일을 직접 보낼 수 있는 클라이언트가 필요합니다. 웹용 Claude와 Claude Android 앱은 저장소 호스트에 접근할 수 없으므로, 그곳에서는 업로드 선택기나 request 업로드 링크를 사용하세요.
레퍼런스 사진 여러 장을 한 번에 업로드할 수 있나요?
네. upload_image_widget에 1~10 사이의 max_files를 보내세요. 그러면 선택기가 그만큼의 파일을 받고, 파일마다 공개 URL을 하나씩 반환합니다.
예전에 업로드한 파일을 다시 쓰려면 어떻게 하나요?
어시스턴트에게 browse_uploads를 호출해 달라고 요청하세요. 이 도구는 내 업로드를 URL과 함께 나열하며, 그 URL을 어떤 생성 도구에든 전달할 수 있습니다.
관련 문서
MCP 도구 레퍼런스
갤러리와 에셋
Claude
이미지 업로드
최종 업데이트