Ozor 비디오 라이브러리은(는) 무엇을 하나요?
MCP를 통해 기존 Ozor.ai 비디오를 관리합니다: 목록 보기, 검사, 재내보내기, 임베드 또는 비디오 에이전트에 후속 편집을 보냅니다. 이 스킬은 mcp__ozor__*의 "처음부터 생성하는 것 외의 모든 것"을 다루는 표면입니다.
사용 시점
사용자가 Ozor 계정에 이미 존재하는 비디오에 대해 작업을 원할 때 이 스킬을 사용하세요. 신호:
- "내 비디오 목록 보여줘 / 보여줘"
- "... 상태가 어떻게 돼?"
- "공유 링크 / 다운로드 / 임베드 코드 가져와줘"
- "그 비디오를 9:16으로 다시 내보내줘"
- "후속 편집 보내줘: 장면 2를 ...로 바꿔"
- "그 비디오의 계획 보여줘"
- "작업 끝났어?" / "내보내기 확인해줘"
다음 경우에는 이 스킬을 사용하지 마세요:
- 텍스트에서 새 비디오 생성 →
ozor-generate - 문서/파일에서 생성 →
ozor-document-video - URL에서 생성 →
ozor-url-to-video
필수 MCP 도구
| 작업 | 도구 |
|---|---|
| 최근 비디오 목록 | mcp__ozor__list_videos |
| 하나의 비디오 세부 정보 가져오기 | mcp__ozor__get_video |
| 빌드 작업 상태 확인 | mcp__ozor__get_job |
| 작업이 끝날 때까지 차단 | mcp__ozor__wait_for_job |
| 비디오가 빌드된 계획 가져오기 | mcp__ozor__get_plan |
| 계획 편집 | mcp__ozor__update_plan |
| (새) 내보내기 트리거 | mcp__ozor__export_video |
| 내보내기 준비될 때까지 차단 | mcp__ozor__wait_for_export |
임베드를 위한 <iframe> 가져오기 | mcp__ozor__get_embed_code |
| 에이전트에 후속 편집 메시지 보내기 | mcp__ozor__send_message |
| 사용 가능한 음성 목록 | mcp__ozor__list_voices |
MCP가 연결되지 않은 경우 사용자에게 알리고 중지하세요.
일반적인 워크플로
A. 최근 비디오 목록 보기
mcp__ozor__list_videos({ limit?: 10 })
표로 표시:
| # | 제목 | 상태 | 포맷 | 업데이트 | videoId |
|---|------|------|------|----------|---------|
| 1 | ... | 내보내기 완료 | 16:9 | 2시간 전 | abc... |
2-3개의 명확한 다음 작업을 제안: "이 중에서 공유 링크가 필요하신가요? 임베드 코드는요? 하나를 9:16으로 다시 내보낼까요?"
B. 특정 비디오 세부 정보 가져오기
사용자가 비디오 이름이나 ID를 언급한 경우:
mcp__ozor__get_video({ videoId })
표시할 내용: 제목, 현재 상태 (draft / building / exported / failed), 포맷, 길이, 마지막 업데이트, 그리고 존재하는 모든 URL (공유, 편집기, 다운로드).
C. "내 마지막 비디오 상태가 어떻게 돼?"
list_videos({ limit: 1 })로 가장 최근 비디오를 찾습니다.status가building이면get_job(또는 사용자가 끝날 때까지 차단하려면wait_for_job)을 호출하여 진행 상황을 확인합니다.status가exported이면 URL을 표시합니다.
D. 임베드 코드 가져오기
mcp__ozor__get_embed_code({ videoId })
비디오가 아직 내보내지지 않은 경우 먼저 내보내기를 실행합니다 (아래 워크플로 F).
E. 공유 / 다운로드 URL 가져오기
비디오가 이미 내보내진 경우, get_video가 URL을 반환합니다. 그렇지 않은 경우:
mcp__ozor__export_video({ videoId })
mcp__ozor__wait_for_export({ videoId })
F. 재내보내기 (예: 편집 후 새 렌더링을 원하거나 URL이 만료된 경우)
mcp__ozor__export_video({ videoId })
mcp__ozor__wait_for_export({ videoId }) // -> 새 shareUrl, editorUrl, downloadUrl
mcp__ozor__get_embed_code({ videoId }) // -> 새 iframe
G. 다른 포맷으로 다시 렌더링 (예: 가로 → 세로)
포맷 변경은 계획을 통해 진행됩니다:
mcp__ozor__get_plan({ videoId })— 현재 계획 가져오기mcp__ozor__update_plan({ planId, format: "9:16" })— 변경 적용mcp__ozor__generate_from_plan({ planId })는 계획에서 생성 경로에 있습니다 — 사용자가 동일한 프로젝트를 업데이트하려면 대신send_message를 선호합니다 (워크플로 H). 새 프로젝트로 새 포맷을 원한다면generate_from_plan으로 넘어간 후 내보냅니다.
참고: generate_from_plan은 새 프로젝트를 생성하므로 ozor-document-video / ozor-url-to-video에 있습니다. 기존 프로젝트를 변경하지 않고 새 프로젝트를 시작하려고 할 때 사용자에게 알리세요.
H. 에이전트에 후속 편집 보내기
기존 비디오에 대해 처음부터 다시 시작하지 않고 텍스트/시각/장면 조정을 위해:
mcp__ozor__send_message({
videoId,
message: "<사용자의 편집 내용, 예: '장면 2에서 제목을 X로 바꾸고 배경을 더 밝게 해줘'>"
})
이것은 일반적으로 새 jobId를 반환합니다. 그 다음:
mcp__ozor__wait_for_job({ videoId, jobId })
mcp__ozor__export_video({ videoId })
mcp__ozor__wait_for_export({ videoId })
이후 새 URL을 표시합니다.
I. 계획 검사 / 편집
mcp__ozor__get_plan({ videoId | planId })
장면을 번호 목록으로 사용자에게 표시합니다. 변경을 원하면:
mcp__ozor__update_plan({ planId, ... })
그런 다음 다시 가져와 확인합니다. 계획 편집만으로는 렌더링된 비디오가 변경되지 않습니다 — 재생성 (send_message로 제자리 수정, generate_from_plan으로 새 프로젝트)과 내보내기가 뒤따라야 합니다.
J. 음성 목록
사용자가 음성을 선택하거나 교체할 때:
mcp__ozor__list_voices()
간결한 목록 (이름, 언어, 스타일)으로 표시합니다. 교체하는 경우 update_plan({ planId, voice: "<음성 ID>" })를 한 후 재생성합니다.
"그 비디오" / "내 마지막 비디오" 구분
사용자가 ID 없이 "그 비디오" 또는 "내 마지막 것"이라고 말한 경우:
list_videos({ limit: 5 }).- 설명과 정확히 일치하는 것이 하나면 사용합니다.
- 여러 개 가능성이 있으면 짧은 목록을 보여주고 물어봅니다.
조용히 임의의 비디오를 선택하지 마세요.
URL 표시
항상 사용 가능한 URL을 레이블과 함께 표시:
**공유:** <shareUrl>
**편집기:** <editorUrl>
**다운로드:** <downloadUrl>
**임베드:** (코드 블록 안에)
URL이 아직 존재하지 않는 경우 (예: 비디오가 내보내지지 않음), 만들어서 제시하지 말고 — 무엇이 누락되었는지 말하고 내보내기를 실행하겠다고 제안하세요.
오류 및 복구
videoId를 찾을 수 없음 → 최근 비디오 목록을 보여주고 어느 것을 의미하는지 물어보세요.- 작업 실패 → 실패 메시지를 그대로 전달하고; 수정 사항이나 재내보내기를 위한
send_message를 제안하세요. - 내보내기 실패 → 한 번 재시도하고; 다시 실패하면 오류를 표시하고 편집기 URL을 열어 검사하도록 권장하세요.
- 계획/비디오 동기화 불일치 (계획이 편집되었지만 재생성되지 않음) → 변경 사항이 준비되었지만 렌더링되지 않았다고 말하고 재생성을 제안하세요.
규칙
- 비디오 ID, 공유 URL 또는 상태를 절대 만들어내지 마세요. 모든 것은 MCP에서 비롯됩니다.
- 제자리 편집의 경우
send_message를 선호하세요.generate_from_plan을 통해 새 프로젝트를 생성하는 것보다 사용자는 거의 항상 기존 비디오가 업데이트되기를 원하며 복제를 원하지 않습니다. - 재내보내기는 저렴하고 안전합니다 — 사용자가 새 URL을 원하면 내보내기를 다시 실행하기만 하면 됩니다.
- 사용자가 어떤 비디오인지 모호할 때는 물어보세요 — 짧은 목록을 보여주고 추측하지 마세요.
- 모든 재생성 또는 재내보내기 후에 모든 URL을 표시하세요. 대화 초반의 오래된 URL은 만료되었을 수 있습니다.