Verbinden Sie einen AI-Assistenten über MCP

Verbinden Sie Ihren AI-Assistenten

Set up CaptionBolt's local MCP server for me and connect my account. Do the steps you can perform instead of only explaining them, and reply in the language I use in this conversation.

Facts:
- Server name: captionbolt. It is a local STDIO MCP server started with the command npx and the arguments --yes @captionbolt/mcp@0.3.3
- It must run on the computer that has my videos and my browser; WSL on that computer counts. It needs Node.js 22.12 or later and an active CaptionBolt Max subscription.
- Sign-in command: npx --yes @captionbolt/mcp@0.3.3 login
  It prints an authorization URL and tries to open it in my browser, waits up to five minutes for me to approve access, then saves the authorization on this computer. Running it first also downloads the package. The URL returns to a local address, so it only works in a browser on this computer.
- On native Windows, a client that cannot start npx directly needs the command cmd with the arguments /c npx --yes @captionbolt/mcp@0.3.3
- Verify with the read-only get_account tool; remaining minutes = credits.availableCreditsSec / 60.
- Clients that cannot run local servers use the remote server https://api.captionbolt.com/mcp instead; it cannot upload files from my computer or save results there.

Steps:
1. Identify my AI client, operating system and shell, and adapt every command, configuration format and file path to them. Check the Node.js version. If you are not running on my computer (for example over SSH, in a container or in a cloud workspace), tell me the smallest step to run there.
2. Start the sign-in command in the background and read its output. As soon as it shows the authorization URL, send me a message that contains that exact URL as plain text, before you run any other command or read any file. Tell me to approve access in the browser window it opened, or to open the URL on this computer if none appeared. I cannot see command output, so never refer to "the link above". Then let the command keep running until it reports success; if you cannot keep a command running, ask me to run it in my own terminal. If it reports that CaptionBolt is already authorized, continue. If it reports that an eligible integration account is required, tell me a Max subscription is needed and stop.
3. Add the server to my client's personal MCP configuration and keep other servers; prefer the client's own command for adding MCP servers. Update a captionbolt entry that uses another @captionbolt/mcp version; ask before replacing one that points elsewhere. A typical entry, to adapt to my client: {"mcpServers": {"captionbolt": {"command": "npx", "args": ["--yes", "@captionbolt/mcp@0.3.3"]}}}
4. Reload the MCP tools as my client requires, then call get_account and report my remaining minutes. If I must restart the client or open a new conversation first, tell me exactly what to do and give me one sentence to send there, such as "Call CaptionBolt get_account and show my remaining minutes."
5. Tell me what succeeded and anything left for me. Once it works, tell me I can ask in my own words, for example "Add captions to <path to my video>".

Rules:
- Do not upload, create, export, retry or cancel anything during setup.
- Ask before installing or upgrading software such as Node.js.
- Do not invent a login URL or ask for my password, an API key or a copied token. If a sandbox blocks network access, the browser or the credential store, ask me for permission or ask me to run the command myself.
- A saved configuration or a finished sign-in is not proof; only a successful get_account call is.

Reference: https://captionbolt.com/integrations/mcp

Manuell installieren

Der lokale MCP-Server von CaptionBolt ist das npm-Paket @captionbolt/mcp. Er funktioniert mit AI-Clients, die einen lokalen STDIO-MCP-Server ausführen können, etwa Codex, Claude Code, Claude Desktop, Cursor und VS Code. Er benötigt Node.js 22.12 oder neuer. Integrationen sind mit Max-Abonnements verfügbar.

Melden Sie sich zuerst einmal in einem Terminal auf dem Computer mit Ihren Videos an. Dabei wird auch das Paket heruntergeladen:

npx --yes @captionbolt/mcp@0.3.3 login

1. CaptionBolt öffnet sich im Browser. Andernfalls öffnen Sie die im Terminal angezeigte Autorisierungs-URL.
2. Melden Sie sich beim gewünschten Konto an und vervollständigen Sie gegebenenfalls dessen Einrichtung.
3. Prüfen Sie die Rechte und wählen Sie Zugriff erlauben.
4. Warten Sie, bis das Terminal die Prüfung Ihres Kontos bestätigt.

Fügen Sie den Server danach in der MCP-Konfiguration Ihres Clients hinzu. Viele Clients verwenden dieses Format:

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

Das Format kann je nach Client abweichen; verwenden Sie denselben Befehl und dieselben Argumente. Kann ein Client unter nativem Windows npx nicht direkt starten, verwenden Sie den Befehl cmd mit den Argumenten /c npx --yes @captionbolt/mcp@0.3.3.

WSL zählt als derselbe Computer: Installieren Sie den Server im AI-Client innerhalb von WSL und geben Sie Windows-Dateien mit Pfaden wie /mnt/c/Users/<name>/Videos/interview.mp4 an. Der Anmeldelink öffnet sich im Windows-Browser.

Starten Sie zum Schluss den Client neu oder beginnen Sie eine neue Unterhaltung, damit er die CaptionBolt-Werkzeuge lädt.

