Dla agentów AI

Konwertuj wideo przez MCP

Muxara udostępnia zdalny serwer MCP, dzięki czemu Claude, Cursor i inne agenty mogą tworzyć zadania konwersji, przesyłać media i pobierać wyniki - z tym samym limitem 500 MB i limitami fair use co muxara.com.

Narzędzia

Osiem narzędzi MCP odzwierciedla przepływ konwersji ze strony. Agenty wywołują je przez Streamable HTTP na poniższym endpoincie.

list_conversions

Lista wszystkich 82 slugów konwersji z akceptowanymi rozszerzeniami wejścia i formatem wyjścia.

get_conversion_defaults

Pobierz domyślne i dozwolone parametry kodeka, jakości i przycinania dla slug.

create_conversion_job

Utwórz zadanie i otrzymaj podpisany URL uploadu (maks. 500 MB wejścia).

confirm_upload

Potwierdź, że plik został przesłany na podpisany URL.

update_conversion_job

Zmień format wyjścia lub ustawienia konwersji przed przetwarzaniem.

start_conversion

Dodaj konwersję FFmpeg do kolejki na workerze.

get_conversion_status

Odpytuj status i postęp zadania, gdy gotowe.

get_media_info

Analizuj przesłany plik pod kątem czasu trwania, rozdzielczości, kodeków i bitrate.

Zastosowania

Asystenci czatu AI

Użytkownik prosi asystenta o konwersję MKV na MP4. Agent listuje formaty, tworzy zadanie, prowadzi upload i zwraca link do pobrania po zakończeniu.

Potoki automatyzacji

Skrypty lub zadania CI tworzą konwersje, przesyłają przez podpisane URL i odpytują status bez przeglądarki - przydatne w workflowach przygotowania mediów.

Odkrywanie formatów

Agenty wywołują list_conversions i get_conversion_defaults przed wyborem właściwego slug dla rozszerzenia pliku i urządzenia docelowego.

Integracje z edytorami i CMS

Buduj własne narzędzia przekazujące transkodowanie do Muxara z tymi samymi limitami co publiczna strona.

Przepływ pracy

Bajty pliku nie są wysyłane przez wywołania narzędzi MCP. Upload używa podpisanego URL, jak na stronie.

  1. create_conversion_job - zwraca jobId i uploadUrl
  2. PUT pliku na uploadUrl (Content-Type: application/octet-stream)
  3. confirm_upload
  4. start_conversion (opcjonalnie najpierw update_conversion_job)
  5. get_conversion_status aż status będzie ready
  6. Pobierz z URL w odpowiedzi statusu

Połącz

Użyj transportu Streamable HTTP. Kanoniczny endpoint to https://api.muxara.com/mcp (alias: /sse).

Cursor

Dodaj do konfiguracji MCP (.cursor/mcp.json lub ustawienia Cursor):

{
  "mcpServers": {
    "muxara": {
      "url": "https://api.muxara.com/mcp"
    }
  }
}

MCP Inspector

Uruchom inspector, wybierz Streamable HTTP i podaj pełny URL endpointu:

npx @modelcontextprotocol/inspector
# Streamable HTTP → https://api.muxara.com/mcp

Uwierzytelnianie

Serwer MCP jest publiczny - bez kluczy API, OAuth ani konta Muxara.

  • Bez klucza API i rejestracji
  • Streamable HTTP na api.muxara.com/mcp
  • Obowiązują limity fair use
  • Darmowa konwersja i pobieranie

Te same limity co na stronie

Narzędzia MCP korzystają z tego samego job API co muxara.com. Limity dotyczą każdego klienta.

Maks. upload500 MB na plik
Tworzenie zadań20 zadań na godzinę (limit fair use)
żądania API120 żądań na minutę (limit fair use)
Przechowywanie plików24 godzin
Pary konwersji82 slugów
KosztDarmowe – konwertuj i pobieraj bez opłat (do 500 MB na plik, obowiązują limity fair-use).

Dokumentacja

Pliki discovery czytelne dla maszyn i pełna referencja agenta dla dostawców LLM.

Często zadawane pytania

Nie. Serwer MCP jest publiczny z limitami fair use, jak strona. OAuth i konto nie są wymagane.

Nie. create_conversion_job zwraca podpisany uploadUrl. PUT pliku bezpośrednio na ten URL (do 500 MB), potem wywołaj confirm_upload. Tak jak w przeglądarce.

Nie. Konwersja i pobieranie są darmowe, jak na muxara.com.

Tak. Uruchom workera Muxara na porcie 3001 i połącz się z http://localhost:3001/mcp przez MCP Inspector lub klienta.