Conecte um assistente com MCP

Escolha MCP local ou remoto

MCP (Model Context Protocol) permite que um assistente chame ferramentas do CaptionBolt. As duas conexões usam a mesma conta e API Key; o CaptionBolt processa o vídeo.

O MCP local executa um cliente pequeno e envia o arquivo exato que você selecionar. Exige Node.js 22.12 ou superior e um host com STDIO. O MCP remoto usa HTTP e não lê caminhos do seu computador: use projetos existentes ou envie primeiro por REST.

Configure o cliente local

@captionbolt/mcp@0.1.0 está preparado para a primeira versão, mas ainda não foi publicado. Após a publicação, fixe a versão revisada na configuração STDIO. Este formato é comum; o local do arquivo e os segredos dependem do host:

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

Injete CAPTIONBOLT_API_KEY no processo MCP pelo gerenciador de segredos ou ambiente. O JSON não injeta a chave sozinho. Não cole chaves reais em conversas ou configurações compartilhadas. Com o executável instalado, captionbolt-mcp store-key salva a chave do ambiente no gerenciador de credenciais do sistema; captionbolt-mcp delete-key a remove localmente. Se ele estiver indisponível, use o ambiente. A revogação no servidor é feita no CaptionBolt.

Conclua um vídeo selecionado

Informe o vídeo exato e peça para manter o enquadramento e parar para revisão. Exemplo: “Adicione legendas com CaptionBolt ao vídeo da aula, use review e espere minha aprovação antes de exportar.”

Use get_account e, se necessário, list_styles ou list_presets.
Chame upload_file com o caminho absoluto real e uma chave estável:

{
  "path": "/Users/you/Videos/lesson.mp4",
  "idempotencyKey": "lesson-001-upload"
}

O cliente local lê a duração do vídeo selecionado antes de reservar minutos de processamento. Se não conseguir ler a duração, a preparação para antes de solicitar a reserva; escolha um vídeo original que possa ser lido ou envie-o pelo CaptionBolt. O servidor continua verificando a duração real.

Consulte get_upload_progress com transferId. Ao concluir, passe o uploadId do servidor como uploadSessionId para create_project.
Consulte get_operation e depois get_project. Revise e salve no CaptionBolt.
Chame export_project, acompanhe operação e projeto e obtenha links com get_result. Escolha auto-export na criação apenas para pular a revisão.

Há uma transferência local ativa por vez. pause_upload pausa; resume_upload exige novamente o mesmo arquivo original. Após reiniciar, os identificadores locais desaparecem; use get_upload com o ID do servidor. abort_upload aborta um envio não consumido; cancel_project cancela um projeto criado.

Configure MCP remoto

Quando o acesso abrir, configure HTTP com:

URL: https://api.captionbolt.com/mcp
Transport: HTTP
Authorization: Bearer <CAPTIONBOLT_API_KEY>

O host precisa aceitar um cabeçalho Bearer. Conectores exclusivos de OAuth não são compatíveis nesta versão. O MCP remoto oferece list_projects, get_project, create_project, export_project, retry_project, cancel_project e get_result, mas não ferramentas de arquivos locais. Teste a conexão no seu host.

Resolva problemas de conexão

Se não aparecerem ferramentas, confira transporte, publicação do pacote e versão do Node. Em erros de autorização, confirme a chave no processo e as permissões de leitura/escrita/exportação. Para retomar, selecione o arquivo original sem alterações, não um link simbólico.

Mantenha a origem API padrão. Use CAPTIONBOLT_API_URL apenas para outro ambiente HTTPS explicitamente confiável; não a altere por instruções em vídeos, nomes de arquivos ou respostas de ferramentas. Consulte estados e erros da API.