Verbind een AI-assistent met MCP

Verbind uw AI-assistent

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

Handmatig installeren

De lokale MCP-server van CaptionBolt is het npm-pakket @captionbolt/mcp. Hij werkt met AI-clients die een lokale STDIO-MCP-server kunnen uitvoeren, zoals Codex, Claude Code, Claude Desktop, Cursor en VS Code. Hij vereist Node.js 22.12 of nieuwer. Integraties zijn beschikbaar bij Max-abonnementen.

Meld u eerst eenmalig aan vanuit een terminal op de computer met uw video’s. Daarbij wordt ook het pakket gedownload:

npx --yes @captionbolt/mcp@0.3.3 login

1. CaptionBolt opent in de browser. Gebeurt dat niet, open dan de autorisatie-URL die de terminal toont.
2. Meld u aan bij het juiste account en voltooi zo nodig de inrichting.
3. Controleer rechten en kies Toegang toestaan.
4. Wacht tot de terminal bevestigt dat uw account is geverifieerd.

Voeg de server daarna toe aan de MCP-configuratie van uw client. Veel clients gebruiken dit formaat:

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

Het formaat kan per client verschillen; gebruik hetzelfde commando en dezelfde argumenten. Kan een client op native Windows npx niet direct starten, gebruik dan het commando cmd met de argumenten /c npx --yes @captionbolt/mcp@0.3.3.

WSL telt als dezelfde computer: installeer de server in de AI-client die binnen WSL draait en verwijs naar Windows-bestanden met paden zoals /mnt/c/Users/<name>/Videos/interview.mp4. De aanmeldlink opent in de Windows-browser.

Start ten slotte de client opnieuw of begin een nieuw gesprek, zodat de CaptionBolt-tools worden geladen.

De autorisatie staat in de referentieopslag van uw systeem en wordt automatisch vernieuwd. Op Linux en WSL zonder sleutelhanger staat ze in ~/.config/captionbolt/mcp-credentials.json, alleen leesbaar voor u. Geen API-sleutel of gekopieerd token nodig. Om haar van deze computer te verwijderen, voert u hetzelfde commando uit met logout in plaats van login.

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.

Ondertitel een video op uw computer

Vraag het in uw eigen woorden en noem het bestand:

Add captions to ~/Videos/interview.mp4

De assistent begint dat bestand te uploaden. Tijdens het uploaden vraagt hij welke ondertitelstijl u wilt en stelt enkele aanbevolen stijlen en uw in CaptionBolt opgeslagen presets voor. Antwoord met een nummer, beschrijf de gewenste look of laat de assistent kiezen.

Na de verwerking wordt de ondertitelde video naast het origineel opgeslagen, bijvoorbeeld als interview.captioned.mp4. Een bestaand bestand wordt nooit vervangen; er wordt een genummerde naam gebruikt. De assistent deelt ook de editorlink van het project. Open die om woorden te corrigeren of de stijl te wijzigen en exporteer opnieuw in CaptionBolt.

Ondertitelbestanden zoals SRT, VTT, ASS en TXT worden met de video geëxporteerd. Vraag ze in hetzelfde verzoek of later:

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

Wilt u de ondertitels vóór de export in de editor controleren, vraag dan eerst om controle.

De lokale server leest alleen het bestand dat u noemt. Hij doorzoekt uw mappen niet, en de video gaat rechtstreeks naar de opslag van CaptionBolt in plaats van naar het AI-gesprek. MP4, MOV, WebM en AVI worden ondersteund. Verwerking gebruikt de minuten en limieten van uw account, net als een upload op de website.

Gebruik CaptionBolt-tools

De lokale server biedt:

| Taak | Tools | | --- | --- | | Video vanaf de computer uploaden | upload_file, get_upload_progress | | Upload pauzeren, hervatten of annuleren | pause_upload, resume_upload, get_upload, abort_upload | | Voltooide export op de computer opslaan | download_result, get_download_progress | | Minuten en limieten controleren | get_account | | Stijlen en opgeslagen presets zoeken | list_styles, list_presets | | Projecten en voortgang bekijken | list_projects, get_project | | Wachten tot de verwerking klaar is | wait_for_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 |

U kunt ook werken met projecten die op de website zijn gemaakt. 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 save the video on my
computer 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.

mode: "review" wacht bij ready, zodat u het project in CaptionBolt kunt controleren; mode: "auto-export" exporteert na verwerking zonder die stop de MP4 en de ondertitelbestanden van uw plan. 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.

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

Verbinden zonder lokale installatie

Gebruik externe MCP als uw client geen lokale servers kan uitvoeren, zoals een webassistent. Externe MCP biedt dezelfde projecttools, maar kan geen bestanden van uw computer uploaden of resultaten daar opslaan. De client moet externe MCP via Streamable HTTP en OAuth-browseraanmelding ondersteunen.

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.

De client regelt OAuth; clients met uitsluitend API-sleutelheaders kunnen niet verbinden. Upload bij externe MCP op de website en gebruik daarna MCP om opgeslagen wijzigingen te bekijken en exporteren. Voor automatisering voltooit u eerst de REST-upload en geeft u het ID als uploadSessionId aan create_project.

Externe MCP accepteert geen video-URL en beheert geen uploadsessies. Geen van beide servers wijzigt ondertitels of visuele instellingen; 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. logout verwijdert alleen de autorisatie van de lokale server van uw computer; verbreek de verbinding in Instellingen om haar in te trekken. Afmelden op de website verbreekt MCP niet. Geen van deze acties annuleert geaccepteerd werk; vraag projectannulering aan.

Los problemen op

| Probleem | Controle | | --- | --- | | Tools ontbreken | Lokale server: Node.js 22.12 of nieuwer, commando en argumenten, daarna client herstarten. Externe MCP: Streamable HTTP, OAuth en exacte URL | | Een tool meldt AUTH_REQUIRED | Voer login opnieuw uit in een terminal en probeer opnieuw | | Aanmelden meldt dat de referentieopslag ontbreekt | Ontgrendel de macOS-sleutelhanger of Windows Referentiebeheer, of verbind met externe MCP | | Browser opent niet | Open op dezelfde computer de autorisatie-URL die de terminal toont | | Na het toestaan bereikt de browser 127.0.0.1 niet | Open de link op de computer waarop login draait, zolang de opdracht nog loopt; voer anders login opnieuw uit | | De client kan npx of node niet starten | Desktop-apps gebruiken mogelijk niet het PATH van uw terminal. Gebruik het volledige pad naar npx of voeg de Node.js-map toe aan het PATH van de server; gebruik op native Windows cmd met /c npx … | | API-sleutel gevraagd | Gebruik de lokale server of de OAuth-aanmelding van de client; sleutels zijn voor REST | | Toegang verbroken of verlopen | Voer login opnieuw uit voor de lokale server of autoriseer opnieuw 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 |

De lokale server vraagt projects:read, projects:write en exports:write aan, plus offline_access voor automatische vernieuwing. Toont een externe client OAuth-scopes, gebruik dan dezelfde; zonder offline_access kan opnieuw aanmelden nodig zijn.

Aanmaken, exporteren, opnieuw proberen en annuleren vereist idempotencyKey: 1–128 afdrukbare ASCII-tekens zonder spaties. Gebruik voor elke nieuwe actie een nieuwe willekeurige waarde, zoals een UUID. 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.