Conecte um assistente de AI com MCP

Conecte seu assistente 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

O servidor MCP local do CaptionBolt é o pacote npm @captionbolt/mcp. Ele funciona com clientes de AI que executam um servidor MCP local via STDIO, como Codex, Claude Code, Claude Desktop, Cursor e VS Code. Requer Node.js 22.12 ou posterior. As integrações estão disponíveis nas assinaturas Max.

Primeiro, entre uma vez por um terminal no computador que tem seus vídeos. Isso também baixa o pacote:

npx --yes @captionbolt/mcp@0.3.3 login

1. O navegador abre o CaptionBolt. Se não abrir, abra a URL de autorização mostrada no terminal.
2. Entre na conta dos projetos e conclua a configuração quando solicitado.
3. Confira permissões e selecione Permitir acesso.
4. Aguarde o terminal confirmar que sua conta foi verificada.

Depois, adicione o servidor à configuração MCP do cliente. Muitos clientes usam este formato:

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

O formato pode variar por cliente; use o mesmo comando e os mesmos argumentos. No Windows nativo, se um cliente não conseguir iniciar npx diretamente, use o comando cmd com os argumentos /c npx --yes @captionbolt/mcp@0.3.3.

O WSL conta como o mesmo computador: instale o servidor no cliente de AI que roda dentro do WSL e indique arquivos do Windows com caminhos como /mnt/c/Users/<name>/Videos/interview.mp4. O link de login abre no navegador do Windows.

Por fim, reinicie o cliente ou inicie uma nova conversa para carregar as ferramentas do CaptionBolt.

A autorização fica salva no armazenamento de credenciais do sistema e é renovada automaticamente. No Linux e no WSL sem chaveiro, ela fica em ~/.config/captionbolt/mcp-credentials.json, legível só por você. Não precisa de chave API nem copiar token. Para removê-la deste computador, execute o mesmo comando com logout no lugar de login.

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.

Legende um vídeo do seu computador

Peça com suas palavras e indique o arquivo:

Add captions to ~/Videos/interview.mp4

O assistente começa a enviar esse arquivo. Durante o envio, pergunta qual estilo de legenda usar e sugere alguns estilos recomendados e as predefinições salvas no CaptionBolt. Responda com um número, descreva o visual que quer ou deixe o assistente escolher.

Ao fim do processamento, o vídeo legendado é salvo ao lado do original, por exemplo como interview.captioned.mp4. Um arquivo existente nunca é substituído; um nome numerado é usado. O assistente também compartilha o link do projeto no editor. Abra-o para corrigir palavras ou trocar o estilo e exporte novamente no CaptionBolt.

Arquivos de legenda como SRT, VTT, ASS e TXT são exportados com o vídeo. Peça por eles no mesmo pedido ou depois:

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

Para revisar as legendas no editor antes de exportar, peça primeiro a revisão.

O servidor local lê apenas o arquivo indicado. Ele não varre suas pastas, e o vídeo vai direto para o armazenamento do CaptionBolt, não para a conversa com a AI. São aceitos arquivos MP4, MOV, WebM e AVI. O processamento usa os minutos e limites da sua conta, como um envio pelo site.

Use as ferramentas do CaptionBolt

O servidor local oferece:

| Tarefa | Ferramentas | | --- | --- | | Enviar um vídeo do computador | upload_file, get_upload_progress | | Pausar, retomar ou cancelar um envio | pause_upload, resume_upload, get_upload, abort_upload | | Salvar uma exportação concluída no computador | download_result, get_download_progress | | Consultar minutos e limites | get_account | | Buscar estilos e predefinições salvas | list_styles, list_presets | | Listar projetos e progresso | list_projects, get_project | | Aguardar o fim do processamento | wait_for_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 |

Também é possível usar projetos criados no site. 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 save the video on my
computer 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.

mode: "review" aguarda em ready para você revisar o projeto no CaptionBolt; mode: "auto-export" exporta após o processamento, sem essa pausa, o MP4 e os arquivos de legenda do seu plano. 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.

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

Conectar sem instalação local

Use MCP remoto quando o cliente não puder executar servidores locais, como um assistente na web. O MCP remoto tem as mesmas ferramentas de projeto, mas não envia arquivos do seu computador nem salva resultados nele. O cliente precisa aceitar MCP remoto por Streamable HTTP e login OAuth pelo navegador.

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.

O cliente gerencia OAuth; clientes que só aceitam cabeçalhos com chave API não conectam a esse endpoint. Com MCP remoto, envie o vídeo no site e depois consulte e exporte alterações salvas com MCP. Para automatizar, conclua antes o envio REST e passe o ID como uploadSessionId para create_project.

O MCP remoto não aceita URL de vídeo e não gerencia sessões de envio. Nenhum dos servidores 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. logout remove apenas a autorização do servidor local do seu computador; para revogá-la, desconecte nas configurações. Sair do site não desconecta MCP. Nenhuma dessas ações cancela tarefas aceitas; solicite o cancelamento do projeto para parar.

Resolva problemas

| Problema | Verifique | | --- | --- | | Ferramentas não aparecem | Servidor local: Node.js 22.12 ou posterior, comando e argumentos, depois reinicie o cliente. MCP remoto: Streamable HTTP, OAuth e URL exata | | Uma ferramenta retorna AUTH_REQUIRED | Execute login de novo em um terminal e tente outra vez | | O login informa que o armazenamento de credenciais está indisponível | Desbloqueie as Chaves do macOS ou o Gerenciador de Credenciais do Windows, ou conecte com MCP remoto | | O navegador não abre | Abra no mesmo computador a URL de autorização mostrada no terminal | | Depois de permitir o acesso, o navegador não alcança 127.0.0.1 | Abra o link no computador que executa login, enquanto o comando ainda está rodando; se ele parou, execute login de novo | | O cliente não consegue iniciar npx ou node | Apps de desktop podem não usar o PATH do terminal. Use o caminho completo do npx ou adicione a pasta do Node.js ao PATH do servidor; no Windows nativo, use cmd com /c npx … | | Cliente pede chave API | Use o servidor local ou o login OAuth do cliente; chaves API são para REST | | Acesso desconectado ou expirado | Execute login de novo no servidor local ou 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 |

O servidor local solicita projects:read, projects:write e exports:write, além de offline_access para renovação automática. Se um cliente remoto expuser scopes OAuth, use os mesmos; sem offline_access, poderá precisar entrar novamente após a expiração.

Criar, exportar, tentar novamente e cancelar exige idempotencyKey: 1–128 caracteres ASCII imprimíveis sem espaços. Use um novo valor aleatório, como um UUID, para cada nova ação. 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.