KI-Agenten
KI-Coding-Agenten wie Claude Code, OpenAI Codex und Cursor können sich mit Transloadit verbinden und 96 aktuelle Robots nutzen, um Dateien hochzuladen, zu codieren und zu transformieren. Agenten können den MCP-Server für den Tool-Zugriff zur Laufzeit, wiederverwendbare Agent Skills für von Menschen gesteuerte Workflows und llms.txt als Dokumentationskontext kombinieren. Die CLI bietet einen separaten Automatisierungsweg für Menschen und CI.
Mit Ihrem Projekt beginnen
Fügen Sie diesen Prompt im Stammverzeichnis Ihres Projekts in Ihren Coding-Agenten ein. Er sorgt dafür, dass der Agent Ihren Stack prüft, bevor er ein SDK, MCP oder Skills auswählt, und dass die erste Änderung überprüfbar bleibt:
Set up the smallest safe Transloadit integration for this repository.
1. Inspect the project’s language, runtime, package manager, existing upload/media code, tests, and agent configuration before changing files.
2. Choose the narrowest integration that fits: an official SDK for application code, MCP for agent-executed runtime tools, the CLI (npx -y @transloadit/node) for scripts and CI jobs, and Agent Skills for repeatable workflow guidance. Reuse an existing integration when present.
3. Before editing, summarize what you found, which path you chose, and the files and commands you expect to change. Use the project’s existing package manager.
4. For interactive hosted MCP, add the hosted URL https://api2.transloadit.com/mcp to the client configuration without any token or key, and have the user approve browser OAuth. For CI or headless hosted MCP, mint an mcp-audience Bearer token at run time in a trusted environment, mint a new one when it expires, and supply it through secret storage or an environment variable.
5. Use TRANSLOADIT_KEY and TRANSLOADIT_SECRET only in a trusted server, CLI, CI, or self-hosted MCP process. When signing with an Auth Key, match its signature algorithm: for the Node CLI or self-hosted MCP, set TRANSLOADIT_SIGNATURE_ALGORITHM; in Node SDK code, pass the signatureAlgorithm option. Console keys with Smart CDN signing on (the default) use sha256; the Console’s snippet for the key shows the value.
6. Never expose TRANSLOADIT_SECRET to browser, mobile, or other client code. Give client code a public Auth Key and a Template ID; for production, generate the params and signature on a trusted backend with Signature Authentication. Use unsigned client params only with test credentials.
7. Never hardcode, print, commit, or overwrite credentials, including minted Bearer tokens. Keep secrets out of committed MCP configuration. If required credentials are unavailable, scaffold placeholders and stop before account operations.
8. Create one minimal, typed workflow and validate its Assembly Instructions. Prefer an existing small media fixture. Without an account, validate inline instructions locally with npx -y @transloadit/node assemblies lint --steps <file>. Linting against a Template ID needs credentials. Do not create an account, change a plan, or modify production Templates.
9. Run the repository’s checks. If authenticated Transloadit access (an approved hosted MCP connection or credentials in a trusted process) and a suitable fixture are available and the user has authorized a live test, run one Assembly, wait for completion, and report its Assembly ID, status, and result URL. Otherwise, report the exact command or MCP tool call the maintainer can run. Credentials or an approved connection alone do not authorize a live run.
10. Summarize every changed file, verification result, and any remaining manual step.
Das erwartete Ergebnis ist eine kleine Änderung im Repository, nicht bloß ein generiertes Codebeispiel. Prüfen Sie die vom Agenten vorgeschlagene Abgrenzung der Zugangsdaten, bevor Sie eine Assembly im Live-Betrieb zulassen.
Was der Agent auswählen sollte
| Projektmerkmal | Ausgangspunkt |
|---|---|
| Node.js-, Python-, Ruby-, PHP-, Go-, Java-, Android- oder iOS-Anwendung | Das passende offizielle SDK |
| Agent soll Instructions linten, Dokumentation einsehen oder Assemblies ausführen | MCP-Server |
| Build-Skripte, CI-Jobs, Shell-Pipelines oder Linting ohne Konto | CLI |
| Team möchte einen wiederverwendbaren, versionskontrollierten Workflow | Agent Skills |
| Noch keine Laufzeitintegration erforderlich | llms.txt und Markdown-Dokumentationsseiten |
MCP-Server
Das Model Context Protocol (MCP) gibt Agenten zur Laufzeit direkten Zugriff auf Transloadit-Tools.

