AI 에이전트용
MCP로 동영상 변환
Muxara는 원격 MCP 서버를 제공하여 Claude, Cursor 등 에이전트가 변환 작업을 생성하고, 미디어를 업로드하고, 결과를 다운로드할 수 있습니다 - muxara.com과 동일한 500MB 제한 및 공정 사용 제한이 적용됩니다.
도구
8개의 MCP 도구가 웹사이트 변환 흐름을 반영합니다. 에이전트는 아래 엔드포인트에서 Streamable HTTP로 호출합니다.
list_conversions허용되는 입력 확장자와 출력 형식이 포함된 82개 변환 슬러그를 나열합니다.
get_conversion_defaults슬러그에 대한 기본 및 유효한 코덱, 품질, 트림 매개변수를 가져옵니다.
create_conversion_job작업을 생성하고 서명된 업로드 URL을 받습니다(입력 최대 500MB).
confirm_upload서명된 URL에 파일이 업로드되었음을 확인합니다.
update_conversion_job처리 전 출력 형식 또는 변환 설정을 변경합니다.
start_conversion워커에서 FFmpeg 변환을 대기열에 추가합니다.
get_conversion_status준비되면 작업 상태 및 진행률을 폴링합니다.
get_media_info업로드된 파일의 재생 시간, 해상도, 코덱, 비트레이트를 분석합니다.
사용 사례
AI 채팅 어시스턴트
사용자가 MKV를 MP4로 변환해 달라고 요청합니다. 에이전트가 형식을 나열하고, 작업을 생성하며, 업로드를 안내하고, 준비되면 다운로드 링크를 반환합니다.
자동화 파이프라인
스크립트나 CI 작업이 변환 작업을 생성하고, 서명된 URL로 업로드하며, 브라우저 없이 상태를 폴링합니다 - 미디어 준비 워크플로에 유용합니다.
형식 탐색
에이전트는 list_conversions와 get_conversion_defaults를 호출한 후 파일 확장자와 대상 기기에 맞는 슬러그를 선택합니다.
에디터 및 CMS 통합
Muxara에 트랜스코딩을 위임하는 맞춤 도구를 구축하면서 공개 웹사이트와 동일한 제한을 유지합니다.
워크플로
파일 바이트는 MCP 도구 호출을 통해 전송되지 않습니다. 업로드는 웹사이트와 같이 서명된 URL을 사용합니다.
- create_conversion_job - jobId와 uploadUrl 반환
- uploadUrl로 파일 PUT (Content-Type: application/octet-stream)
- confirm_upload
- start_conversion (선택적으로 먼저 update_conversion_job)
- get_conversion_status로 status가 ready가 될 때까지
- 상태 응답의 URL에서 다운로드
연결
Streamable HTTP 전송을 사용하세요. 정규 엔드포인트는 https://api.muxara.com/mcp (별칭: /sse)입니다.
Cursor
MCP 설정에 추가 (.cursor/mcp.json 또는 Cursor 설정):
{
"mcpServers": {
"muxara": {
"url": "https://api.muxara.com/mcp"
}
}
}MCP Inspector
Inspector를 실행하고 Streamable HTTP를 선택한 후 전체 엔드포인트 URL을 입력하세요:
npx @modelcontextprotocol/inspector
# Streamable HTTP → https://api.muxara.com/mcp인증
MCP 서버는 공개입니다 - API 키, OAuth, Muxara 계정이 필요하지 않습니다.
- API 키 또는 가입 불필요
- api.muxara.com/mcp에서 Streamable HTTP
- 공정 사용 속도 제한 적용
- 무료 변환 및 다운로드
웹사이트와 동일한 제한
MCP 도구는 muxara.com과 동일한 작업 API에 위임합니다. 모든 클라이언트에 적용됩니다.
| 최대 업로드 | 파일당 500 MB |
|---|---|
| 작업 생성 | 시간당 20개 작업 (공정 사용 제한) |
| API 요청 | 분당 120개 요청 (공정 사용 제한) |
| 파일 보관 | 24시간 |
| 변환 쌍 | 82개 슬러그 |
| 비용 | 무료 - 변환 및 다운로드 비용 없음(파일당 최대 500 MB, 공정 사용 제한 적용). |
문서
기계 판독 가능한 디스커버리 파일 및 LLM 제공자용 전체 에이전트 참조.
- llms.txt
LLM 에이전트용 큐레이션된 사이트 인덱스
- llms-full.txt
도구, API, 변환 가이드가 포함된 전체 참조
- .well-known/mcp.json
MCP 서버 디스커버리 메타데이터
- .well-known/mcp/server-card.json
도구 목록, 제한, 엔드포인트 세부정보