Transloadit über MCP

Was Ihr Agent tun kann

Durch die Verbindung erhält er sieben Tools, die sich vier Aufgaben zuordnen lassen:

• 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 korrekt zu verwenden.
• Die eigene Arbeit prüfen, bevor sie etwas kostet. transloadit_lint_assembly_instructions validiert einen Satz Assembly Instructions, ohne eine Assembly zu erstellen, und liefert strukturierte Meldungen statt Fließtext zurück.
• Den Job ausführen. transloadit_create_assembly erstellt eine Assembly oder setzt sie fort, lädt dabei Dateien hoch und wartet auf Wunsch auf das Ergebnis.
• Ihn bis zum Ende verfolgen. transloadit_get_assembly_status und transloadit_wait_for_assembly verfolgen eine laufende Assembly, und transloadit_list_templates nutzt erneut die Templates, die Sie bereits haben.

Der Agent kann erkunden, bevor er Geld ausgeben kann

Für den Katalog und den Linter sind keine Zugangsdaten nötig. Ein Agent kann jeden Robot auflisten, für die Robots seiner Wahl die Parameter lesen und einen Entwurf validieren lassen, alles noch bevor ein Konto existiert. Wenn Sie ihn bitten, einen Step mit einem Fehler zu linten, erhält er den 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 zurück, keine Vermutung und kein Teilergebnis. So bleibt das Erkunden kostenlos, und Geld wird nur bewusst ausgegeben.

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

Ein Agent, der eine REST-API direkt verwendet, muss deren Aufbau bereits kennen. Er rät einen Parameternamen, sendet die Anfrage und stellt erst fest, dass er falsch lag, nachdem der Job fehlgeschlagen ist – das kostet im besten Fall einen Roundtrip, im schlimmsten Fall eine Encoding-Gebühr.

Assembly Instructions sind deklaratives JSON, also genau die Art von Artefakt, die ein Agent gut erzeugt. Kombiniert man das mit der Erkundung und einem Linter, schließt sich der Kreis, bevor etwas läuft: Der Agent kann fragen, was existiert, die Steps schreiben, sie prüfen lassen und erst dann die Assembly erstellen. Die eigentliche Verarbeitung läuft auf unserer Infrastruktur, sodass kein FFmpeg installiert und keine lokale Festplatte gefüllt werden muss.

Verbindung herstellen

Der schnellste Weg ist der gehostete 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, die die Tools und ihre Eingabeschemas auflistet.

Ihn selbst über stdio auszuführen ist meist die bessere Option, sobald Sie über das erste Ausprobieren hinaus sind, denn der Prozess hält dann Ihren TRANSLOADIT_KEY und Ihr TRANSLOADIT_SECRET und übernimmt die Authentifizierung für Sie. Die MCP-Server-Dokumentation enthält beide Setups, einschließlich der Client-Konfigurationsbeispiele.

Was der MCP-Server nicht tun wird

• Der Server orchestriert Transloadit. Er kann Ihre Dateien nicht mit beliebigem Code verarbeiten und kann nichts tun, was die API nicht auch könnte.
• Encoding wird wie üblich berechnet. Ein Agent, der eine fehlgeschlagene Assembly in einer Schleife erneut ausführt, gibt echtes Geld aus. Geben Sie ihm daher einen Workspace, dessen Limits Sie für angemessen halten.
• Die Tools decken Assemblies, Robots und Templates ab. Kontoverwaltung, Abrechnung und Zugangsdaten bleiben bewusst außen vor.
• Er ersetzt nicht das Lesen der Robot-Dokumentation, wenn Sie selbst die Pipeline entwerfen. Sie nutzen ihn, wenn der Agent das übernimmt.

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