Transloadit via MCP

Ce que votre agent peut faire

Les outils se répartissent en quatre rôles. La documentation du serveur MCP répertorie chaque outil avec les autorisations dont il a besoin.

• Découvrir ce qui est possible. transloadit_list_robots renvoie le catalogue avec un résumé par Robot, et transloadit_get_robot_help renvoie les paramètres de l’un d’entre eux. L’agent n’a pas besoin d’avoir été entraîné sur notre documentation pour nous utiliser correctement.
• Vérifier son travail avant que cela ne coûte quoi que ce soit. transloadit_lint_assembly_instructions valide un ensemble d’Assembly Instructions sans créer d’Assembly, et renvoie des problèmes structurés plutôt que de la prose.
• Lancer le traitement. transloadit_create_assembly crée ou reprend une Assembly, en téléversant les fichiers et en attendant le résultat si vous le lui demandez.
• Le suivre jusqu’au bout. transloadit_get_assembly_status et transloadit_wait_for_assembly surveillent une Assembly en cours, et transloadit_list_templates réutilise les Templates dont vous disposez déjà.

L’agent peut explorer avant de dépenser

La découverte et le linting ne créent aucune Assembly. Un agent peut lister tous les Robots, lire les paramètres de ceux qui l’intéressent et faire valider un brouillon avant d’exécuter quoi que ce soit. Si vous lui demandez de passer au linter un Step comportant une erreur, il récupère cette erreur :

{
  "severity": "error",
  "path": "instructions",
  "message": "Path `steps.resized` has unrecognized keys: `widht`"
}

Le point de terminaison hébergé vous demande de vous connecter avant l’exécution de tout outil, découverte et linting compris. Pour les utiliser sans compte, exécutez le serveur vous-même. Lister vos Templates et créer des Assemblies nécessitent toujours des identifiants d’accès, y compris sur un serveur auto-hébergé.

Créer une Assembly peut déclencher un travail facturable. transloadit_create_assembly est signalé comme destructif, et c’est votre client qui détermine si une confirmation vous est demandée à chaque appel. Ne comptez pas sur cette confirmation : définissez les autorisations et la politique de nouvelles tentatives de l’agent avant de le connecter.

Pourquoi c’est mieux que de confier une clé d’API à un agent

Un agent face à une API REST doit déjà connaître la forme de ce qu’il manipule. Il devine un nom de paramètre, envoie la requête et découvre son erreur une fois que le traitement a échoué, ce qui coûte au mieux un aller-retour, et au pire des frais d’encodage.

Les Assembly Instructions sont du JSON déclaratif, le type d’artefact qu’un agent produit bien. Associer cela à la découverte et à un linter permet de boucler la boucle avant toute exécution : l’agent peut demander ce qui existe, écrire les Steps, les faire vérifier, et seulement ensuite créer l’Assembly. Le traitement lui-même s’effectue sur notre infrastructure : pas de FFmpeg à installer ni de disque local à remplir.

Connecter votre agent

Nous recommandons d’ajouter le point de terminaison hébergé à votre client d’agent :

https://api2.transloadit.com/mcp

Vous approuvez ensuite l’accès dans votre navigateur et choisissez le Workspace que l’agent peut utiliser. Il n’y a rien à installer ni aucune clé à copier.

Les clients qui recherchent des capacités peuvent lire la fiche lisible par machine à l’adresse /.well-known/mcp/server-card.json⁠, qui répertorie les outils et leurs schémas d’entrée.

Pour la CI et les autres clients où personne ne peut approuver dans un navigateur, ou pour exécuter le serveur vous-même, consultez Choisir le mode de connexion. La documentation du serveur MCP fournit aussi la configuration de chaque client.

Ce que le serveur ne fera pas

• Il orchestre Transloadit. Il ne peut rien faire que notre API et nos Robots ne prennent pas en charge.
• L’encodage est facturé comme d’habitude. Limitez les nouvelles tentatives de l’agent et le nombre d’opérations qu’il exécute simultanément, ne connectez que le Workspace dont il a besoin, restreignez au strict nécessaire la portée de toute Auth Key que vous créez pour lui, et surveillez l’utilisation du Workspace. Ni l’authentification ni l’invite de confirmation d’un client ne constituent un plafond de dépenses.
• Les outils manipulent les Assemblies, les Robots et les Templates, et peuvent identifier le Workspace connecté. L’administration du compte, la facturation et les identifiants d’accès restent délibérément en dehors du périmètre du serveur.
• Il ne remplace pas la lecture de la documentation des Robots lorsque c’est vous qui concevez le pipeline. C’est l’outil vers lequel se tourner lorsque c’est l’agent qui le conçoit.

Créez un Workspace gratuit pour connecter votre agent, ou lisez d’abord la documentation du serveur MCP.