SummarizeVideo.ai

npx add-mcp 'https://mcp.summarizevideo.ai/mcp'

Endpoint e autenticação

https://mcp.summarizevideo.ai/mcp

O servidor utiliza o transporte HTTP Streamable. Envie cada requisição com sua chave de agente no cabeçalho Authorization como um token Bearer.

O servidor não suporta login via OAuth. Um cliente MCP que só consegue se conectar via OAuth não pode utilizá-lo.

Criar uma chave de agente

As chaves de agente são criadas na página de chaves de agente enquanto você está conectado.

• Resumir e ler: o agente pode iniciar resumos e lê-los. Novos resumos contam para o limite da sua conta.
• Somente leitura: o agente pode ler resumos e transcrições que já existem, e summarize_video não é oferecido.
• Cada chave expira após 7, 30, 90 ou 365 dias. Você pode ter até 10 chaves ativas.
• A página mostra uma nova chave apenas uma vez. Copie-a nesse momento ou crie outra chave.
• Revogue uma chave na mesma página quando parar de usá-la ou se suspeitar que outra pessoa a obteve. Uma chave revogada para de funcionar na próxima requisição.
• O servidor MCP aceita apenas chaves de agente. Seu login no site não funciona como credencial MCP.

Configurar o Claude Code

Salve a chave em uma variável de ambiente, como SUMMARIZEVIDEO_TOKEN, e não em um arquivo versionado. Em seguida, adicione o servidor ao .mcp.json. O Claude Code preenche a variável ao conectar.

{
  "mcpServers": {
    "summarizevideo": {
      "type": "http",
      "url": "https://mcp.summarizevideo.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${SUMMARIZEVIDEO_TOKEN}"
      }
    }
  }
}

Outros clientes MCP precisam da mesma URL e do mesmo cabeçalho Authorization. Uma resposta 401 significa que a chave está ausente, expirada ou revogada, e a solução é criar uma nova chave.

Ferramentas

summarize_video

Recebe uma URL pública de vídeo e um idioma opcional para o resumo. Retorna um requestID imediatamente, antes de o resumo estar pronto. Perguntar novamente pela mesma URL e idioma retorna o mesmo requestID em vez de iniciar outro resumo.

get_summary

Recebe o requestID. O estado é pending enquanto o vídeo está sendo processado, done com o resumo em Markdown, ou error com o motivo.

get_transcript

Recebe o requestID de um resumo concluído e retorna a transcrição em texto simples em páginas de até 50.000 caracteres por padrão. Quando ainda houver mais texto, a resposta inclui nextStartCharacter. Passe-o de volta como startCharacter para ler a próxima página.

Como um agente resume um vídeo

1. Chame summarize_video com a URL do vídeo.
2. Chame get_summary a cada 30 segundos até que o estado seja done ou error. Vídeos longos sem legendas demoram mais.
3. Mostre o resumo. Os pontos principais podem começar com um timestamp do momento em que as palavras de apoio foram ditas.
4. Chame get_transcript somente quando o usuário quiser citações ou detalhes que o resumo omitiu.

Limites

• Resumos iniciados via MCP usam os mesmos limites do site: 2 resumos gratuitos em qualquer janela de 24 horas, ou os créditos restantes de um Founding Pass.
• Uma conta pode processar 2 vídeos ao mesmo tempo.
• Apenas URLs públicas de vídeo funcionam. Uploads de arquivos, playlists e feeds de podcast não são suportados.
• Vídeos sem legendas são transcritos a partir do áudio, para vídeos de até 90 minutos.
• Os resumos são privados da conta que os solicitou. Um requestID de outra conta retorna not found.

Consulte preços e limites para os termos do Founding Pass.