Conecte um assistente de AI com MCP

Conecte seu assistente 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 um cliente com MCP remoto por Streamable HTTP e login OAuth pelo navegador. As integrações estão disponíveis nas assinaturas Max.

Adicione o servidor com estes dados:

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

São dados de conexão, não um arquivo de configuração. Campos e formato variam por cliente; alguns chamam o transporte de HTTP. Use a URL exata sem barra final.

1. Adicione o servidor nas configurações MCP do cliente.
2. Inicie login ou autorização; o navegador abrirá CaptionBolt.
3. Entre na conta dos projetos e conclua a configuração quando solicitado.
4. Confira permissões e selecione Permitir acesso.
5. Volte ao cliente e confirme as ferramentas disponíveis.

Não precisa de chave API ou copiar token. O cliente gerencia OAuth. Clientes que só aceitam cabeçalhos com chave API não conectam a esse endpoint.

Verifique a conexão

Peça ao assistente:

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

Uma conexão correta lê limites e lista projetos acessíveis. A lista vazia é normal sem projetos de vídeo elegíveis. Envie um vídeo no CaptionBolt e consulte novamente.

Use as ferramentas do CaptionBolt

O servidor oferece:

| Tarefa | Ferramentas | | --- | --- | | Consultar minutos e limites | get_account | | Buscar estilos e predefinições salvas | list_styles, list_presets | | Listar projetos e progresso | list_projects, get_project | | Conferir uma ação | get_operation | | Criar projeto de envio concluído | create_project | | Exportar alterações salvas | export_project | | Tentar novamente ou cancelar | retry_project, cancel_project | | Obter links de exportações concluídas | get_result |

Por exemplo:

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

Após revisar e salvar no 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.

Troque <project-id> por um ID retornado. Operação completed confirma a ação, mas o vídeo pode continuar processando ou exportando. Consulte até ready para revisar ou completed para baixar. Pare e leia erros; respeite pollAfterSeconds e pare em projetos cancelados.

Salve no editor antes de exportar. Projetos concluídos mantêm a exportação; crie cópia editável para alterar. Links duram no máximo dez minutos e podem ser renovados nos 14 dias de acesso.

Trabalhe com um novo vídeo

O caminho simples é enviar no site, depois consultar e exportar alterações salvas com MCP.

Para automatizar, conclua o envio REST. Passe o ID como uploadSessionId para create_project.

mode: "review" aguarda revisão; escolha explicitamente mode: "auto-export" para exportar MP4 após processar. Criar ou alterar exige escrita; exportação e exportação automática também exigem permissão de exportação.

Se a exportação automática ficar em ready, veja autoExport.state e autoExport.error com get_project. Se falhar, informe e pare; não espere indefinidamente nem exporte novamente sem instruções.

MCP remoto não envia arquivos locais, não aceita URL de vídeo e não gerencia sessões de envio. Não edita legendas ou ajustes visuais: use o editor. Configure avisos com Webhooks.

Gerencie a conexão

Veja e desconecte conexões autorizadas em Configurações → Integrações.

Desconectar bloqueia novas solicitações, inclusive tokens salvos. Sair do site não desconecta MCP. Nenhuma ação cancela tarefas aceitas; solicite o cancelamento do projeto para parar.

Resolva problemas

| Problema | Verifique | | --- | --- | | Ferramentas não aparecem | Streamable HTTP e OAuth, URL exata e login concluído | | Cliente pede chave API | Escolha OAuth; chaves API são para REST | | Acesso desconectado ou expirado | Autorize novamente no cliente | | Ação negada | Permissões aprovadas e limites atuais | | Solicitações limitadas | Aguarde o intervalo retornado | | Projeto falhou | Leia o erro antes de repetir; veja estados e erros |

Se o cliente expuser scopes OAuth, use projects:read, projects:write e exports:write. Inclua offline_access para renovar, normalmente gerenciado pelo cliente. Sem isso, poderá precisar entrar novamente após expiração.

Criar, exportar, tentar novamente e cancelar exige idempotencyKey: 1–128 caracteres ASCII imprimíveis sem espaços. Nova ação, nova chave. Após timeout, consulte operação conhecida ou repita chamada idêntica com a chave original. retry_project após falha confirmada é outra ação e precisa de nova chave.

Erros de ferramentas expõem structuredContent.error com message e kind, além de status, code, requestId e retryAfterSeconds quando disponíveis. Respeite o intervalo, sem repetir continuamente uma ferramenta com erro.