Pour les agents IA

Convertir des vidéos avec MCP

Muxara expose un serveur MCP distant pour que Claude, Cursor et d'autres agents puissent créer des tâches de conversion, téléverser des médias et télécharger les résultats.

Outils

Huit outils MCP reproduisent le flux de conversion du site. Les agents les appellent via Streamable HTTP au point de terminaison ci-dessous.

list_conversions

Lister toutes les options de conversion avec extensions d'entrée acceptées et format de sortie.

get_conversion_defaults

Obtenir les paramètres par défaut et valides de codec, qualité et découpage pour un slug.

create_conversion_job

Créer une tâche et recevoir une URL de téléversement signée (max. 500 Mo en entrée).

confirm_upload

Confirmer que le fichier a été téléversé vers l'URL signée.

update_conversion_job

Modifier le format de sortie ou les paramètres de conversion avant le traitement.

start_conversion

Mettre en file la conversion FFmpeg sur le worker.

get_conversion_status

Interroger le statut et la progression de la tâche lorsqu'elle est prête.

get_media_info

Analyser le fichier téléversé pour durée, résolution, codecs et débit.

Cas d'usage

Assistants de chat IA

Un utilisateur demande à son assistant de convertir un MKV en MP4. L'agent liste les formats, crée une tâche, guide le téléversement et renvoie un lien de téléchargement une fois prêt.

Pipelines d'automatisation

Des scripts ou jobs CI créent des tâches de conversion, téléversent via des URLs signées et interrogent le statut sans navigateur - utile pour les workflows de préparation média.

Découverte de formats

Les agents appellent list_conversions et get_conversion_defaults avant de choisir le bon slug pour l'extension du fichier et l'appareil cible.

Intégrations éditeur et CMS

Créez des outils personnalisés qui confient le transcodage à Muxara tout en respectant les mêmes limites que le site public.

Flux de travail

Les octets du fichier ne transitent pas par les appels d'outils MCP. Le téléversement utilise une URL signée, comme sur le site.

  1. create_conversion_job - renvoie jobId et uploadUrl
  2. PUT du fichier vers uploadUrl (Content-Type: application/octet-stream)
  3. confirm_upload
  4. start_conversion (optionnellement update_conversion_job d'abord)
  5. get_conversion_status jusqu'à ce que le statut soit ready
  6. Télécharger l'URL dans la réponse de statut

Connexion

Utilisez le transport Streamable HTTP. Le point de terminaison est https://api.muxara.com/mcp.

Cursor

Ajoutez à votre config MCP (.cursor/mcp.json ou paramètres Cursor) :

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

MCP Inspector

Lancez l'inspecteur, choisissez Streamable HTTP et saisissez l'URL complète du point de terminaison :

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

Authentification

Le serveur MCP est public - aucune clé API, OAuth ou compte Muxara requis.

  • Pas de clé API ni d'inscription
  • Streamable HTTP sur api.muxara.com/mcp
  • Limites d'usage raisonnable applicables
  • Conversion et téléchargement gratuits

Questions fréquentes

Non. Le serveur MCP est public avec des limites d'usage raisonnable, comme le site. Aucun OAuth ni compte requis.

Non. create_conversion_job renvoie une uploadUrl signée. PUT du fichier directement vers cette URL (jusqu'à 500 Mo), puis appelez confirm_upload. Comme le téléverseur du navigateur.

Non. Conversion et téléchargement sont gratuits, comme sur muxara.com.