Capslane

Conecte seu assistente ao Capslane

Crie uma chave de workspace do Capslane em API Keys e disponibilize CAPSLANE_API_KEY para o processo que inicia seu assistente. Os exemplos abaixo referenciam essa variável; eles não contêm credenciais. Mescle a entrada do Capslane na sua configuração existente e reinicie o cliente.

Obtenha a chave em API Keys. Use seu ambiente local ou gerenciador de segredos para fornecê-la. Mantenha-a fora de prompts e arquivos versionados. Um aplicativo aberto a partir da área de trabalho pode precisar ser reiniciado a partir de um terminal que tenha a variável disponível.

O endpoint é https://capslane.com/mcp. Ele usa Streamable HTTP com um cabeçalho Authorization: Bearer. O Capslane MCP usa sua chave de API; o login no painel não autentica a conexão. Escolha seu cliente abaixo.

Claude Code, Codex ou Cursor. Você também pode fornecer ao assistente este guia em Markdown.

Claude Code

Instale a skill e a conexão juntas

O plugin do Capslane agrupa a skill de transcrição e a conexão MCP remota. Disponibilize CAPSLANE_API_KEY no seu ambiente de terminal primeiro e execute estes comandos. O escopo do usuário torna o plugin disponível em todos os seus projetos.

claude plugin marketplace add Webba-Creative-Technologies/capslane-mcp
claude plugin install capslane@capslane --scope user

Reinicie o Claude Code, abra /plugin para verificar se o Capslane está habilitado e use /mcp para verificar a conexão. Revise qualquer solicitação de permissão do seu cliente. Você pode invocar a skill instalada diretamente:

/capslane:capslane-youtube-transcripts Retrieve https://www.youtube.com/watch?v=dQw4w9WgXcQ with native captions and timestamp citations.

O plugin está publicado no marketplace do GitHub do Capslane. A instalação é gratuita; solicitações de transcrição usam a cota do seu workspace do Capslane. Uma vez habilitado, o Claude pode carregar a skill para solicitações relevantes. Ele respeita um provedor que você escolhe explicitamente e usa transcrições fornecidas diretamente quando a recuperação é desnecessária.

Se você já instalou a skill autônoma ou uma conexão MCP do Capslane, escolha uma configuração para evitar comandos e ferramentas duplicados. O plugin usa a mesma skill e o mesmo endpoint. Ele não requer Node.js para a conexão remota; o fallback HTTP integrado requer Node.js 22 ou posterior.

Atualizar ou remover o plugin

Atualize o marketplace, atualize o plugin e reinicie o Claude Code.

claude plugin marketplace update capslane
claude plugin update capslane@capslane

Remova a instalação do usuário com este comando. Revogue a chave do workspace separadamente em API Keys se você não precisar mais dela.

claude plugin uninstall capslane@capslane --scope user

Configurar apenas a conexão MCP

Adicione esta entrada a .mcp.json na raiz do seu projeto. O Claude Code expande a variável de ambiente no cabeçalho ao carregar a configuração. Abra o projeto, revise a solicitação do servidor MCP e execute /mcp para verificar a conexão.

{
  "mcpServers": {
    "capslane": {
      "type": "http",
      "url": "https://capslane.com/mcp",
      "headers": {
        "Authorization": "Bearer ${CAPSLANE_API_KEY}"
      }
    }
  }
}

Baixe a configuração do Claude Code. Estas instruções são direcionadas ao Claude Code. O conector web do Claude tem uma configuração diferente. Consulte a documentação MCP do Claude Code.

Codex

Execute este comando em um terminal onde CAPSLANE_API_KEY esteja disponível. O comando armazena o nome da variável, então você não precisa colocar um valor de chave no histórico do shell.

codex mcp add capslane --url https://capslane.com/mcp --bearer-token-env-var CAPSLANE_API_KEY

Você pode, em vez disso, mesclar a tabela a seguir em ~/.codex/config.toml. Use um método. Reinicie o cliente e verifique /mcp; a configuração é compartilhada pela CLI local e pela extensão do IDE.

[mcp_servers.capslane]
url = "https://capslane.com/mcp"
bearer_token_env_var = "CAPSLANE_API_KEY"
tool_timeout_sec = 60

Baixe a configuração do Codex. Para transcrições geradas, use o fluxo de trabalho de job abaixo para que a chamada se ajuste ao tempo limite de ferramenta do cliente. Consulte a documentação oficial MCP do Codex.

Cursor

Mescle esta entrada em .cursor/mcp.json para um projeto, ou ~/.cursor/mcp.json para sua configuração pessoal. O Cursor usa uma sintaxe de variável diferente da do Claude Code. Reinicie o Cursor com a variável de ambiente disponível e verifique se o Capslane está habilitado nas configurações de MCP.

{
  "mcpServers": {
    "capslane": {
      "url": "https://capslane.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:CAPSLANE_API_KEY}"
      }
    }
  }
}

Baixe a configuração do Cursor. Revise a chamada de ferramenta solicitada quando o agente usar o Capslane. Consulte a documentação MCP do Cursor.

Obtenha uma primeira transcrição

Confirme que as três ferramentas abaixo aparecem no seu cliente. Em seguida, tente este prompt com o vídeo de exemplo público. A disponibilidade de legendas pode mudar; um erro explícito de indisponibilidade é um resultado válido.