Es gibt drei Verbindungswege. Wählen Sie den ersten, der zu Ihrem Client passt:
| Client | Verbinden mit | Zugangsdaten |
|---|---|---|
| Interaktiver Agent-Client wie Claude, ChatGPT, Codex oder Cursor | Gehostete URL | OAuth-Freigabe im Browser |
| CI-Job oder Headless-Agent-Laufzeitumgebung | Gehostete URL mit einem Bearer-Token | Token, das aus einem Auth Key erzeugt wird |
| Agent, der den Server selbst ausführen soll | Self-Hosted über stdio | Keine für Dokumentation und Linting; Auth Key für Assemblies |
Per URL verbinden
Fügen Sie die gehostete MCP-URL zu Ihrem MCP-Client hinzu:
https://api2.transloadit.com/mcp
Genehmigen Sie den OAuth-Zugriff in Ihrem Browser und wählen Sie den Workspace, den der Client verwenden darf. Sie müssen weder einen lokalen Server installieren noch einen Auth Key oder ein Secret kopieren. Mit der Genehmigung wird ein eigener Auth Key für die App erstellt, der auf die angezeigten Berechtigungen beschränkt ist; den Zugriff widerrufen Sie unter Verbundene Apps.
Der gehostete Server verlangt eine Anmeldung, bevor ein Tool ausgeführt wird, auch für Robot-Dokumentation und Linting. Um diese ohne Konto zu nutzen, betreiben Sie den Server selbst gehostet.
CI und Headless-Clients
Wo niemand den Zugriff im Browser genehmigen kann, senden Sie ein Token mit der Audience
mcp als Authorization: Bearer <token> an den gehosteten Endpunkt.
Erzeugen Sie es in einer vertrauenswürdigen Umgebung, die über einen Auth Key und ein Secret verfügt
(TRANSLOADIT_KEY und TRANSLOADIT_SECRET für die CLI):
npx -y @transloadit/node auth token --aud mcp
Der Befehl gibt JSON aus. Übernehmen Sie nur den Wert access_token und übergeben
Sie ihn über einen Secret-Speicher oder eine Umgebungsvariable an die Agent-Laufzeitumgebung; geben
Sie die Antwort nicht in Logs oder im Transkript des Agenten aus.
- Ablauf: Tokens laufen nach dem zurückgegebenen Intervall
expires_inab (bei MCP standardmäßig nach einer Woche). Erzeugen Sie eines pro Job oder Sitzung und erzeugen Sie ein neues, wenn die Arbeit länger dauert als dieses Intervall. - Scope: Verwenden Sie
--scope, um den Zugriff einzuschränken; andernfalls erbt das Token die Scopes vom Auth Key. - Widerruf: Löschen Sie den Auth Key, aus dem ein Token erzeugt wurde, um den Zugriff zu sperren, bevor das Token abläuft. Verwenden Sie für CI einen eigenen Auth Key.
Beispiele für die Client-Konfiguration finden Sie unter CI und Headless-Clients.
Self-Hosted über stdio
Konfigurieren Sie den Server in Ihrem MCP-Client als stdio-Befehl; die meisten Clients starten ihn für Sie. Robot-Dokumentation und Linting funktionieren ohne Konto:
npx -y @transloadit/mcp-server stdio
Für Kontovorgänge wie das Erstellen von Assemblies übergeben Sie TRANSLOADIT_KEY und
TRANSLOADIT_SECRET über die Umgebung des Serverprozesses und setzen
TRANSLOADIT_SIGNATURE_ALGORITHM passend zum Auth Key. Schlüssel, die in der Console mit aktivierter
Smart-CDN-Signierung (Standard) erstellt wurden, verwenden sha256, während
der Server standardmäßig sha384 verwendet; welcher Wert zu setzen ist, zeigt
das Snippet der Console für den Schlüssel. Siehe
Konfiguration des Signaturalgorithmus.
Der stdio-Prozess hält diese Zugangsdaten auf dem Rechner des Agenten vor. Verwenden Sie daher einen eigenen Auth Key, der nur die benötigten Scopes hat, und halten Sie Zugangsdaten aus MCP-Konfigurationsdateien heraus, die ins Repository committet werden.
Beispiele für die Client-Konfiguration (Claude, Cursor, VS Code/Copilot), Details zur Authentifizierung, Tool-Dokumentation, Limits und die Unterschiede zwischen gehostetem und selbst gehostetem Betrieb finden Sie in der Dokumentation zum MCP Server.
Automatisierungswege
Die Agent-Tools von Transloadit kombinieren Ausführungswerkzeuge mit Workflow-Anleitungen und Dokumentationskontext. CLI und MCP führen Workflows aus; Agent Skills und llms.txt helfen Agenten, diese Tools zu nutzen:
- CLI: Verwenden Sie
@transloadit/node, wenn ein Mensch oder ein CI-Job einen wiederholbaren Befehl benötigt, um eine Assembly zu erstellen, auf ihren Abschluss zu warten und die Ergebnisse abzurufen. - MCP: Stellen Sie Transloadit-Tools für eingebettete oder gehostete Agenten bereit. Der Agent
kann Robot-Dokumentation einsehen, Assembly Instructions linten, Assemblies erstellen und
Statusaktualisierungen verfolgen. Für Dateien, die direkt an
transloadit_create_assemblyübergeben werden, verwenden Sie öffentliche URLs, kleine Inline-Dateien oder Anhänge, die der Client weiterreicht. Das Hochladen lokaler Dateien oder Sandbox-Dateien über den zurückgegebenen Upload-Befehl erfordert eine Shell; siehe unterstützte Eingaben. - Agent Skills: Bewahren Sie teamspezifische Playbooks für Medien-Workflows in der Versionskontrolle auf, und zwar für Agenten, die bereits über nützliche Tools verfügen, etwa Terminalzugriff, MCP, die CLI oder SDKs. Skills geben dem Agenten vor, welche Templates, Prüfschritte und Fallbacks er verwenden soll, verleihen aber selbst keine neuen Fähigkeiten.
- llms.txt: Geben Sie jedem LLM eine aktuelle Übersicht über Transloadit-Produkte, Lösungen, Integrationen, Entwicklerressourcen und Lerninhalte, bevor es eine Assembly vorschlägt.
Nutzen Sie gehostetes MCP mit OAuth im Browser, wenn eine Person einen interaktiven Agent-Client
verbindet. Für unbeaufsichtigte Automatisierung bewahren Sie Zugangsdaten in einer
vertrauenswürdigen Umgebung auf: Senden Sie ein Bearer-Token mit der Audience
mcp an das gehostete MCP oder übergeben Sie einen Auth Key und ein Secret
an selbst gehostetes stdio, die CLI oder Ihr eigenes Backend.
Agent Skills
Agent Skills sind Markdown-Dateien (SKILL.md),
die Agenten Schritt für Schritt beibringen, wie sie Aufgaben erledigen.