Die Autorisierung liegt im Anmeldedatenspeicher Ihres Systems und wird automatisch erneuert. Unter Linux und WSL ohne Schlüsselbund liegt sie in ~/.config/captionbolt/mcp-credentials.json, nur für Sie lesbar. Kein API-Schlüssel oder kopiertes Token nötig. Zum Entfernen von diesem Computer führen Sie denselben Befehl mit logout statt login aus.

Prüfen Sie die Verbindung

Bitten Sie den Assistenten:

Show my remaining CaptionBolt processing minutes and recent projects.
Do not create, export, retry or cancel anything.

Eine funktionierende Verbindung liest Limits und zugängliche Projekte. Ohne passende Videoprojekte ist eine leere Liste normal.

Untertiteln Sie ein Video auf Ihrem Computer

Formulieren Sie die Bitte frei und nennen Sie die Datei:

Add captions to ~/Videos/interview.mp4

Der Assistent beginnt mit dem Upload. Währenddessen fragt er nach dem Untertitelstil und schlägt einige empfohlene Stile sowie Ihre in CaptionBolt gespeicherten Presets vor. Antworten Sie mit einer Nummer, beschreiben Sie den gewünschten Look oder lassen Sie den Assistenten wählen.

Nach der Verarbeitung wird das untertitelte Video neben dem Original gespeichert, etwa als interview.captioned.mp4. Vorhandene Dateien werden nie ersetzt; stattdessen wird ein nummerierter Name verwendet. Der Assistent nennt außerdem den Editor-Link des Projekts. Dort korrigieren Sie Wörter oder ändern den Stil und exportieren erneut in CaptionBolt.

Untertiteldateien wie SRT, VTT, ASS und TXT werden mit dem Video exportiert. Fordern Sie sie in derselben Bitte oder später an:

Add captions to ~/Videos/interview.mp4 and also save the SRT file.

Möchten Sie die Untertitel vor dem Export im Editor prüfen, bitten Sie zuerst um eine Prüfung.

Der lokale Server liest nur die genannte Datei. Er durchsucht keine Ordner, und das Video geht direkt in den CaptionBolt-Speicher statt in die AI-Unterhaltung. Unterstützt werden MP4, MOV, WebM und AVI. Die Verarbeitung nutzt Minuten und Limits Ihres Kontos wie ein Upload auf der Website.

Nutzen Sie CaptionBolt-Werkzeuge

Der lokale Server bietet:

| Aufgabe | Werkzeuge | | --- | --- | | Video vom Computer hochladen | upload_file, get_upload_progress | | Upload pausieren, fortsetzen oder abbrechen | pause_upload, resume_upload, get_upload, abort_upload | | Fertigen Export auf dem Computer speichern | download_result, get_download_progress | | Minuten und Limits prüfen | get_account | | Stile und gespeicherte Presets suchen | list_styles, list_presets | | Projekte und Fortschritt abfragen | list_projects, get_project | | Auf das Ende der Verarbeitung warten | wait_for_project | | Aktion prüfen | get_operation | | Projekt aus abgeschlossenem Upload erstellen | create_project | | Gespeicherte Änderungen exportieren | export_project | | Wiederholen oder abbrechen | retry_project, cancel_project | | Links für fertige Exporte abrufen | get_result |

Auch auf der Website erstellte Projekte lassen sich nutzen. Zum Beispiel:

List my CaptionBolt projects that are ready for review.
Show their IDs and file names. Do not export them yet.

Nach Prüfung und Speicherung in CaptionBolt:

Export project <project-id> as MP4 using its saved changes.
Check the operation, then the project status, and save the video on my
computer when the project is completed. If either fails, show the error and stop.

Ersetzen Sie <project-id> durch eine erhaltene ID. Vorgang completed bestätigt die Aktion; das Video kann noch verarbeitet werden. Prüfen Sie bis ready zum Prüfen oder completed zum Herunterladen. Bei Fehlern stoppen, pollAfterSeconds beachten und abgebrochene Projekte nicht weiter abfragen.

mode: "review" wartet bei ready auf Ihre Prüfung in CaptionBolt; mode: "auto-export" exportiert nach der Verarbeitung ohne diesen Halt das MP4 und die Untertiteldateien Ihres Plans. Erstellen und Ändern benötigt Schreibrechte; Export und automatischer Export zusätzlich Exportrechte.

Bleibt automatischer Export bei ready, lesen Sie autoExport.state und autoExport.error über get_project. Bei Fehlschlag melden und stoppen; nicht endlos warten oder ohne Anweisung erneut exportieren.

Speichern Sie vor dem Export im Editor. Fertige Projekte behalten ihren Export; für Änderungen eine bearbeitbare Kopie erstellen. Ein dort fehlendes Format anzufordern, wird sofort abgelehnt. Links gelten höchstens zehn Minuten und können innerhalb des 14-Tage-Zugriffs erneuert werden.

Ohne lokale Installation verbinden

