Entwickler

API und MCP

Verbinde CueTwin mit deinen Tools: Sende Skripte und Dateien über die API oder lass einen KI-Assistenten (Claude, Cursor, VS Code …) per MCP Skripte für dich erstellen und bearbeiten.

Erstelle zuerst einen Schlüssel unterCueTwin → Entwickler. Kostenlos und in allen Tarifen verfügbar.

MCP-Server

Mit MCP kann dein KI-Assistent Skripte auflisten, schreiben, bearbeiten und importieren. Bitte ihn zum Beispiel: „Schreib ein 2-minütiges Launch-Skript und speichere es in CueTwin.“

URLhttps://cuetwin.com/api/mcp

Ersetze in den Beispielen ct_live_A_TUA_CHAVE durch deinen Schlüssel. Erstelle ihn unter CueTwin → Entwickler.

In Cursor installierenÖffnet Cursor zur Bestätigung. Oder manuell unter Settings → MCP → Add einfügen:

{
  "mcpServers": {
    "cuetwin": {
      "url": "https://cuetwin.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ct_live_A_TUA_CHAVE"
      }
    }
  }
}

Verfügbare Tools

list_scripts · get_script · get_account
create_script · update_script · delete_script
import_file (.txt, .md, .html, .docx, .pdf)

API

Eine REST-API mit JSON. Authentifiziere jede Anfrage mit dem Authorization-Header. Es gelten die Limits deines Tarifs, und Änderungen an einem Skript erscheinen sofort auf den Bildschirmen, die es zeigen.

Basis-URLhttps://cuetwin.com/api/v1

Authorization: Bearer ct_live_A_TUA_CHAVE

GET	`/me`	Dein Konto, Tarif und genutzte Skripte.
GET	`/scripts`	Listet Skripte auf (optional: ?folder=YouTube/Shorts für einen Ordner, ?folder= für die Hauptebene).
POST	`/scripts`	Erstellt ein Skript: { title, content, folder? }. Der Ordner ist ein Name oder Pfad und wird bei Bedarf erstellt.
POST	`/scripts/import`	Erstellt ein Skript aus einer .txt-, .md-, .html-, .docx- oder .pdf-Datei.
GET	`/scripts/:id`	Ein Skript mit vollständigem Text.
PATCH	`/scripts/:id`	Ändert Titel, Text oder Ordner.
POST	`/scripts/:id/import`	Ersetzt den Text eines Skripts durch den einer Datei.
DELETE	`/scripts/:id`	Löscht ein Skript.

Ein Skript erstellen

curl https://cuetwin.com/api/v1/scripts \
  -H "Authorization: Bearer ct_live_A_TUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"title": "Launch", "content": "## Eröffnung\n\nHallo zusammen! [LÄCHELN]"}'

Eine Datei hochladen

curl https://cuetwin.com/api/v1/scripts/import \
  -H "Authorization: Bearer ct_live_A_TUA_CHAVE" \
  -F "file=@rede.docx" \
  -F "folder=Events"

JSON geht auch: { "filename": "rede.pdf", "data": "<base64>" }. Maximal 10 MB. Überschriften im Dokument werden zu Abschnitten.

JavaScript

const res = await fetch('https://cuetwin.com/api/v1/scripts', {
  method: 'POST',
  headers: { Authorization: 'Bearer ct_live_A_TUA_CHAVE', 'Content-Type': 'application/json' },
  body: JSON.stringify({ title: 'Video vom Dienstag', content: 'Hi! Heute geht es um …' }),
});
const script = await res.json(); // { id, title, content, wordCount, seconds, … }

Skriptformat

Eine Leerzeile beginnt einen neuen Absatz.
## Titel erstellt einen Abschnitt (wird angezeigt, nicht gelesen).
[PAUSE] ist eine Notiz für die sprechende Person (wird angezeigt, nicht gelesen).

Fehler: 401 Schlüssel fehlt oder ungültig, 403 Tariflimit, 404 Skript nicht gefunden, 429 zu viele Anfragen (120 pro Minute). Sende x-ct-locale: en für Meldungen auf Englisch.