Owl3D MCP 서버
AI 에이전트로 2D 영상을 3D로 변환
AI 에이전트에 Owl3D MCP 서버를 추가하고 Owl3D 계정으로 로그인하세요. 그다음 에이전트에게 영상 변환을 요청하면 됩니다. 에이전트가 가격을 보여 주고, 파일을 업로드하고, 3D 영상을 원본 옆에 저장합니다.
- OAuth로 로그인합니다. 설정에 API 키가 없습니다.
- 작업마다 시작 전에 가격을 확인합니다.
- 출력: 풀 SBS(사이드 바이 사이드) 3D 영상.
에이전트 연결하기
사용하는 클라이언트를 고르고 단계를 따라 하세요. 모든 클라이언트가 같은 서버 URL과 같은 Owl3D 로그인을 씁니다.
https://mcp.owl3d.com/mcp- Claude(웹 또는 데스크톱)를 열고 Settings에서 Connectors를 선택합니다.
- Add custom connector를 선택합니다. 이름에
Owl3D를 입력하고 서버 URL을 붙여 넣은 뒤 Add를 선택합니다. - Connect를 선택합니다. Owl3D 계정으로 로그인하고 허용을 선택합니다.
- 새 채팅에서 도구 메뉴의 Owl3D를 켭니다.
브라우저의 Claude는 컴퓨터에 있는 파일을 읽을 수 없습니다. 가격 확인과 작업 추적은 할 수 있습니다. 컴퓨터의 파일을 변환하려면 Claude Code 또는 VS Code를 사용하세요.
- 터미널에서 이 명령을 실행합니다:Shell
claude mcp add --transport http owl3d https://mcp.owl3d.com/mcp - Claude Code를 시작하고
/mcp를 입력합니다.owl3d을 선택한 뒤 Authenticate를 선택합니다. - 브라우저에서 Owl3D 계정으로 로그인하고 허용을 선택합니다.
- 이렇게 요청합니다:
Convert ~/Videos/clip.mp4 to 3D.
- ChatGPT에서 Settings를 열고 Apps & Connectors를 선택합니다. Advanced settings에서 Developer mode를 켭니다.
- Create를 선택합니다. 이름에
Owl3D를 입력하고 서버 URL을 붙여 넣습니다. Authentication은 OAuth로 설정합니다. - Create를 선택합니다. Owl3D 계정으로 로그인하고 허용을 선택합니다.
- 새 채팅에서 도구 메뉴의 Owl3D를 선택합니다.
ChatGPT는 컴퓨터에 있는 파일을 읽을 수 없습니다. 가격 확인과 작업 추적은 할 수 있습니다. 컴퓨터의 파일을 변환하려면 Claude Code 또는 VS Code를 사용하세요.
- 명령 팔레트를 열고
MCP: Add Server를 실행합니다. HTTP를 선택하고 서버 URL을 붙여 넣습니다. 또는.vscode/mcp.json에 다음을 추가합니다:JSON{ "servers": { "owl3d": { "type": "http", "url": "https://mcp.owl3d.com/mcp" } } } - 서버를 시작합니다. VS Code가 로그인을 요청합니다.
- Owl3D 계정으로 로그인하고 허용을 선택합니다.
- 에이전트 모드로 Copilot Chat을 열고 영상 변환을 요청합니다.
- 서버 URL로 원격 MCP 서버를 추가합니다. 전송 방식은 Streamable HTTP입니다.
- OAuth 2.1로 로그인합니다. 클라이언트가 Owl3D 로그인 페이지를 엽니다.
- 클라이언트에 가격 확인이 나타나면 승인합니다.
서버는 이 페이지에 있는 클라이언트의 로그인을 받습니다. 사용하는 클라이언트가 거부되면 클라이언트 이름을 적어 support@owl3d.com로 메일을 보내 주세요.
작동 방식
1. 연결
클라이언트에 서버 URL을 추가하고 Owl3D 계정으로 로그인합니다. 에이전트는 비밀번호를 볼 수 없습니다.
2. 요청
에이전트에게 영상 변환을 요청합니다. 에이전트가 파일 정보를 읽고 서버에 가격을 묻습니다.
3. 확인
클라이언트가 가격을 보여 줍니다. 승인하면 작업이 시작됩니다. 거절하면 아무 비용도 청구되지 않습니다.
4. 3D 영상 받기
에이전트가 파일을 업로드하고 Owl3D Cloud가 변환합니다. 에이전트가 3D 영상을 컴퓨터에 저장합니다.
에이전트가 쓰는 도구
서버는 에이전트에게 도구 6개를 제공합니다. 크레딧을 쓰는 도구는 create_job뿐이며, 가격을 확인한 뒤에만 씁니다.
| 도구 | 하는 일 |
|---|---|
list_formats | 지원하는 영상 형식, 제한, 출력 형식을 보여 줍니다. |
estimate | 영상 1개의 가격과 시간을 알려 줍니다. 비용은 청구되지 않습니다. |
create_job | 가격 확인을 요청한 뒤 작업을 시작합니다. |
complete_upload | 업로드가 끝났음을 서버에 알려 작업을 시작할 수 있게 합니다. |
get_status | 상태, 진행률, 남은 시간을 보여 줍니다. |
get_result | 3D 영상의 다운로드 링크를 줍니다. |
이렇게 요청하세요
평소 말투로 요청하면 됩니다. 예:
- ~/Videos/holiday.mp4를 3D로 변환해 줘.
- 이 영상을 3D로 변환하면 얼마야?
- 이 폴더의 MP4 파일을 모두 3D로 변환해 줘.
- 지난 3D 작업은 어디까지 진행됐어?
- Owl3D는 어떤 영상 형식을 변환할 수 있어?
가격
MCP 작업은 브라우저에서 Owl3D Cloud를 쓸 때와 같이 Owl3D 요금제의 월 사용량과 크레딧을 씁니다.
작업마다 시작 전에 클라이언트가 크레딧 가격 확인을 요청합니다. 승인하기 전에는 비용이 청구되지 않습니다. 거절한 작업은 무료입니다.
자주 묻는 질문
MCP 서버란 무엇인가요?
API 키가 필요한가요?
어떤 클라이언트가 영상을 변환할 수 있나요?
무엇을 받게 되나요?
어떤 영상을 변환할 수 있나요?
list_formats를 실행해 달라고 하면 볼 수 있습니다.여러 영상을 한 번에 변환할 수 있나요?
get_status로 모든 작업을 추적할 수 있습니다.에이전트 연결은 어떻게 끊나요?
지금 에이전트를 연결하세요
Owl3D 계정이 필요합니다. Owl3D Cloud에서 가입한 뒤 클라이언트에 서버 URL을 추가하세요.