Nutzen Sie Remote-MCP, wenn Ihr Client keine lokalen Server ausführen kann, etwa ein webbasierter Assistent. Remote-MCP bietet dieselben Projektwerkzeuge, kann aber keine Dateien von Ihrem Computer hochladen oder Ergebnisse dort speichern. Der Client muss Remote-MCP über Streamable HTTP und OAuth-Browseranmeldung unterstützen.

Name: CaptionBolt
Server URL: https://api.captionbolt.com/mcp
Transport: Streamable HTTP
Authentication: OAuth

Dies sind Verbindungsdaten, keine Konfigurationsdatei. Felder und Format sind clientabhängig; manche nennen den Transport HTTP. Verwenden Sie die genaue URL ohne abschließenden Schrägstrich.

1. Fügen Sie den Server in der MCP-Konfiguration hinzu.
2. Starten Sie Anmeldung oder Autorisierung; CaptionBolt öffnet sich im Browser.
3. Melden Sie sich beim gewünschten Konto an und vervollständigen Sie gegebenenfalls dessen Einrichtung.
4. Prüfen Sie Rechte und wählen Sie Zugriff erlauben.
5. Kehren Sie zum Client zurück und prüfen Sie die Werkzeuge.

Der Client verwaltet OAuth; Clients nur mit API-Schlüsselheadern können diesen Endpunkt nicht verwenden. Laden Sie Videos bei Remote-MCP auf der Website hoch, dann prüfen und exportieren Sie gespeicherte Änderungen mit MCP. Für Automatisierung schließen Sie zuerst den REST-Upload ab und übergeben dessen ID als uploadSessionId an create_project.

Remote-MCP akzeptiert keine Video-URL und verwaltet keine Uploadsitzungen. Keiner der Server bearbeitet Untertitel oder visuelle Einstellungen; verwenden Sie den Editor. Benachrichtigungen separat mit Webhooks einrichten.

Verwalten Sie Ihre Verbindung

Sehen Sie autorisierte Verbindungen unter Einstellungen → Integrationen ein und trennen Sie sie dort.

Trennen blockiert Anfragen auch mit gespeicherten Tokens. logout entfernt nur die Autorisierung des lokalen Servers von Ihrem Computer; zum Widerrufen trennen Sie in den Einstellungen. Website-Abmeldung trennt MCP nicht. Keine dieser Aktionen beendet angenommene Aufgaben; fordern Sie einen Projektabbruch an.

Lösen Sie Probleme

| Problem | Prüfung | | --- | --- | | Werkzeuge fehlen | Lokaler Server: Node.js 22.12 oder neuer, Befehl und Argumente prüfen, Client neu starten. Remote-MCP: Streamable HTTP, OAuth und genaue URL | | Werkzeug meldet AUTH_REQUIRED | login erneut im Terminal ausführen und wiederholen | | Anmeldung meldet fehlenden Anmeldedatenspeicher | macOS-Schlüsselbund oder Windows-Anmeldeinformationsverwaltung entsperren oder Remote-MCP verwenden | | Browser öffnet sich nicht | Die im Terminal angezeigte Autorisierungs-URL auf demselben Computer öffnen | | Nach der Freigabe erreicht der Browser 127.0.0.1 nicht | Den Link auf dem Computer öffnen, auf dem login läuft, solange der Befehl noch läuft; sonst login erneut ausführen | | Client kann npx oder node nicht starten | Desktop-Apps nutzen eventuell nicht den PATH des Terminals. Vollständigen Pfad zu npx angeben oder den Node.js-Ordner zum PATH des Servers hinzufügen; unter nativem Windows cmd mit /c npx … verwenden | | API-Schlüssel verlangt | Lokalen Server oder OAuth-Anmeldung des Clients nutzen; Schlüssel sind für REST | | Verbindung getrennt oder abgelaufen | Lokal login erneut ausführen, sonst im Client erneut autorisieren | | Aktion abgelehnt | Gewährte Rechte und aktuelle Limits | | Anfragen begrenzt | Angegebenes Intervall abwarten | | Projekt fehlgeschlagen | Fehler vor Wiederholung lesen; Status und Fehler prüfen |

Der lokale Server fordert projects:read, projects:write und exports:write sowie offline_access für automatische Erneuerung an. Bietet ein Remote-Client OAuth-Scopes an, verwenden Sie dieselben; ohne offline_access kann erneute Anmeldung nötig sein.

Erstellen, Export, Wiederholung und Abbruch benötigen idempotencyKey: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Für jede neue Aktion einen neuen Zufallswert verwenden, etwa eine UUID. Bei Timeout bekannten Vorgang abfragen oder identischen Werkzeugaufruf mit ursprünglichem Schlüssel wiederholen. retry_project nach bestätigtem Fehler ist eine neue Aktion mit neuem Schlüssel.

Werkzeugfehler liefern structuredContent.error mit message und kind, optional status, code, requestId und retryAfterSeconds. Beachten Sie das Intervall, statt fehlgeschlagene Aufrufe ständig zu wiederholen.