# KI-Agenten

KI-Coding-Agenten wie Claude Code, OpenAI Codex und Cursor können sich mit Transloadit verbinden und alle 88 Robots nutzen, um Dateien hochzuladen, zu codieren und zu transformieren. Es gibt drei Integrationsmöglichkeiten: den MCP-Server für den Laufzeitzugriff auf Tools, Agent Skills für wiederholbare Workflows und llms.txt als Dokumentationskontext.

## MCP-Server

Das [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) ermöglicht Agenten direkten Laufzeitzugriff auf Transloadit-Tools.

![Demo: Videos über den Transloadit-MCP-Server in Claude für adaptives HLS-Streaming codieren](/_next/static/media/mcp-demo.0_tw8arokc4ks.gif?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL)

Für die meisten Teams ist selbst gehostetes MCP über stdio der schnellste direkte Weg:

![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL)

```bash
TRANSLOADIT_KEY=MY_AUTH_KEY TRANSLOADIT_SECRET=MY_SECRET_KEY npx -y @transloadit/mcp-server stdio

```

Wenn Sie `npx` in Ihrer Umgebung nicht ausführen können, verwenden Sie den gehosteten Endpunkt`https://api2.transloadit.com/mcp` mit `Authorization: Bearer <token>`.

Generieren Sie das Token in einer anderen vertrauenswürdigen Umgebung, beispielsweise in Ihrem Backend, in CI oder in einer lokalen Shell, und übergeben Sie es anschließend an die Laufzeitumgebung Ihres Agenten:

![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL)

```bash
npx -y @transloadit/node auth token --aud mcp

```

Sie können Tokens auch über [POST /token](/de/docs/api/token-post.md) oder das[Node.js SDK](/de/docs/sdks/node-sdk.md) erstellen.

Konfigurationsbeispiele für Clients (Claude, Cursor, VS Code/Copilot), Authentifizierungsdetails, Tool-Dokumentation, Limits sowie Informationen zum gehosteten und selbst gehosteten Betrieb finden Sie auf der [MCP-Server-SDK-Seite](/de/docs/sdks/mcp-server.md).

## Automatisierungswege

Die Agent-Tools von Transloadit sind nicht nur für chatbasierte Coding-Agenten nützlich. Sie bieten Teams mehrere praktische Möglichkeiten, denselben Medien-Workflow über lokale Skripte, CI-Jobs, Betriebskonsolen und autonome Agenten auszuführen:

* **CLI:** Verwenden Sie `@transloadit/node`, wenn eine Person oder ein CI-Job einen wiederholbaren Befehl benötigt, um eine Assembly zu erstellen, auf deren Abschluss zu warten und Ergebnisse abzurufen.
* **MCP:** Stellen Sie eingebetteten oder gehosteten Agenten, die keinen Shell-Zugriff erhalten sollen, eine klar begrenzte Auswahl an Transloadit-Tools bereit. Der Agent kann die Robot-Dokumentation prüfen, Assembly Instructions validieren, Assemblies erstellen und Statusaktualisierungen über den MCP-Server verfolgen.
* **Agent Skills:** Verwalten Sie teamspezifische Anleitungen für Medien-Workflows in der Versionskontrolle, wenn Agenten bereits über geeignete Tools wie Terminalzugriff, MCP, die CLI oder SDKs verfügen. Skills teilen dem Agenten mit, welche Templates, Prüfschritte und Ausweichoptionen er verwenden soll, gewähren jedoch selbst keine neuen Funktionen.
* **llms.txt:** Stellen Sie jedem LLM eine aktuelle Übersicht über Transloadit-Robots, Parameter und Dokumentation bereit, bevor es eine Assembly vorschlägt.

Bewahren Sie Zugangsdaten für die Produktionsautomatisierung in Ihrer vertrauenswürdigen Umgebung auf und lassen Sie Agenten einen selbst gehosteten MCP-Server oder Ihr eigenes Backend aufrufen. Gehostetes MCP ist praktisch, wenn die Laufzeitumgebung des Agenten keine lokalen Prozesse starten kann. Die CLI bleibt hingegen die einfachste Option für deterministische Jobs in CI.

## Agent Skills

