Ihre Konnektor-Adresse
Diese URL tragen Sie in jedem Assistenten ein. Die Anmeldung läuft über OAuth; Sie kopieren kein Passwort und keinen Schlüssel in den Assistenten.
https://cut.agiledeveloper.de/mcpClaude (claude.ai, Desktop und Mobil)
- Öffnen Sie Einstellungen › Konnektoren und wählen Sie Benutzerdefinierten Konnektor hinzufügen.
- Name „Agile Cut“, URL https://cut.agiledeveloper.de/mcp, dann Hinzufügen.
- Klicken Sie auf Verbinden. Agile Cut öffnet sich: anmelden, Rechte prüfen, Erlauben.
- Im Chat über das Werkzeug-Menü den Konnektor einschalten und loslegen.
In Team- und Enterprise-Organisationen fügt meist die Verwaltung den Konnektor einmal für alle hinzu; danach verbindet sich jede Person selbst.
ChatGPT
- Öffnen Sie Einstellungen › Apps und Konnektoren › Erweitert und schalten Sie den Entwicklermodus ein.
- Wählen Sie Konnektor erstellen: Name „Agile Cut“, URL https://cut.agiledeveloper.de/mcp, Authentifizierung OAuth.
- Bei Agile Cut anmelden und Erlauben. Danach steht der Konnektor im Chat unter den Werkzeugen zur Auswahl.
Für die Suche in ChatGPT (Deep Research, Konnektor-Suche) gibt es die Werkzeuge search und fetch: Sie finden Projekte und Medien und liefern deren Inhalt als Text.
Ob und in welchem Umfang der Entwicklermodus in Ihrem ChatGPT-Tarif verfügbar ist, legt OpenAI fest. Die Menünamen können sich bei OpenAI ändern.
Claude Code
Im Terminal hinzufügen:
claude mcp add --transport http agile-cut https://cut.agiledeveloper.de/mcpDann in Claude Code /mcp eingeben, agile-cut wählen und Authentifizieren. Der Browser öffnet die Anmeldung.
Ohne Browser, mit API-Schlüssel
Für Server und Skripte: einen Schlüssel unter Einstellungen › Entwickler anlegen und als Header mitgeben.
claude mcp add --transport http agile-cut https://cut.agiledeveloper.de/mcp --header "Authorization: Bearer agile_cut_…"Andere MCP-Clients (Cursor, VS Code, MCP Inspector)
Streamable HTTP mit OAuth 2.1 (Discovery, dynamische Registrierung, PKCE). Typische Konfiguration:
{
"mcpServers": {
"agile-cut": {
"type": "http",
"url": "https://cut.agiledeveloper.de/mcp"
}
}
}Beispiele
So können Sie mit dem Assistenten sprechen:
„Welche Projekte habe ich diese Woche bearbeitet?“
„Zeig mir das Projekt „Produktvideo Herbst“ und wie lang es ist.“
„Wie viele Credits habe ich diesen Monat noch?“
KI-Aufträge verbrauchen Credits Ihres Arbeitsbereichs. Vor teuren Aufträgen fragt der Assistent nach.
Werkzeuge
| Werkzeug | Was es tut | Recht |
|---|---|---|
| guide | Anleitung. Kompakte Anleitung zu Agile Cut: Projekte, Spuren und Clips, Operationen (projekt_bearbeiten), Medien, KI-Aufträge, Exporte und Credits. Vor der ersten Arbeit einmal lesen. | jeder Zugang |
| projekte_liste | Projekte auflisten. Projekte des Arbeitsbereichs, zuletzt geöffnete zuerst (ohne Inhalt). Optional suche (Name). | lesen |
| projekt_lesen | Projekt lesen. Ein Projekt mit vollständigen Daten (Spuren, Clips mit Zeiten und Medien-IDs, Marker) und der aktuellen revision für projekt_bearbeiten. | lesen |
| projekt_anlegen | Projekt anlegen. Legt ein Projekt an, optional im Format (9:16, 16:9, 1:1, 4:5) und mit fertigen Medien (medien_ids, nacheinander auf der Hauptspur). URLs werden importiert; nach der Aufbereitung fügst du sie mit projekt_bearbeiten (clip_einfuegen) ein. untertitel: true erzeugt Untertitel aus vorhandenen Transkripten. | schreiben |
| projekt_bearbeiten | Projekt bearbeiten. Wendet Operationen an (dieselben wie im Editor, atomar), z. B. clip_teilen {zeit}, clip_entfernen {clip_ids, luecke_schliessen}, clip_trimmen, text_einfuegen {zeit, vorlage, text}, untertitel_stil {stil}, uebergang_setzen, format_aendern {breite, hoehe}, marker_setzen, bereiche_entfernen. revision = aktuelle Revision aus projekt_lesen; bei Konflikt neu lesen. Liste aller Operationen in guide. | schreiben |
| untertitel_erzeugen | Untertitel erzeugen. Untertitel für ein Projekt im gewünschten Stil (z. B. wort-gelb, pop, karaoke, klassisch). Fehlen Transkripte, schätzt das Werkzeug die Credits fürs Transkribieren; mit bestaetigt: true startet es die Transkription (danach erneut aufrufen). | schreiben |
| medien_liste | Medien auflisten. Videos, Audios und Bilder des Arbeitsbereichs mit Status, Dauer und Maßen. Ein Medium nutzt man über seine id. | lesen |
| medium_importieren | Medium aus URL importieren. Lädt ein Video, Audio oder Bild von einer öffentlichen URL in die Medien. Danach wird es aufbereitet (Status verarbeiten → bereit). | schreiben |
| ki_auftrag | KI-Auftrag. KI- und Bearbeitungsaufträge (Arten: transkribieren, uebersetzen, sprechen, stimme_klonen, stimme_wandeln, studioklang, stems, synchronisieren, stille_finden, szenen_finden, beats_finden, hintergrund_entfernen, reframe, hochskalieren, zeitlupe, stabilisieren, rueckwaerts, standbild, stimmeffekt, lautheit, bild_generieren, video_generieren, musik_generieren, clips_finden, skript_zu_video). Ohne bestaetigt liefert es die Credits-Schätzung; nenne sie der Person und starte nach Zustimmung mit bestaetigt: true. Lokale Arten (stille_finden, szenen_finden, beats_finden …) sind kostenlos und starten sofort. | lesen |
| clips_finden | Clips aus langem Video. Findet die besten Stellen eines langen Videos für kurze Clips (Hook, Titel, Begründung). Erst Credits-Schätzung, mit bestaetigt: true starten. | lesen |
| auftrag_status | Auftrag-Status. Status, Fortschritt, Ergebnis und Credits eines Auftrags; optional warten_s (bis 50) auf den Endzustand. | lesen |
| export_starten | Exportieren. Exportiert ein Projekt als Video (mp4, mov, webm, gif), Audio (mp3, wav) oder Untertitel (srt, vtt). Kostet keine Credits; Auflösung und fps werden auf den Tarif begrenzt. Danach export_status. | schreiben |
| export_status | Export-Status. Status und Fortschritt eines Exports; optional warten_s (bis 50). Fertig: ansehen-Link und datei_url (mit Anmeldung) bzw. Teilen-Link, wenn freigegeben. | lesen |
| stimmen_liste | Stimmen auflisten. Systemstimmen und eigene (geklonte) Stimmen mit Sprache und Stil; die id nutzt ki_auftrag (sprechen, stimme_wandeln). | lesen |
| credits_anzeigen | Credits und Tarif. Tarif, verfügbare Credits (Abo und Pakete), Verbrauch im Monat und Kostendeckel für Zusatz-Credits. | lesen |
| search, fetch | Suche und Abruf für ChatGPT. | lesen |
Anleitung für Assistenten
Das Werkzeug guide erklärt dem Assistenten Projekte, Spuren und Clips, Medien, Aufträge, Exporte und Credits.
Rechte und Sicherheit
- Der Assistent arbeitet nur im Arbeitsbereich, mit dem Sie sich verbinden, und nie mit mehr Rechten als Ihre Rolle im Team.
- API-Schlüssel und Zahlungsdaten gibt es über den Konnektor nie, auch nicht mit allen Rechten.
- Tarif und Zahlungen ändert nur ein Mensch in der App.
- Unter Einstellungen › Verbundene Apps sehen Sie jede Verbindung mit ihren Rechten und trennen sie mit einem Klick. Der Zugriff endet sofort.
Fehlerbehebung
- Anmeldefenster öffnet sich nicht: Pop-up-Blocker prüfen oder die Verbindung im Assistenten neu starten.
- „Diesem Zugang fehlt das Recht …“: Verbindung trennen und neu verbinden, dabei das passende Recht anhaken.
- 402 oder „Nicht genug Credits“: Unter Abrechnung Tarif oder Kostendeckel prüfen.
- Verbindung abgelaufen: Unbenutzte Verbindungen enden nach 60 Tagen. Einfach neu verbinden.
- Falsches Konto: Unter Verbundene Apps trennen, abmelden und mit dem richtigen Konto neu verbinden.
Für Entwickler: OAuth-Metadaten unter /.well-known/oauth-authorization-server, geschützte Ressource unter /.well-known/oauth-protected-resource, REST-API unter /docs.