AI エージェント向け
MCP で動画を変換
Muxara はリモート MCP サーバーを公開し、Claude、Cursor などのエージェントが変換ジョブの作成、メディアのアップロード、結果のダウンロードを行えます - muxara.com と同じ 500 MB 上限とフェアユース制限が適用されます。
ツール
8 つの MCP ツールが Web サイトの変換フローを再現します。エージェントは下記エンドポイントで Streamable HTTP 経由で呼び出します。
list_conversions82 種類の変換スラッグと、受け付ける入力拡張子・出力形式を一覧表示。
get_conversion_defaultsスラッグのデフォルトおよび有効なコーデック、品質、トリムパラメータを取得。
create_conversion_jobジョブを作成し、署名付きアップロード URL を取得（入力最大 500 MB）。
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 にトランスコードを委譲するカスタムツールを構築し、公開 Web サイトと同じ制限を維持。
ワークフロー
ファイルのバイト列は MCP ツール呼び出し経由では送信されません。アップロードは Web サイトと同様に署名付き 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
- フェアユースのレート制限が適用
- 変換・ダウンロード無料
Web サイトと同じ制限
MCP ツールは muxara.com と同じジョブ API に委譲。すべてのクライアントに適用。
| 最大アップロード | 1 ファイルあたり 500 MB |
|---|---|
| ジョブ作成 | 1 時間あたり 20 ジョブ（フェアユース制限） |
| API リクエスト | 1 分あたり 120 リクエスト（フェアユース制限） |
| ファイル保持 | 24 時間 |
| 変換ペア | 82 スラッグ |
| 料金 | 無料 - 変換・ダウンロードに料金不要（1 ファイル最大 500 MB、フェアユース制限あり）。 |
ドキュメント
機械可読のディスカバリーファイルと LLM プロバイダー向け完全リファレンス。
- llms.txt
LLM エージェント向けサイト索引
- llms-full.txt
ツール、API、変換ガイドの完全リファレンス
- .well-known/mcp.json
MCP サーバーディスカバリーメタデータ
- .well-known/mcp/server-card.json
ツール一覧、制限、エンドポイント詳細