# Transloadit über MCP
Wir betreiben einen Model-Context-Protocol-Server, sodass ein Agent Videos codieren, Bilder skalieren, Dokumente konvertieren und die Ergebnisse zurücklesen kann. Er läuft auf derselben Plattform, die auch hinter unserer API steht, und der Agent erarbeitet die Pipeline selbst.
## 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:
```json
{
"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](https://api2.transloadit.com/.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](/de/docs/sdks/mcp-server.md) 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](/de/docs/robots.md), wenn Sie selbst die Pipeline entwerfen. Sie nutzen ihn, wenn der Agent das übernimmt.
[Erstellen Sie einen kostenlosen Workspace](/c/signup/), um die Zugangsdaten zu erhalten, oder lesen Sie zuerst die[MCP-Server-Dokumentation](/de/docs/sdks/mcp-server.md).