Verbinden Sie einen AI-Assistenten über MCP

Verbinden Sie Ihren AI-Assistenten

Set up and connect CaptionBolt remote MCP now. Carry out the setup steps you can perform instead of only explaining them.
Communicate with me in the language I use in this conversation.

Connection details:
- Server name: captionbolt
- Server URL: https://api.captionbolt.com/mcp (no trailing slash)
- Transport: Streamable HTTP
- Authentication: OAuth browser sign-in
- Account requirement: an active CaptionBolt Max subscription

1. Identify the AI client and version you are configuring. Use the current environment when it identifies the client. Ask which client I use only if you cannot determine it. If you are running on a different machine from my client, explain the smallest step I need to perform on my machine.

2. Inspect the client's existing MCP configuration. Reuse a correct CaptionBolt entry. Otherwise, add this remote server using the client's supported command or configuration format. Prefer personal/user configuration and preserve other servers. If a conflicting CaptionBolt entry points elsewhere, ask before replacing it.

For Codex CLI, use:
codex mcp add captionbolt --url https://api.captionbolt.com/mcp

For Claude Code, use:
claude mcp add --transport http --scope user captionbolt https://api.captionbolt.com/mcp

Check the installed client's help before running commands. Run the add command only when the server is not already configured correctly. If this Claude Code version has no MCP login command, direct me to /mcp and its authentication action. For Cursor, use its supported remote MCP settings or mcp.json format with this server URL, then guide me through its connection and authorization action.

3. First try the read-only CaptionBolt get_account tool. If it succeeds, reuse the existing MCP authorization and do not start another login. If it reports authorization is required, start the client's native OAuth flow (Codex: codex mcp login captionbolt; Claude Code: claude mcp login captionbolt, or /mcp if this version has no login command). Open the browser or show the actual authorization URL produced by the client, then wait for me to sign in to CaptionBolt and approve access. Keep the login process running while it waits for the callback. An existing website session may avoid password entry but does not replace MCP consent. Do not invent or manually construct a login URL. No API key, manually copied access token or local CaptionBolt package is needed. Let the client handle callbacks and credential storage. If the client requires explicit scopes, use projects:read projects:write exports:write offline_access.

4. Once authorization succeeds, reconnect or reload the MCP tools as required by the client. If a restart or new conversation is required, tell me exactly how to continue verification there.

5. Verify the connection with the read-only CaptionBolt get_account tool (reuse the successful result from step 3 if already called). Report my remaining processing minutes. Do not upload, create, export, retry or cancel anything during setup. Configuration saved or login completed alone is not proof that this tool works.

6. Report which steps succeeded and any remaining step. If a permission or client limitation prevents execution, explain it and give me the smallest required action. Do not claim the connection works until the verification calls succeed.

Reference: https://captionbolt.com/integrations/mcp
Client documentation:
- Codex: https://developers.openai.com/codex/mcp
- Claude Code: https://code.claude.com/docs/en/mcp
- Cursor: https://cursor.com/docs/mcp

Manuell verbinden

Verwenden Sie einen Client mit Remote-MCP über Streamable HTTP und OAuth-Browseranmeldung. Integrationen sind mit Max-Abonnements verfügbar.

Fügen Sie den Server mit diesen Daten hinzu:

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.

Kein API-Schlüssel oder manuelles Tokenkopieren nötig; der Client verwaltet OAuth. Clients nur mit API-Schlüsselheadern können diesen Endpunkt nicht verwenden.

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. Laden Sie auf CaptionBolt ein Video hoch und fragen Sie erneut.

Nutzen Sie CaptionBolt-Werkzeuge

Der Server bietet:

| Aufgabe | Werkzeuge | | --- | --- | | Minuten und Limits prüfen | get_account | | Stile und gespeicherte Vorlagen suchen | list_styles, list_presets | | Projekte und Fortschritt abfragen | list_projects, get_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 |

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 give me the download link
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.

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

Arbeiten Sie mit einem neuen Video

Am einfachsten laden Sie 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. Übergeben Sie dessen ID als uploadSessionId an create_project.

mode: "review" wartet auf Prüfung; wählen Sie ausdrücklich mode: "auto-export" für MP4 nach Verarbeitung. 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.

Remote-MCP lädt keine lokalen Dateien hoch, akzeptiert keine Video-URL und verwaltet keine Uploadsitzungen. Untertitel oder visuelle Einstellungen bearbeitet es nicht; 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. Website-Abmeldung trennt MCP nicht. Beides beendet keine angenommenen Aufgaben; fordern Sie einen Projektabbruch an.

Lösen Sie Probleme

| Problem | Prüfung | | --- | --- | | Werkzeuge fehlen | Streamable HTTP, OAuth, genaue URL und abgeschlossene Anmeldung | | API-Schlüssel verlangt | OAuth wählen; Schlüssel sind für REST | | Verbindung getrennt oder abgelaufen | 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 |

Wenn der Client OAuth-Scopes anbietet: projects:read, projects:write, exports:write. offline_access ermöglicht automatische Erneuerung, normalerweise vom Client verwaltet. Ohne diesen Scope kann erneute Anmeldung nötig sein.

Erstellen, Export, Wiederholung und Abbruch benötigen idempotencyKey: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Neue Aktion, neuer Schlüssel. 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.