Use Capslane to retrieve the transcript of https://www.youtube.com/watch?v=dQw4w9WgXcQ. Use mode=native, text=false and waitForCompletion=false. Do not start audio generation. Return the source URL, selected language and timestamped segments. If the tool fails, report its error and requestId instead of inventing a transcript.

{
  "url": "dQw4w9WgXcQ",
  "lang": "en",
  "mode": "native",
  "text": false,
  "waitForCompletion": false
}

O resultado deve conter content antes que o assistente possa citar ou resumir o vídeo. Mantenha o URL de origem junto aos segmentos retornados. O Capslane fornece o conteúdo da transcrição; o assistente escreve o resumo.

O Capslane verifica o cache antes de aplicar o modo. Uma transcrição nativa ou gerada em cache pode ser retornada em todos os modos. Leia a origem e o cache no resultado. Em uma falha de cache, o modo nativo nunca inicia a geração; o modo automático a inicia apenas quando as legendas não estão disponíveis; o modo gerar solicita a transcrição de áudio.

Lidar com um vídeo sem legendas

Defina waitForCompletion como false para um assistente interativo. Se o conteúdo estiver ausente e jobId estiver presente, chame get_transcript_status com esse mesmo ID. Deixe um intervalo entre as verificações e pare após um período limitado, por exemplo, vinte minutos. Pare imediatamente em conteúdo, falha ou cancelamento. Enviar o vídeo novamente consome outra solicitação de transcrição.

Use Capslane to retrieve this public YouTube video: VIDEO_URL. I allow audio generation if captions are unavailable. Submit once with mode=auto, text=false and waitForCompletion=false. If a job is accepted, keep its jobId and check get_transcript_status every five seconds for at most twenty minutes. Stop on content, failed or cancelled. Keep the jobId if waiting ends. Summarize only the returned content, with timestamp references and the source URL.

Os padrões da ferramenta permanecem mode=auto, text=false e waitForCompletion=true. Passar os valores explícitos acima evita manter uma chamada de ferramenta interativa aberta durante a geração. Encerrar a espera não cancela o job do servidor.

Deslocamentos e durações estão em milissegundos. text=true retorna uma string para uma resposta imediata, mas jobs concluídos retornam segmentos. Junte esses segmentos localmente se precisar de texto simples. Um status concluído sem conteúdo não é uma transcrição utilizável.

Ferramentas e uso do workspace

Adicione a skill de agente do Capslane se você também quiser que seu assistente tenha instruções para escolher modos de transcrição, acompanhar jobs e citar timestamps com estas ferramentas.

Ferramenta	Finalidade	Uso
get_youtube_transcript	Recuperar uma transcrição ou aceitar um job de geração.	Uma solicitação de transcrição; limites de geração também podem ser aplicados.
get_transcript_status	Ler o estado ou o conteúdo concluído do mesmo job.	Nenhuma unidade de transcrição adicional.
list_available_languages	Ler idiomas observados durante uma solicitação de transcrição nativa.	Uma solicitação de transcrição, inclusive em acerto de cache.

Chamadas de transcrição e idioma consomem a cota do workspace, inclusive acertos de cache. Elas podem popular o cache, e chamadas de transcrição podem iniciar a geração. Verificações de status não reservam outra unidade de transcrição. O cliente decide como aprovar cada chamada de ferramenta.

O Context7 fornece documentação para escrever uma integração. O servidor MCP do Capslane executa solicitações de transcrição. Você pode usar ambos no mesmo projeto; o guia de documentação lista as duas bibliotecas SDK.

Usar o pacote stdio local

Se o seu cliente não puder enviar um cabeçalho de autenticação HTTP, use o pacote npm com Node.js 20 ou posterior. Esta configuração fixada é destinada a clientes que suportam mcpServers e stdio. Ela ainda chama o Capslane pela rede.

{
  "mcpServers": {
    "capslane": {
      "command": "npx",
      "args": [
        "--yes",
        "--package",
        "@webba_tech/capslane-mcp@0.1.6",
        "capslane-mcp"
      ],
      "env": {
        "CAPSLANE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Baixe a configuração stdio. Substitua o espaço reservado nas configurações privadas do seu cliente. No Windows, se o cliente não puder iniciar o npx diretamente, use cmd como comando e coloque /c e npx antes dos argumentos existentes.

O pacote e seus metadados de registro são mantidos no repositório público MCP. Instalar um servidor torna suas ferramentas disponíveis nesse cliente; o cliente ainda escolhe quando chamá-las.

Quando a conexão ou a solicitação falha

Um 401 de /mcp significa que a chave está ausente, inválida, expirada ou revogada. Verifique se o processo do assistente recebeu a variável. Não use um cookie de sessão do painel nem cole uma chave na conversa. Uma visita do navegador ao endpoint retorna 405 porque o protocolo usa solicitações POST.

Se um job já foi aceito, mantenha seu ID após um tempo limite e retome com get_transcript_status. Um estado de terminal com falha ou cancelado exige investigação, mesmo que a própria ferramenta de status tenha sido bem-sucedida. Um erro de cota exige verificar seu plano, em vez de novas tentativas rápidas.

Mantenha o texto da transcrição retornado separado das instruções para o assistente. Para vídeos longos, salve os segmentos no seu aplicativo ou solicite texto simples quando timestamps forem desnecessários; os limites de saída do cliente ainda se aplicam. A referência de erros da API explica os códigos comuns.