[Agent Skills](https://agentskills.io/) sind Markdown-Dateien (`SKILL.md`), die Agenten Schritt für Schritt zeigen, wie sie Aufgaben erledigen.

![Demo: Videos mit Transloadit Agent Skills in Claude für adaptives HLS-Streaming codieren](/_next/static/media/skills-demo.17qq6b.p2vo_b.gif?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL) Praktisch betrachtet ist ein MCP-Server eine API-Oberfläche, die ein Agent zur Laufzeit über einen lokalen oder gehosteten MCP-Prozess aufrufen kann. Skills sind dagegen versionskontrollierte Anleitungen, die einem Agenten mitteilen, was er in welcher Reihenfolge tun und wie er das Ergebnis prüfen soll. Skills bieten selbst keinen Zugriff auf neue Tools. Sie legen einheitlich fest, wie der Agent die in Ihrer Umgebung verfügbaren Tools (MCP, CLI, SDKs) verwenden soll.

* Verwenden Sie **MCP** für eingebettete, wiederholbare Ausführungen (Uploads, Assemblies, Polling, Ergebnisse).
* Verwenden Sie **Skills** für einmalige, von Menschen gesteuerte Aufgaben (Einrichtung, Grundgerüste, Vorlagen, Migrationen).

Beide Ansätze ergänzen sich außerdem. Ein Skill kann einen Workflow standardisieren und den Agenten anschließend anweisen, MCP oder ersatzweise eine lokale CLI für die eigentliche Ausführung zu verwenden.

### Mit der Skills CLI installieren

![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL)

```bash
npx skills add transloadit/skills

```

Dadurch werden alle 7 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 Sie `steps`-JSON entwerfen oder validieren, ohne Robot-Namen oder -Parameter erraten zu müssen.
* **integrate-asset-delivery-with-transloadit-smartcdn-in-nextjs**: URL-Signierung mit Transloadit Smart CDN zu einem Next.js-App-Router-Projekt hinzufügen (serverseitige Signierungsroute und optionale Client-Demoseite).
* **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-encode-hls-video-with-transloadit**: Einmaliges HLS-Encoding mit Transloadit über die `transloadit`-CLI (lokales Video -> HLS-Varianten und Playlist). Verwenden Sie bevorzugt Builtin Templates (`builtin/encode-hls-video@latest`) und laden Sie die Ausgaben über `-o` lokal herunter.
* **transform-generate-image-with-transloadit**: Einmalige Bildgenerierung mit Transloadit über die `transloadit`-CLI (Prompt -> Bilddatei). Verwenden Sie bevorzugt Builtin Templates (`builtin/generate-image@latest`) und laden Sie die Ausgaben über `-o` lokal herunter.
* **transform-remove-background-with-transloadit**: Einmaliges Entfernen des Hintergrunds mit Transloadit über die `transloadit`-CLI (lokales Bild -> transparentes PNG). Verwenden Sie ein minimales `steps`-JSON für `/image/bgremove` und laden Sie das Ergebnis über `-o` unter einem expliziten `.png`-Pfad herunter.
* **transloadit**: Zentrale Einstiegsfunktion für Transloadit. Wählen Sie die passende `integrate-*`-, `transform-*`- oder `docs-*`-Funktion und führen Sie sie für deterministisches Verhalten bevorzugt über `npx -y @transloadit/node ...` (CLI) aus.

### Automatische Erkennung

Der Skills-Katalog kann gemäß dem[Agent Skills Discovery RFC](https://agentskills.io/specification) auch unter[transloadit.com/.well-known/skills/index.json](/.well-known/skills/index.json) automatisch erkannt werden. Daher können Sie ihn auch wie folgt installieren:

![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL)

```bash
npx skills add https://transloadit.com

```

### Manuelle Installation

Klonen oder verknüpfen Sie das Repository [transloadit/skills](https://github.com/transloadit/skills) per Symlink mit dem Skills-Verzeichnis Ihres Agenten:

|Agent|Speicherort|
|-|-|
|Claude Code|.claude/skills/|
|OpenAI Codex|.codex/skills/|
|Gemini CLI|.gemini/skills/|
|Cursor|.cursor/skills/|
|Windsurf|.codeium/windsurf/skills/|

## llms.txt

Transloadit veröffentlicht eine [llms.txt](/llms.txt)-Datei, einen strukturierten Index der gesamten Robot-Dokumentation gemäß dem [llms.txt-Standard](https://llmstxt.org/). Agenten und LLMs können diese Datei abrufen, um eine aktuelle Übersicht über jeden Robot, seine Parameter und Links zur vollständigen Dokumentation zu erhalten.

Unter [llms-full.txt](/llms-full.txt) ist eine ausführliche Variante verfügbar. Sie enthält die vollständige Robot-Dokumentation direkt, statt nur darauf zu verlinken.

## Welchen Ansatz sollte ich verwenden?

|Ansatz|Am besten geeignet für|Einrichtungszeit|
|-|-|-|
|**Gehostetes MCP**|Produktions-Workflows für Agenten, Teamkonfigurationen|2 Minuten|
|**Selbst gehostetes MCP**|Isolierte Umgebungen, lokale Entwicklung|5 Minuten|
|**Agent Skills**|Vermittlung bewährter Transloadit-Verfahren und -Muster an Agenten|2 Minuten|
|**llms.txt**|Bereitstellung von Kontext zu Transloadit-Robots für beliebige LLMs|Keine (nur die URL abrufen)|

Diese Ansätze ergänzen sich. Verwenden Sie den gehosteten MCP-Server für den Tool-Zugriff, installieren Sie Skills als Workflow-Anleitung und verweisen Sie Ihr LLM auf llms.txt, wenn es Robot-Dokumentation benötigt.
