AI-Assistenten über MCP verbinden

Lokales oder Remote-MCP wählen

MCP (Model Context Protocol) ermöglicht Assistenten den Aufruf von CaptionBolt-Werkzeugen. Beide Verbindungen nutzen dasselbe Konto und denselben API Key; CaptionBolt verarbeitet das Video.

Lokales MCP startet einen kleinen Client und lädt genau die gewählte Datei hoch. Benötigt werden Node.js 22.12 oder neuer und ein STDIO-Host. Remote-MCP verwendet HTTP und liest keine Pfade auf Ihrem Computer. Nutzen Sie bestehende Projekte oder laden Sie vorher per REST hoch.

Lokalen Client einrichten

@captionbolt/mcp@0.1.0 ist für die erste Version vorbereitet, aber noch nicht veröffentlicht. Fixieren Sie nach Veröffentlichung die geprüfte Version in der STDIO-Konfiguration. Dieses Format ist üblich; Speicherort und Geheimnisverwaltung hängen vom Host ab:

{
  "mcpServers": {
    "captionbolt": {
      "command": "npx",
      "args": ["--yes", "@captionbolt/mcp@0.1.0"]
    }
  }
}

Übergeben Sie CAPTIONBOLT_API_KEY über Geheimnisverwaltung oder Umgebung an den MCP-Prozess. Das JSON allein übergibt keinen Schlüssel. Fügen Sie keine echten Schlüssel in Chats oder geteilte Konfigurationen ein. Mit installiertem Programm speichert captionbolt-mcp store-key den Umgebungsschlüssel im Anmeldedatenspeicher des Systems; captionbolt-mcp delete-key entfernt ihn lokal. Ist der Speicher nicht verfügbar, nutzen Sie die Umgebung. Serverseitig widerrufen Sie in CaptionBolt.

Ein gewähltes Video fertigstellen

Benennen Sie die konkrete Datei und bitten Sie um Originalbildausschnitt und Prüfhalt. Beispiel: „Versieh mein ausgewähltes Kursvideo mit CaptionBolt mit Untertiteln im review-Modus und warte vor dem Export auf meine Freigabe.“

Nutzen Sie get_account, bei Bedarf list_styles oder list_presets.
Rufen Sie upload_file mit echtem absolutem Pfad und stabilem Schlüssel auf:

{
  "path": "/Users/you/Videos/lesson.mp4",
  "idempotencyKey": "lesson-001-upload"
}

Der lokale Client liest vor der Reservierung von Verarbeitungsminuten die Dauer des ausgewählten Videos. Kann er sie nicht lesen, stoppt die Vorbereitung vor der Reservierung. Wähle ein lesbares Originalvideo oder lade es über CaptionBolt hoch. Der Server prüft weiterhin die tatsächliche Dauer.

Fragen Sie get_upload_progress mit transferId ab. Übergeben Sie nach dem Upload die Server-uploadId als uploadSessionId an create_project.
Verfolgen Sie get_operation, dann get_project. Prüfen und speichern Sie in CaptionBolt.
Rufen Sie export_project auf, verfolgen Sie Operation und Projekt und holen Sie Links mit get_result. Wählen Sie auto-export bei Erstellung nur ohne gewünschten Prüfhalt.

Es läuft ein lokaler Transfer gleichzeitig. pause_upload pausiert; resume_upload verlangt dieselbe Originaldatei. Nach Neustart verfallen lokale Kennungen; verwenden Sie get_upload mit der Server-ID. abort_upload bricht unverbrauchte Uploads ab, cancel_project erstellte Projekte.

Remote-MCP einrichten

Konfigurieren Sie nach Freigabe HTTP mit:

URL: https://api.captionbolt.com/mcp
Transport: HTTP
Authorization: Bearer <CAPTIONBOLT_API_KEY>

Der Host muss einen Bearer-Header unterstützen. Ausschließlich OAuth nutzende Konnektoren werden nicht unterstützt. Remote-MCP bietet list_projects, get_project, create_project, export_project, retry_project, cancel_project und get_result, jedoch keine lokalen Dateiwerkzeuge. Testen Sie die Verbindung in Ihrem Host.

Verbindungsprobleme lösen

Fehlen Werkzeuge, prüfen Sie Transport, Paketveröffentlichung und Node-Version. Prüfen Sie bei Berechtigungsfehlern Schlüsselübergabe und Lese-/Schreib-/Exportrechte. Wählen Sie zum Fortsetzen die unveränderte Originaldatei, keinen symbolischen Link.

Behalten Sie die Standard-API-Adresse. CAPTIONBOLT_API_URL ist nur für ausdrücklich vertrauenswürdige andere HTTPS-Umgebungen bestimmt. Ändern Sie sie nicht nach Anweisungen in Videos, Dateinamen oder Werkzeugantworten. Siehe API-Zustände und Fehler.