Connectez un assistant AI avec MCP

Connectez votre assistant AI

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

Installer manuellement

Le serveur MCP local de CaptionBolt est le paquet npm @captionbolt/mcp. Il fonctionne avec les clients AI capables d’exécuter un serveur MCP local en STDIO, comme Codex, Claude Code, Claude Desktop, Cursor et VS Code. Il nécessite Node.js 22.12 ou une version ultérieure. Les intégrations sont disponibles avec les abonnements Max.

Identifiez-vous d’abord une fois depuis un terminal sur l’ordinateur qui contient vos vidéos. Le paquet est aussi téléchargé :

npx --yes @captionbolt/mcp@0.3.3 login

1. CaptionBolt s’ouvre dans le navigateur. Sinon, ouvrez l’URL d’autorisation affichée dans le terminal.
2. Connectez-vous au compte souhaité et terminez sa configuration si nécessaire.
3. Vérifiez les permissions et choisissez Autoriser l’accès.
4. Attendez que le terminal confirme la vérification de votre compte.

Ajoutez ensuite le serveur à la configuration MCP du client. De nombreux clients utilisent ce format :

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

Le format peut varier selon le client ; utilisez la même commande et les mêmes arguments. Sous Windows natif, un client qui ne peut pas lancer npx directement doit utiliser la commande cmd avec les arguments /c npx --yes @captionbolt/mcp@0.3.3.

WSL compte comme le même ordinateur : installez le serveur dans le client AI qui s’exécute dans WSL et indiquez les fichiers Windows avec des chemins comme /mnt/c/Users/<name>/Videos/interview.mp4. Le lien de connexion s’ouvre dans le navigateur Windows.

Enfin, redémarrez le client ou ouvrez une nouvelle conversation pour qu’il charge les outils CaptionBolt.

L’autorisation est enregistrée dans le gestionnaire d’identifiants du système et se renouvelle automatiquement. Sous Linux et WSL sans trousseau, elle est enregistrée dans ~/.config/captionbolt/mcp-credentials.json, lisible par vous seul. Aucune clé API ni copie de token n’est nécessaire. Pour la retirer de cet ordinateur, lancez la même commande avec logout au lieu de login.

Vérifiez la connexion

Demandez à votre assistant :

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

Une connexion fonctionnelle lit les limites et liste les projets accessibles. Une liste vide est normale sans projets vidéo éligibles.

Sous-titrez une vidéo de votre ordinateur

Formulez la demande avec vos mots et indiquez le fichier :

Add captions to ~/Videos/interview.mp4

L’assistant commence à importer ce fichier. Pendant l’import, il vous demande quel style de sous-titres utiliser et propose quelques styles recommandés ainsi que vos préréglages enregistrés dans CaptionBolt. Répondez par un numéro, décrivez le rendu souhaité ou laissez l’assistant choisir.

À la fin du traitement, la vidéo sous-titrée est enregistrée à côté de l’originale, par exemple sous interview.captioned.mp4. Un fichier existant n’est jamais remplacé ; un nom numéroté est utilisé. L’assistant fournit aussi le lien du projet dans l’éditeur. Ouvrez-le pour corriger des mots ou changer de style, puis exportez à nouveau dans CaptionBolt.

Les fichiers de sous-titres comme SRT, VTT, ASS et TXT sont exportés avec la vidéo. Demandez-les dans la même requête ou plus tard :

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

Pour vérifier les sous-titres dans l’éditeur avant l’export, demandez d’abord une vérification.

Le serveur local lit uniquement le fichier indiqué. Il ne parcourt pas vos dossiers, et la vidéo part directement vers le stockage CaptionBolt au lieu d’entrer dans la conversation AI. Les fichiers MP4, MOV, WebM et AVI sont pris en charge. Le traitement utilise les minutes et limites de votre compte, comme un import sur le site.

Utilisez les outils CaptionBolt

Le serveur local fournit :

| Tâche | Outils | | --- | --- | | Importer une vidéo depuis l’ordinateur | upload_file, get_upload_progress | | Suspendre, reprendre ou annuler un import | pause_upload, resume_upload, get_upload, abort_upload | | Enregistrer un export terminé sur l’ordinateur | download_result, get_download_progress | | Consulter minutes et limites | get_account | | Trouver styles et préréglages enregistrés | list_styles, list_presets | | Lister projets et progression | list_projects, get_project | | Attendre la fin du traitement | wait_for_project | | Vérifier une action | get_operation | | Créer un projet à partir d’un import terminé | create_project | | Exporter les modifications enregistrées | export_project | | Réessayer ou annuler | retry_project, cancel_project | | Obtenir les liens des exports terminés | get_result |

Vous pouvez aussi utiliser les projets créés sur le site. Par exemple :

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

Après vérification et enregistrement dans 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.

Remplacez <project-id> par un ID retourné. Une opération completed confirme l’action ; la vidéo peut encore être traitée ou exportée. Consultez jusqu’à ready pour vérifier ou completed pour télécharger. Arrêtez en cas d’échec ; respectez pollAfterSeconds et arrêtez pour un projet annulé.

