Conecte un asistente de AI con MCP

Conecte su asistente de 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

Instalar manualmente

El servidor MCP local de CaptionBolt es el paquete npm @captionbolt/mcp. Funciona con clientes de AI que pueden ejecutar un servidor MCP local por STDIO, como Codex, Claude Code, Claude Desktop, Cursor y VS Code. Requiere Node.js 22.12 o posterior. Las integraciones están disponibles con las suscripciones Max.

Primero, inicie sesión una vez desde una terminal en la computadora que tiene sus videos. Así también se descarga el paquete:

npx --yes @captionbolt/mcp@0.3.3 login

1. CaptionBolt se abre en el navegador. Si no se abre, abra la URL de autorización que aparece en la terminal.
2. Entre en la cuenta cuyos proyectos quiera utilizar y complete la configuración si se solicita.
3. Revise los permisos y seleccione Permitir acceso.
4. Espere a que la terminal confirme que su cuenta está verificada.

Después, añada el servidor a la configuración MCP del cliente. Muchos clientes usan este formato:

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

El formato puede variar según el cliente; use el mismo comando y los mismos argumentos. En Windows nativo, si un cliente no puede iniciar npx directamente, use el comando cmd con los argumentos /c npx --yes @captionbolt/mcp@0.3.3.

WSL cuenta como la misma computadora: instale el servidor en el cliente de AI que se ejecuta dentro de WSL e indique los archivos de Windows con rutas como /mnt/c/Users/<name>/Videos/interview.mp4. El enlace de acceso se abre en el navegador de Windows.

Por último, reinicie el cliente o inicie una conversación nueva para que cargue las herramientas de CaptionBolt.

La autorización se guarda en el almacén de credenciales del sistema y se renueva automáticamente. En Linux y WSL sin llavero, se guarda en ~/.config/captionbolt/mcp-credentials.json, que solo usted puede leer. No necesita una clave API ni copiar tokens. Para quitarla de esta computadora, ejecute el mismo comando con logout en lugar de login.

Verifique la conexión

Pida al asistente:

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

Una conexión correcta lee los límites y lista los proyectos accesibles. Una lista vacía es normal si aún no hay proyectos de video compatibles.

Subtitule un video de su computadora

Pídalo con sus propias palabras e indique el archivo:

Add captions to ~/Videos/interview.mp4

El asistente empieza a subir ese archivo. Mientras se sube, le pregunta qué estilo de subtítulos usar y le sugiere algunos estilos recomendados y los preajustes que guardó en CaptionBolt. Responda con un número, describa el aspecto que quiere o deje que el asistente elija.

Al terminar el procesamiento, el video subtitulado se guarda junto al original, por ejemplo como interview.captioned.mp4. Nunca se reemplaza un archivo existente; se usa un nombre numerado. El asistente también comparte el enlace del proyecto en el editor. Ábralo para corregir palabras o cambiar el estilo y vuelva a exportar en CaptionBolt.

Los archivos de subtítulos como SRT, VTT, ASS y TXT se exportan con el video. Pídalos en la misma solicitud o más tarde:

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

Si quiere revisar los subtítulos en el editor antes de exportar, pida primero la revisión.

El servidor local solo lee el archivo que indique. No examina sus carpetas, y el video va directamente al almacenamiento de CaptionBolt, no a la conversación con la AI. Admite archivos MP4, MOV, WebM y AVI. El procesamiento usa los minutos y límites de su cuenta, igual que una carga desde la web.

Use las herramientas de CaptionBolt

El servidor local ofrece:

| Tarea | Herramientas | | --- | --- | | Subir un video desde la computadora | upload_file, get_upload_progress | | Pausar, reanudar o cancelar una carga | pause_upload, resume_upload, get_upload, abort_upload | | Guardar una exportación terminada en la computadora | download_result, get_download_progress | | Consultar minutos y límites | get_account | | Buscar estilos y preajustes guardados | list_styles, list_presets | | Listar proyectos y ver progreso | list_projects, get_project | | Esperar a que termine el procesamiento | wait_for_project | | Comprobar una acción | get_operation | | Crear un proyecto desde una carga completa | create_project | | Exportar cambios guardados | export_project | | Reintentar o cancelar | retry_project, cancel_project | | Obtener enlaces de exportaciones terminadas | get_result |

También puede trabajar con proyectos creados en la web. Por ejemplo:

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

Después de revisar y guardar en 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.

Sustituya <project-id> por un ID devuelto. Una operación completed confirma la acción, pero el video puede seguir procesándose. Consulte hasta ready para revisar o completed para descargar. Deténgase ante fallos; respete pollAfterSeconds y deje de consultar los proyectos cancelados.

