API und MCP mit Claude und ChatGPT
Alles, was du im Editor machst, geht auch automatisiert: über die REST-API aus eigenen Programmen und Automationen oder über MCP direkt aus KI-Assistenten wie Claude und ChatGPT. API, MCP, Editor und KI-Assistent nutzen dieselben Schnittoperationen – das Ergebnis ist identisch.
Verfügbarkeit
| Tarif | API und MCP |
|---|---|
| Free | lesender Zugriff; KI-Aufträge im Rahmen der 60 Monats-Credits |
| Creator, Pro, Team | voller Zugriff |
API-Schlüssel anlegen
- Öffne Einstellungen → API-Schlüssel.
- Klicke auf Neuer Schlüssel, gib einen Namen ein und wähle die Rechte:
- lesen – Projekte, Medien, Exporte und Aufträge abrufen,
- schreiben – Projekte anlegen und bearbeiten, Medien hochladen, Exporte starten,
- ki – KI-Aufträge starten (verbraucht Credits).
- Kopiere den Schlüssel. Er beginnt mit
agile_cut_und wird nur einmal angezeigt.
Bewahre den Schlüssel wie ein Passwort auf. Einen verlorenen oder kompromittierten Schlüssel widerrufst du in derselben Ansicht.
Die REST-API
- Basis:
https://cut.agiledeveloper.de/api/v1/ - Anmeldung:
Authorization: Bearer agile_cut_… - Interaktive Dokumentation: https://cut.agiledeveloper.de/docs
- OpenAPI-Beschreibung: https://cut.agiledeveloper.de/api/openapi.json
- Feldnamen und Fehlermeldungen sind deutsch; Fehler kommen als
{ "fehler": { "code", "nachricht", "details" } }. - Für sichere Wiederholungen gibt es den Header
Idempotency-Key. Anfragen sind mengenbegrenzt.
Die wichtigsten Bereiche
| Bereich | Wofür |
|---|---|
| /projekte | anlegen, lesen, bearbeiten, duplizieren, Versionen wiederherstellen |
| /projekte/{id}/operationen | Schnittoperationen anwenden (teilen, trimmen, Bereiche entfernen, Untertitel, Stil …) |
| /projekte/{id}/export | Export starten |
| /projekte/{id}/untertitel.srt bzw. .vtt | Untertitel herunterladen |
| /projekte/{id}/transkript | Transkript des Projekts mit Zeiten |
| /medien | Upload (auch fortsetzbar in Teilen), Import per URL, Auslieferung |
| /auftraege | KI- und Bearbeitungsaufträge starten, Credits vorab schätzen (?schaetzen=1), Status, Abbrechen |
| /exporte | Exporte abrufen, Teilen-Link und Kommentare verwalten |
| /stimmen | System- und eigene Stimmen |
| /webhooks | Webhooks verwalten (siehe „Webhooks“) |
Projekte haben eine Revision. Schickst du eine Änderung mit veralteter Revision, antwortet die API mit 409 – lade dann den aktuellen Stand und wende deine Änderung erneut an.
Kleine Dateien bis 200 MB kannst du in einem Stück hochladen; größere über den mehrteiligen Upload oder per URL-Import.
MCP: Agile Cut in Claude oder ChatGPT
Mit MCP verbindest du Agile Cut mit einem KI-Assistenten. Danach kannst du dort schreiben: „Mach aus meinem letzten Upload ein 9:16-Video mit Untertiteln und exportiere es“.
MCP-Adresse: https://cut.agiledeveloper.de/mcp
Die Anmeldung läuft über OAuth: Du meldest dich bei Agile Cut an und bestätigst die Rechte (lesen, schreiben, ki). Ein API-Schlüssel ist dafür nicht nötig.
Schritt-für-Schritt-Anleitungen für Claude und ChatGPT findest du unter https://cut.agiledeveloper.de/docs/mcp.
Werkzeuge
| Werkzeug | Was es tut |
|---|---|
| projekte_liste | Projekte auflisten |
| projekt_lesen | ein Projekt lesen |
| projekt_anlegen | Projekt aus Medien-IDs oder URLs anlegen, optional mit Format und Untertiteln |
| projekt_bearbeiten | Schnittoperationen anwenden |
| export_starten / export_status | Export starten und verfolgen |
| medien_liste | Medienbibliothek auflisten |
| medium_importieren | Medium per URL importieren |
| ki_auftrag | KI-Auftrag starten, mit Credits-Schätzung |
| auftrag_status | Stand eines Auftrags |
| stimmen_liste | verfügbare Stimmen |
| untertitel_erzeugen | Untertitel erzeugen |
| clips_finden | KI-Clips aus einem langen Video |
| credits_anzeigen | Credit-Stand |
| guide, search, fetch | Anleitung, Suche und Abruf von Inhalten |
Credits über API und MCP
KI-Aufträge kosten dasselbe wie im Editor. Mit ?schaetzen=1 bzw. über ki_auftrag erfährst du die Credits vorab. Fehlgeschlagene Aufträge kosten nichts. Für KI-Aufträge braucht der Zugang das Recht ki.
Tipps
- Gib jedem Einsatzzweck einen eigenen Schlüssel mit möglichst wenigen Rechten.
- Statt den Status ständig abzufragen, nutze Webhooks.
- Alle Aufrufe deines Arbeitsbereichs siehst du im API-Protokoll unter Einstellungen.