Transloadit

Transloadit per MCP

Wir betreiben einen Model-Context-Protocol-Server, sodass ein Agent Videos codieren, Bilder skalieren, Dokumente konvertieren und die Ergebnisse wieder auslesen kann. Der Server läuft auf derselben Plattform, auf der auch unsere API läuft, und der Agent erarbeitet die Pipeline selbst.

Demo: Videos mit dem Transloadit-MCP-Server in Claude für HLS Adaptive Streaming codieren

Was Ihr Agent tun kann

Nach dem Verbinden stehen Ihrem Agenten sieben Tools zur Verfügung, die sich auf vier Aufgaben verteilen:

  • Herausfinden, was möglich ist. transloadit_list_robots liefert den Katalog mit einer Zusammenfassung pro Robot, und transloadit_get_robot_help liefert die Parameter für einen davon. Der Agent muss nicht mit unserer Dokumentation trainiert worden sein, um uns richtig zu nutzen.
  • Die eigene Arbeit prüfen, bevor sie Geld kostet. transloadit_lint_assembly_instructions validiert Assembly Instructions, ohne eine Assembly zu erstellen, und liefert strukturierte Meldungen statt Freitext.
  • Den Job ausführen. transloadit_create_assembly erstellt eine Assembly oder setzt eine bestehende fort. Auf Wunsch lädt das Tool dabei Dateien hoch und wartet auf das Ergebnis.
  • Bis zum Ende verfolgen. transloadit_get_assembly_status und transloadit_wait_for_assembly überwachen eine laufende Assembly, und mit transloadit_list_templates lassen sich Ihre vorhandenen Templates wiederverwenden.

Der Agent kann erkunden, bevor er Geld ausgeben kann

Der Katalog und der Linter benötigen keine Zugangsdaten. Ein Agent kann jeden Robot auflisten, bei den Robots, die ihm gefallen, die Parameter nachlesen und einen Entwurf validieren lassen, und das alles, bevor überhaupt ein Konto existiert. Wenn Sie den Agenten einen fehlerhaften Step mit dem Linter prüfen lassen, bekommt er genau diesen Fehler zurück:

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

Alles, was ein Konto betrifft, ist eine andere Sache. Das Auflisten Ihrer Templates oder das Erstellen einer Assembly ohne Zugangsdaten liefert mcp_missing_auth, keine Vermutung und kein Teilergebnis. Sobald ein Agent autorisiert ist, kann er kostenpflichtige Verarbeitung anstoßen, ohne dass jede Assembly einzeln bestätigt werden muss. Legen Sie seine Berechtigungen und seine Retry-Strategie fest, bevor Sie ihm Zugangsdaten geben.

Warum das besser ist als ein API-Schlüssel für den Agenten

Ein Agent, der direkt mit einer REST-API arbeitet, muss deren Aufbau bereits kennen. Er rät einen Parameternamen, sendet die Anfrage und merkt erst nach dem fehlgeschlagenen Job, dass er falsch lag. Das kostet bestenfalls einen Roundtrip und schlimmstenfalls eine Encoding-Gebühr.

Assembly Instructions sind deklaratives JSON und damit eine Art von Artefakt, die ein Agent gut erzeugt. Zusammen mit der Erkundung und einem Linter schließt sich der Kreis, bevor irgendetwas ausgeführt wird: Der Agent kann fragen, was es gibt, die Steps schreiben, sie prüfen lassen und erst dann die Assembly erstellen. Die Verarbeitung selbst läuft auf unserer Infrastruktur. Sie müssen also kein FFmpeg installieren, und keine lokale Festplatte läuft voll.

Verbindung herstellen

Am schnellsten geht es über den gehosteten Endpunkt:

https://api2.transloadit.com/mcp

Clients, die nach Fähigkeiten suchen, können die maschinenlesbare Server Card unter /.well-known/mcp/server-card.json lesen. Sie listet die Tools und deren Eingabeschemas auf.

Sobald Sie über das Ausprobieren hinaus sind, ist der Eigenbetrieb über stdio meist die bessere Wahl, denn dann verwaltet der Prozess Ihre Werte TRANSLOADIT_KEY und TRANSLOADIT_SECRET und übernimmt die Authentifizierung für Sie. Die MCP-Server-Dokumentation beschreibt beide Setups, inklusive der Client-Konfigurationsbeispiele.

Was der MCP-Server nicht tut

  • Der Server orchestriert Transloadit. Er kann Ihre Dateien nicht mit beliebigem Code bearbeiten, und er kann nichts tun, was nicht auch die API könnte.
  • Encoding wird wie gewohnt berechnet. Begrenzen Sie Retries und Parallelität des Agenten, verwenden Sie eng gefasste Zugangsdaten und überwachen Sie die Nutzung im Workspace. Authentifizierung ist keine Kostenobergrenze.
  • Die Tools decken Assemblies, Robots und Templates ab. Kontoverwaltung, Abrechnung und Zugangsdaten bleiben bewusst außen vor.
  • Der Server ersetzt nicht das Lesen der Robot-Dokumentation, wenn Sie selbst die Pipeline entwerfen. Er ist die richtige Wahl, wenn der Agent das übernimmt.

Erstellen Sie einen kostenlosen Workspace, um die Zugangsdaten zu erhalten, oder lesen Sie zuerst die MCP-Server-Dokumentation.