mode: "review" espera en ready para que revise el proyecto en CaptionBolt; mode: "auto-export" exporta tras el procesamiento, sin esa pausa, el MP4 y los archivos de subtítulos de su plan. Crear o cambiar proyectos requiere escritura; exportar y autoexportar también requiere permiso de exportación.

Si la exportación automática queda en ready, consulte autoExport.state y autoExport.error con get_project. Si falla, informe y deténgase; no espere indefinidamente ni exporte de nuevo sin instrucciones.

Guarde primero en el editor. Un proyecto terminado conserva su exportación; cree una copia editable para modificarlo. Pedir un formato que no tiene devuelve un error de inmediato. Los enlaces duran como máximo diez minutos y se renuevan dentro de los 14 días de acceso.

Conectar sin instalación local

Use MCP remoto cuando el cliente no pueda ejecutar servidores locales, por ejemplo un asistente web. MCP remoto ofrece las mismas herramientas de proyecto, pero no puede subir archivos de su computadora ni guardar resultados en ella. El cliente debe admitir MCP remoto mediante Streamable HTTP y OAuth en el navegador.

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

Son datos de conexión, no un archivo de configuración. Los campos y formatos dependen del cliente; algunos llaman HTTP al transporte. Use la URL exacta sin barra final.

1. Añada el servidor en la configuración MCP del cliente.
2. Inicie la acción de acceso o autorización; abrirá CaptionBolt en el navegador.
3. Entre en la cuenta cuyos proyectos quiera utilizar y complete la configuración si se solicita.
4. Revise los permisos y seleccione Permitir acceso.
5. Vuelva al cliente y compruebe que las herramientas están disponibles.

El cliente gestiona OAuth; los clientes que solo admiten claves API en cabeceras no pueden conectar con este endpoint. Con MCP remoto, cargue el video en la web de CaptionBolt y use MCP para consultar el proyecto y exportar los cambios guardados. Para automatizar, complete antes la carga REST y pase el ID de carga como uploadSessionId a create_project.

MCP remoto no acepta URL de video ni gestiona sesiones de carga. Ningún servidor edita subtítulos o ajustes visuales: use el editor. Configure avisos mediante Webhooks.

Gestione la conexión

Consulte y desconecte sus conexiones autorizadas en Configuración → Integraciones.

Desconectar bloquea nuevas solicitudes, incluso con tokens guardados. logout solo elimina de su computadora la autorización del servidor local; para revocarla, desconecte en Configuración. Cerrar sesión en la web no desconecta MCP. Ninguna de estas acciones cancela tareas aceptadas; solicite la cancelación del proyecto para detenerlas.

Resuelva problemas

| Problema | Qué comprobar | | --- | --- | | No aparecen herramientas | Servidor local: Node.js 22.12 o posterior, comando y argumentos; luego reiniciar el cliente. MCP remoto: compatibilidad con Streamable HTTP y OAuth, y URL exacta | | Una herramienta devuelve AUTH_REQUIRED | Ejecutar de nuevo login en una terminal y reintentar | | El acceso indica que el almacén de credenciales no está disponible | Desbloquear el Llavero de macOS o el Administrador de credenciales de Windows, o conectar con MCP remoto | | No se abre el navegador | Abrir en la misma computadora la URL de autorización que muestra la terminal | | Tras permitir el acceso, el navegador no llega a 127.0.0.1 | Abrir el enlace en la computadora que ejecuta login mientras el comando sigue activo; si se detuvo, ejecutar de nuevo login | | El cliente no puede iniciar npx o node | Las apps de escritorio pueden no usar el PATH de la terminal. Usar la ruta completa de npx o añadir la carpeta de Node.js al PATH del servidor; en Windows nativo, usar cmd con /c npx … | | Se pide una clave API | Usar el servidor local o el acceso OAuth del cliente; las claves API son para REST | | Acceso desconectado o caducado | Ejecutar de nuevo login en el servidor local o volver a autorizar en el cliente | | Acción denegada | Permisos aprobados y límites actuales | | Solicitudes limitadas | Esperar el intervalo indicado | | Proyecto fallido | Leer el error antes de reintentar; consultar estados y errores |

El servidor local solicita projects:read, projects:write y exports:write, además de offline_access para renovar automáticamente. Si un cliente remoto expone scopes OAuth, use los mismos; sin offline_access, puede necesitar volver a entrar cuando caduque el acceso.

Crear, exportar, reintentar y cancelar requiere idempotencyKey: 1–128 caracteres ASCII imprimibles sin espacios. Use un valor aleatorio nuevo, como un UUID, para cada acción nueva. Tras un timeout, consulte una operación conocida o repita la llamada idéntica con la clave original. Un retry_project explícito tras un fallo confirmado es una acción nueva y necesita otra clave.

Los errores de herramientas exponen structuredContent.error con message y kind, además de status, code, requestId y retryAfterSeconds cuando están disponibles. Respete el intervalo; no repita continuamente una herramienta que falla.