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 per Transloadit MCP-Server in Claude zu HLS-Adaptive-Streaming codieren

Was Ihr Agent tun kann

Die Tools verteilen sich auf vier Aufgaben. Die MCP-Server-Dokumentation listet jedes Tool mit den Berechtigungen auf, die es benötigt.

  • 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

Beim Erkunden und beim Prüfen mit dem Linter entstehen keine Assemblies. Ein Agent kann jeden Robot auflisten, bei den Robots, die ihm gefallen, die Parameter nachlesen und einen Entwurf validieren lassen, bevor er irgendetwas ausführt. 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`"
}

Der gehostete Endpunkt verlangt eine Anmeldung, bevor irgendein Tool läuft, auch für das Erkunden und das Prüfen mit dem Linter. Wenn Sie beides ohne Konto nutzen möchten, betreiben Sie den Server selbst. Das Auflisten Ihrer Templates und das Erstellen von Assemblies erfordern immer Zugangsdaten, auch auf einem selbst gehosteten Server.

Das Erstellen einer Assembly kann kostenpflichtige Verarbeitung anstoßen. transloadit_create_assembly ist als destruktiv gekennzeichnet, und ob Sie jeden Aufruf bestätigen müssen, hängt von Ihrem Client ab. Verlassen Sie sich nicht auf diese Bestätigung: Legen Sie die Berechtigungen und die Retry-Strategie des Agenten fest, bevor Sie ihn verbinden.

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

Wir empfehlen, den gehosteten Endpunkt in Ihrem Agenten-Client einzutragen:

https://api2.transloadit.com/mcp

Anschließend bestätigen Sie den Zugriff im Browser und wählen den Workspace, den der Agent nutzen darf. Sie müssen nichts installieren und keine Schlüssel kopieren.

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

Für CI und andere Clients, bei denen niemand im Browser bestätigen kann, oder wenn Sie den Server selbst betreiben möchten, lesen Sie den Abschnitt So verbinden Sie sich. Die MCP-Server-Dokumentation enthält außerdem die Konfiguration für jeden Client.

Was der MCP-Server nicht tut

  • Der Server orchestriert Transloadit. Er kann nichts tun, was unsere API und unsere Robots nicht unterstützen.
  • Encoding wird wie gewohnt berechnet. Begrenzen Sie Retries und Parallelität des Agenten, verbinden Sie nur den Workspace, den er benötigt, geben Sie jedem Auth Key, den Sie für ihn erstellen, nur eng gefasste Berechtigungen und überwachen Sie die Nutzung im Workspace. Weder die Authentifizierung noch die Bestätigungsabfrage eines Clients ist eine Kostenobergrenze.
  • Die Tools arbeiten mit Assemblies, Robots und Templates und können den verbundenen Workspace ermitteln. 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 Ihren Agenten zu verbinden, oder lesen Sie zuerst die MCP-Server-Dokumentation.