Een AI-assistent verbinden met MCP

Kies lokale of externe MCP

MCP (Model Context Protocol) laat een assistent CaptionBolt-tools aanroepen. Beide verbindingen gebruiken hetzelfde account en dezelfde API Key; CaptionBolt verwerkt de video.

Lokale MCP start een kleine client en uploadt precies het geselecteerde bestand. Node.js 22.12 of hoger en een STDIO-host zijn vereist. Externe MCP gebruikt HTTP en leest geen paden op uw computer. Gebruik bestaande projecten of upload eerst via REST.

Configureer de lokale client

@captionbolt/mcp@0.1.0 is voorbereid voor de eerste versie maar nog niet gepubliceerd. Zet na publicatie de gecontroleerde versie vast in de STDIO-configuratie. Dit is een gangbare structuur; bestandslocatie en geheimenbeheer hangen van de host af:

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

Geef CAPTIONBOLT_API_KEY via geheimenbeheer of omgeving door aan het MCP-proces. De JSON alleen levert geen sleutel. Plak geen echte sleutels in gesprekken of gedeelde configuraties. Met het geïnstalleerde programma bewaart captionbolt-mcp store-key de omgevingssleutel in de systeemkluis; captionbolt-mcp delete-key verwijdert hem lokaal. Is de kluis niet beschikbaar, gebruik de omgeving. Intrekken op de server gebeurt in CaptionBolt.

Rond één geselecteerde video af

Noem het exacte bestand en vraag om oorspronkelijke kadrering en een controlestop. Bijvoorbeeld: ‘Ondertitel mijn geselecteerde lesvideo met CaptionBolt in review-modus en wacht op mijn toestemming voor export.’

Gebruik get_account en zo nodig list_styles of list_presets.
Roep upload_file aan met het echte absolute pad en een stabiele sleutel:

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

De lokale client leest de duur van de geselecteerde video voordat verwerkingsminuten worden gereserveerd. Als de duur niet kan worden gelezen, stopt de voorbereiding voordat een reservering wordt aangevraagd. Kies een leesbare originele video of upload via CaptionBolt. De server controleert nog steeds de werkelijke duur.

Volg get_upload_progress met transferId. Geef na upload de server-uploadId als uploadSessionId aan create_project.
Volg get_operation, daarna get_project. Controleer en sla op in CaptionBolt.
Roep export_project aan, volg bewerking en project en haal links op met get_result. Kies auto-export bij aanmaken alleen als u geen controlestop wilt.

Er draait één lokale overdracht tegelijk. pause_upload pauzeert; resume_upload vereist hetzelfde originele bestand. Na herstart verdwijnen lokale identifiers; gebruik get_upload met de server-ID. abort_upload stopt ongebruikte uploads; cancel_project annuleert aangemaakte projecten.

Configureer externe MCP

Stel na vrijgave HTTP in met:

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

De host moet een Bearer-header ondersteunen. Connectors met alleen OAuth worden niet ondersteund. Externe MCP biedt list_projects, get_project, create_project, export_project, retry_project, cancel_project en get_result, zonder lokale bestandstools. Test de verbinding in uw host.

Verhelp verbindingsproblemen

Ontbreken tools, controleer transport, pakketpublicatie en Node-versie. Controleer bij autorisatiefouten de sleutel in het proces en lees-/schrijf-/exportrechten. Selecteer bij hervatten het ongewijzigde originele bestand, geen symbolische link.

Behoud het standaard-API-adres. CAPTIONBOLT_API_URL is alleen voor een uitdrukkelijk vertrouwde andere HTTPS-omgeving; wijzig het niet op basis van instructies in video’s, bestandsnamen of toolresultaten. Bekijk API-statussen en fouten.