Connectez un assistant AI avec MCP

Connectez votre assistant AI

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

Se connecter manuellement

Utilisez un client compatible avec MCP distant sur Streamable HTTP et OAuth dans le navigateur. Les intégrations sont disponibles avec les abonnements Max.

Ajoutez le serveur distant avec ces informations :

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.

Aucune clé API ni copie manuelle de token : le client gère OAuth. Un client limité aux clés API dans les en-têtes ne peut pas utiliser cet endpoint.

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. Importez une vidéo dans CaptionBolt et recommencez.

Utilisez les outils CaptionBolt

Le serveur fournit :

| Tâche | Outils | | --- | --- | | 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 | | 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 |

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

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

Travaillez avec une nouvelle vidéo

Le plus simple est d’importer sur le site, puis de consulter et exporter les changements enregistrés avec MCP.

Pour automatiser, terminez l’import REST. Passez son ID à create_project dans uploadSessionId.

mode: "review" attend la vérification ; choisissez explicitement mode: "auto-export" pour produire MP4 après traitement. 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.

MCP distant n’importe pas de fichiers locaux, n’accepte pas d’URL vidéo et ne gère pas les sessions d’import. Il ne modifie pas 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. Quitter votre session web laisse MCP connecté. Aucune des deux actions n’annule le travail accepté ; demandez l’annulation du projet.

Résolvez les problèmes

| Problème | À vérifier | | --- | --- | | Outils absents | Streamable HTTP, OAuth, URL exacte et connexion terminée | | Clé API demandée | Choisir OAuth ; les clés API sont pour REST | | Accès déconnecté ou expiré | 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 |

Si le client expose les scopes OAuth, utilisez projects:read, projects:write et exports:write. Incluez offline_access pour le renouvellement, normalement géré par le client. Sans ce scope, 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 clé pour une 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.