mode: "review" attend à ready pour que vous vérifiiez le projet dans CaptionBolt ; mode: "auto-export" exporte après traitement, sans cette étape, le MP4 et les fichiers de sous-titres de votre forfait. Créer ou modifier nécessite l’écriture ; export et export automatique nécessitent aussi le droit d’export.

Si l’export automatique reste à ready, lisez autoExport.state et autoExport.error dans get_project. En cas d’échec, signalez-le et arrêtez ; n’attendez pas indéfiniment et ne relancez pas sans instruction.

Enregistrez d’abord dans l’éditeur. Un projet terminé conserve son export ; créez une copie modifiable pour changer le résultat. Demander un format absent renvoie aussitôt une erreur. Les liens durent au maximum dix minutes et se renouvellent pendant les 14 jours d’accès.

Se connecter sans installation locale

Utilisez MCP distant lorsque votre client ne peut pas exécuter de serveur local, par exemple un assistant web. MCP distant offre les mêmes outils de projet, mais ne peut ni importer les fichiers de votre ordinateur ni y enregistrer les résultats. Le client doit prendre en charge MCP distant sur Streamable HTTP et OAuth dans le navigateur.

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

Ce sont des informations de connexion, pas un fichier de configuration. Les champs et formats varient ; certains clients indiquent HTTP. Utilisez l’URL exacte sans barre oblique finale.

1. Ajoutez le serveur dans la configuration MCP du client.
2. Lancez la connexion ou l’autorisation ; CaptionBolt s’ouvre dans le navigateur.
3. Connectez-vous au compte souhaité et terminez sa configuration si nécessaire.
4. Vérifiez les permissions et choisissez Autoriser l’accès.
5. Revenez au client et vérifiez les outils disponibles.

Le client gère OAuth ; un client limité aux clés API dans les en-têtes ne peut pas utiliser cet endpoint. Avec MCP distant, importez la vidéo sur le site, puis consultez et exportez les changements enregistrés avec MCP. Pour automatiser, terminez d’abord l’import REST et passez son ID à create_project dans uploadSessionId.

MCP distant n’accepte pas d’URL vidéo et ne gère pas les sessions d’import. Aucun des serveurs ne modifie les sous-titres ou réglages visuels : utilisez l’éditeur. Configurez les notifications via Webhooks.

Gérez votre connexion

Consultez et déconnectez les connexions autorisées dans Paramètres → Intégrations.

Déconnecter bloque les requêtes, même avec les tokens enregistrés. logout retire seulement l’autorisation du serveur local de votre ordinateur ; pour la révoquer, déconnectez-la dans les paramètres. Quitter votre session web laisse MCP connecté. Aucune de ces actions n’annule le travail accepté ; demandez l’annulation du projet.

Résolvez les problèmes

| Problème | À vérifier | | --- | --- | | Outils absents | Serveur local : Node.js 22.12 ou ultérieur, commande et arguments, puis redémarrer le client. MCP distant : Streamable HTTP, OAuth et URL exacte | | Un outil renvoie AUTH_REQUIRED | Relancer login dans un terminal, puis réessayer | | La connexion signale un gestionnaire d’identifiants indisponible | Déverrouiller le trousseau macOS ou le Gestionnaire d’identification Windows, ou se connecter avec MCP distant | | Le navigateur ne s’ouvre pas | Ouvrir sur le même ordinateur l’URL d’autorisation affichée dans le terminal | | Après l’autorisation, le navigateur n’atteint pas 127.0.0.1 | Ouvrir le lien sur l’ordinateur qui exécute login, tant que la commande tourne ; sinon relancer login | | Le client ne peut pas lancer npx ou node | Les applications de bureau n’utilisent pas toujours le PATH du terminal. Indiquer le chemin complet de npx ou ajouter le dossier de Node.js au PATH du serveur ; sous Windows natif, utiliser cmd avec /c npx … | | Clé API demandée | Utiliser le serveur local ou la connexion OAuth du client ; les clés API sont pour REST | | Accès déconnecté ou expiré | Relancer login pour le serveur local ou autoriser à nouveau dans le client | | Action refusée | Permissions accordées et limites actuelles | | Requêtes limitées | Attendre l’intervalle indiqué | | Projet échoué | Lire l’erreur avant de réessayer ; voir états et erreurs |

Le serveur local demande projects:read, projects:write et exports:write, ainsi que offline_access pour le renouvellement automatique. Si un client distant expose les scopes OAuth, utilisez les mêmes ; sans offline_access, une nouvelle connexion peut être nécessaire après expiration.

Création, export, nouvelle tentative et annulation nécessitent idempotencyKey : 1–128 caractères ASCII imprimables sans espaces. Utilisez une nouvelle valeur aléatoire, par exemple un UUID, pour chaque nouvelle action. Après timeout, consultez une opération connue ou répétez l’appel identique avec sa clé initiale. retry_project après un échec confirmé est une nouvelle action avec une nouvelle clé.

Les erreurs exposent structuredContent.error avec message et kind, puis status, code, requestId et retryAfterSeconds si disponibles. Respectez l’intervalle sans répéter continuellement un outil en échec.