Praktisch betrachtet ist ein MCP-Server eine API-Schnittstelle, die ein Agent zur Laufzeit aufrufen kann (über einen lokalen oder gehosteten MCP-Prozess), während Skills versionskontrollierte Playbooks sind, die einem Agenten sagen, was er tun soll, in welcher Reihenfolge und wie er das Ergebnis überprüft. Skills fügen selbst keinen neuen Tool-Zugriff hinzu. Sie legen fest, wie der Agent die Tools, die in Ihrer Umgebung verfügbar sind (MCP, CLI, SDKs), einheitlich nutzen soll.
- Nutzen Sie MCP für eingebettete, wiederholbare Ausführung (Erstellen von Assemblies, Polling, Ergebnisse).
- Nutzen Sie Skills als wiederverwendbare, von Menschen gesteuerte Playbooks für Aufgaben wie Einrichtung, Scaffolding, Templates und Migrationen.
Beide ergänzen sich zudem. Ein Skill kann einen Workflow standardisieren und den Agenten dann anweisen, für die eigentliche Ausführung MCP (oder ersatzweise eine lokale CLI) zu verwenden.
Mit der Skills-CLI installieren
npx skills add transloadit/skills
Damit werden alle 19 Transloadit-Skills in Ihrem Projekt installiert:
- docs-transloadit-robots
Offline-Nachschlagewerk für Transloadit Robots sowie deren Parameterdokumentation und Beispiele über die
transloadit-CLI. Damit können Siesteps-JSON entwerfen oder validieren, ohne Robot-Namen oder -Parameter erraten zu müssen. - integrate-asset-delivery-with-transloadit-smartcdn-in-nextjs
Serverseitige URL-Signierung mit Transloadit Smart CDN für eine explizit konfigurierte Datei zu einem Next.js-App-Router-Projekt hinzufügen.
- integrate-uppy-transloadit-s3-uploading-to-nextjs
Uppy Dashboard und Transloadit-Uploads zu einer Next.js-App mit App Router hinzufügen, einschließlich serverseitiger Signaturgenerierung und optionalem Export über /s3/store.
- transform-build-mosaic-collage-with-transloadit
Einmalige Erstellung einer bündig ausgerichteten Mosaik-Fotocollage (N lokale Bilder -> ein einzelnes Bild) mit der offiziellen CLI
@transloadit/node. Dabei wird der Effektmosaicim Robot/image/mergeverwendet, um ein bündig ausgerichtetes Kachellayout mit mittig zugeschnittenen Fotos zu erstellen. Das Ergebnis wird mit--outputunter einem explizit angegebenen Ausgabepfad heruntergeladen. - transform-build-polaroid-collage-with-transloadit
Einmalige Erstellung einer Fotocollage im Polaroid-Stapelstil (N lokale Bilder -> ein einzelnes Bild) mit der offiziellen CLI
@transloadit/node. Dabei wird der Effektpolaroid-stackim Robot/image/mergeverwendet. Das Ergebnis wird mit--outputunter einem explizit angegebenen Ausgabepfad heruntergeladen. - transform-caption-video-with-transloadit
Einfache Untertitel mit Audiohinweisen in ein lokales Video einbrennen und das untertitelte Video samt SRT-Untertiteleinträgen herunterladen, mit dem Builtin caption-video und der offiziellen Transloadit-CLI.
- transform-capture-webpage-with-transloadit
Eine öffentliche Webseite oder lokales HTML mit dem Builtin capture-webpage und der offiziellen Transloadit-CLI als Bild oder PDF erfassen.
- transform-convert-markdown-to-pdf-with-transloadit
Ein lokales Office-Dokument oder eine lokale HTML-, Markdown- oder Textdatei mit dem Builtin convert-to-pdf und der offiziellen Transloadit-CLI in PDF konvertieren. Umfasst den bestehenden Workflow zur Konvertierung von Markdown in PDF.
- transform-describe-image-with-transloadit
Einmalige Bildbeschreibung mit der offiziellen CLI
@transloadit/node. Verwenden Sieimage describe --fields labelsfür objektbezogene Labels oderimage describe --for wordpressfür strukturiertes JSON mit Alt-Text, Titel, Bildunterschrift und Beschreibung. - transform-encode-hls-video-with-transloadit
Einmaliges HLS-Encoding mit Transloadit über die CLI
transloadit(lokales Video -> HLS-Varianten und Playlist). Verwenden Sie bevorzugt Builtin Templates (builtin/encode-hls-video@latest) und laden Sie die Ausgaben über-olokal herunter. - transform-encode-video-with-transloadit
Ein lokales Video mit dem Builtin encode-video und der offiziellen Transloadit-CLI für die Webwiedergabe als MP4 oder WebM codieren.
- transform-extract-text-with-transloadit
Lesbaren Text oder JSON mit dem Builtin extract-text und der offiziellen Transloadit-CLI aus lokalen PDFs, Scans, Fotos und Office-Dokumenten extrahieren.
- transform-generate-image-with-transloadit
Einmalige Bildgenerierung mit Transloadit über die CLI
transloadit(Prompt -> Bilddatei). Verwenden Sie bevorzugtimage generatefür rein textbasierte und eingabegesteuerte Generierung und nutzen Sie--output, wenn Sie einen deterministischen Pfad benötigen. - transform-make-video-covers-with-transloadit
Coverbilder aus einem lokalen Video erstellen: aus Einzelbildern in regelmäßigen Abständen, an exakten Zeitpositionen oder per intelligenter Auswahl mit dem Builtin video-covers und der offiziellen Transloadit-CLI.
- transform-prepare-image-with-transloadit
Lokale Bilder mit Ausrichtungskorrektur, Größenänderung, Komprimierung und Formatkonvertierung für eine Website vorbereiten, mit dem Builtin prepare-image und der offiziellen Transloadit-CLI.
- transform-remove-background-with-transloadit
Den Hintergrund eines lokalen Fotos entfernen und ein transparentes PNG herunterladen, mit dem Builtin remove-background und der offiziellen Transloadit-CLI.
- transform-transcribe-audio-with-transloadit
Lokale Audio- oder Videodateien mit dem Builtin transcribe und der offiziellen Transloadit-CLI in Text, JSON mit Zeitstempeln, SRT oder WebVTT transkribieren.
- transform-upscale-image-with-transloadit
Einmalige KI-gestützte Bildvergrößerung mit Transloadit über die CLI
transloadit(lokales Bild -> hochskaliertes Bild). Verwenden Sie bevorzugt den Intentimage upscaleund nutzen Sie--outputfür einen deterministischen Pfad. - transloadit
Zentraler Einstiegs-Skill für Transloadit. Leiten Sie an den passenden Skill (
integrate-*,transform-*oderdocs-*) weiter und führen Sie die gewählte Operation für deterministisches Verhalten bevorzugt übernpx -y @transloadit/node ...(CLI) aus.
Automatische Erkennung
Der Skills-Katalog ist außerdem unter transloadit.com/.well-known/skills/index.json auffindbar, entsprechend dem Agent Skills Discovery RFC. Sie können daher auch so installieren:
npx skills add https://transloadit.com
Manuelle Installation
Klonen Sie das Repository transloadit/skills in das Skills-Verzeichnis Ihres Agenten oder legen Sie dort einen Symlink darauf an:
| Agent | Pfad |
|---|---|
| Claude Code | .claude/skills/ |
| OpenAI Codex | .codex/skills/ |
| Gemini CLI | .gemini/skills/ |
| Cursor | .cursor/skills/ |
| Windsurf | .codeium/windsurf/skills/ |
llms.txt
Transloadit veröffentlicht die Datei llms.txt: einen kompakten, websiteweiten Routing-Index gemäß dem llms.txt-Standard. Sie umfasst Produkte und Services, Lösungen, Integrationen, Medien- und Aufgabenindizes, Entwickler- und Lernressourcen sowie Support.
Um Robot-spezifische Inhalte aufzufinden, verwenden Sie
/docs/robots/llms.txt. Die Legacy-Kompatibilitätsdatei
llms-full.txt enthält vollständige Robot-Parameter-Schemas inline,
ist aber groß. Verwenden Sie für das Auffinden bevorzugt llms.txt und rufen
Sie nur die verlinkten Markdown-Seiten ab, die für die Aufgabe relevant sind.
Welchen Ansatz sollte ich verwenden?
| Ansatz | Ideal für | Einrichtung |
|---|---|---|
| Gehostetes MCP mit OAuth | Interaktive Agent-Clients | URL hinzufügen und Zugriff im Browser genehmigen |
| Gehostetes MCP mit einem Bearer-Token | CI- und Headless-Agent-Clients | Token in einer vertrauenswürdigen Umgebung erzeugen |
| Selbst gehostetes MCP (stdio) | Lokalen Serverbetrieb, Dokumentation und Linting ohne Konto | stdio im MCP-Client konfigurieren; Schlüssel für Kontovorgänge bereitstellen |
| Offizielles SDK | Anwendungscode | Passendes SDK installieren; Auth Secret auf dem Server belassen |
| CLI | Skripte, CI-Jobs und Linting ohne Konto | npx -y @transloadit/node ausführen; Zugangsdaten für Kontovorgänge bereitstellen |
| Agent Skills | Wiederverwendbare, von Menschen gesteuerte Transloadit-Workflows | Mit einem Befehl installieren |
| llms.txt | Breiten Dokumentationskontext zu Transloadit für jedes LLM | URL abrufen |
Diese Ansätze ergänzen sich. Beginnen Sie für interaktiven Tool-Zugriff mit gehostetem MCP und OAuth im Browser. Für unbeaufsichtigte Agent-Tools senden Sie ein Bearer-Token an gehostetes MCP oder übergeben einen Auth Key und ein Secret an selbst gehostetes stdio. Verwenden Sie ein offizielles SDK für Anwendungscode oder die CLI für Skripte und CI-Jobs. Installieren Sie Skills für Workflow-Anleitungen und verweisen Sie Ihr LLM für Dokumentationskontext auf llms.txt.