Conecta un asistente de AI con MCP

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

Conectar manualmente

Use un cliente compatible con MCP remoto mediante Streamable HTTP y OAuth en el navegador. Las integraciones están disponibles con las suscripciones Max.

Añada un servidor MCP remoto con estos datos:

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.

No necesita una clave API ni copiar tokens: el cliente gestiona OAuth. Los clientes que solo admiten claves API en cabeceras no pueden conectar con este endpoint.

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. Cargue un video en CaptionBolt y vuelva a consultar.

Use las herramientas de CaptionBolt

El servidor remoto ofrece:

| Tarea | Herramientas | | --- | --- | | 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 | | 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 |

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

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

Trabaje con un video nuevo

Lo más sencillo es cargarlo en la web de CaptionBolt y usar MCP para consultar y exportar los cambios guardados.

Para automatizar, complete antes la carga REST. Pase el ID de carga como uploadSessionId a create_project.

mode: "review" espera la revisión; elija explícitamente mode: "auto-export" para generar MP4 tras el procesamiento. 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.

MCP remoto no carga archivos locales, no acepta URL de video ni gestiona sesiones de carga. No 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. Cerrar sesión en la web no desconecta MCP. Ninguna acción cancela tareas aceptadas; solicite la cancelación del proyecto para detenerlas.

Resuelva problemas

| Problema | Qué comprobar | | --- | --- | | No aparecen herramientas | Compatibilidad con Streamable HTTP y OAuth, URL exacta y acceso finalizado | | Se pide una clave API | Elegir OAuth; las claves API son para REST | | Acceso desconectado o caducado | 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 |

Si el cliente expone scopes OAuth, use projects:read, projects:write y exports:write. Incluya offline_access para renovar automáticamente; normalmente lo gestiona el cliente. Sin él, puede necesitar volver a entrar cuando caduque el acceso.

Crear, exportar, reintentar y cancelar requiere idempotencyKey: 1–128 caracteres ASCII imprimibles sin espacios. Use otra clave para otra acción. 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.