Verbind een AI-assistent met MCP

Verbind uw AI-assistent

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

Handmatig verbinden

Gebruik een client met externe MCP via Streamable HTTP en OAuth-browseraanmelding. Integraties zijn beschikbaar bij Max-abonnementen.

Voeg de server toe met deze gegevens:

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

Dit zijn verbindingsgegevens, geen configuratiebestand. Velden en formaat verschillen; sommige clients noemen het transport HTTP. Gebruik de exacte URL zonder afsluitende slash.

1. Voeg de server toe in de MCP-instellingen van uw client.
2. Start aanmelding of autorisatie; CaptionBolt opent in de browser.
3. Meld u aan bij het juiste account en voltooi zo nodig de inrichting.
4. Controleer rechten en kies Toegang toestaan.
5. Ga terug en controleer de beschikbare tools.

Geen API-sleutel of handmatig token kopiëren nodig. De client regelt OAuth. Clients met uitsluitend API-sleutelheaders kunnen niet verbinden.

Controleer de verbinding

Vraag de assistent:

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

Een werkende verbinding leest limieten en toegankelijke projecten. Een lege lijst is normaal zonder geschikte videoprojecten. Upload op CaptionBolt en probeer opnieuw.

Gebruik CaptionBolt-tools

De server biedt:

| Taak | Tools | | --- | --- | | Minuten en limieten controleren | get_account | | Stijlen en opgeslagen presets zoeken | list_styles, list_presets | | Projecten en voortgang bekijken | list_projects, get_project | | Actie controleren | get_operation | | Project uit voltooide upload maken | create_project | | Opgeslagen wijzigingen exporteren | export_project | | Opnieuw proberen of annuleren | retry_project, cancel_project | | Links voor voltooide exports ophalen | get_result |

Bijvoorbeeld:

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

Na controle en opslaan 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.

Vervang <project-id> door een ontvangen ID. Bewerking completed bevestigt de actie; het videoverwerken kan doorgaan. Vraag op tot ready voor controle of completed voor download. Stop bij fouten, volg pollAfterSeconds en stop bij annulering.

Sla eerst op in de editor. Voltooide projecten behouden de export; maak een bewerkbare kopie voor wijzigingen. Links duren maximaal tien minuten, vernieuwbaar binnen 14 dagen toegang.

Werk met een nieuwe video

Upload eenvoudig op de website en gebruik daarna MCP om opgeslagen wijzigingen te bekijken en exporteren.

Voor automatisering voltooit u eerst de REST-upload. Geef het ID als uploadSessionId aan create_project.

mode: "review" wacht op controle; kies uitdrukkelijk mode: "auto-export" voor MP4 na verwerking. Aanmaken en wijzigen vereist schrijven; export en automatische export ook exportrecht.

Blijft automatische export bij ready, lees autoExport.state en autoExport.error via get_project. Meld de fout en stop; wacht niet eindeloos en exporteer niet opnieuw zonder instructie.

Externe MCP uploadt geen lokale bestanden, accepteert geen video-URL en beheert geen uploadsessies. Ondertitels en visuele instellingen wijzigt het niet; gebruik de editor. Meldingen instellen via Webhooks.

Beheer uw verbinding

Bekijk en verbreek geautoriseerde verbindingen in Instellingen → Integraties.

Verbreken blokkeert verzoeken, ook met opgeslagen tokens. Afmelden op de website verbreekt MCP niet. Geen van beide annuleert geaccepteerd werk; vraag projectannulering aan.

Los problemen op

| Probleem | Controle | | --- | --- | | Tools ontbreken | Streamable HTTP, OAuth, exacte URL en voltooide aanmelding | | API-sleutel gevraagd | Kies OAuth; sleutels zijn voor REST | | Toegang verbroken of verlopen | Opnieuw autoriseren in de client | | Actie geweigerd | Goedgekeurde rechten en actuele limieten | | Verzoeken begrensd | Wacht het aangegeven interval | | Project mislukt | Lees fout voor opnieuw proberen; zie status en fouten |

Als de client OAuth-scopes toont: projects:read, projects:write, exports:write. Neem offline_access op voor automatische vernieuwing, doorgaans geregeld door de client. Anders kan opnieuw aanmelden nodig zijn.

Aanmaken, exporteren, opnieuw proberen en annuleren vereist idempotencyKey: 1–128 afdrukbare ASCII-tekens zonder spaties. Nieuwe actie, nieuwe sleutel. Vraag bij timeout een bekende bewerking op of herhaal identiek met de oorspronkelijke sleutel. retry_project na bevestigde fout is een nieuwe actie en vereist een nieuwe sleutel.

Toolfouten tonen structuredContent.error met message en kind, en indien beschikbaar status, code, requestId, retryAfterSeconds. Respecteer het interval, zonder een falende tool voortdurend aan te roepen.