Servidor MCP do Transcript Dock

O servidor MCP dá a um agente de IA a mesma API da sua chave: ele pode encontrar vídeos, transcrevê-los e ler os resultados no meio de uma conversa. Ele usa os seus créditos. Não há nada para instalar: basta apontar o cliente para o servidor remoto, https://www.transcriptdock.com/mcp.

Conectar#

Claude (claude.ai, Desktop, celular)#

• Abra Customize, Connectors e escolha Add custom connector.
• Dê o nome Transcript Dock e cole https://www.transcriptdock.com/mcp como URL do servidor. Deixe as configurações avançadas vazias.
• Escolha Add e depois Connect. Entre no Transcript Dock e escolha Allow access.

Você não precisa de chave de API: o conector entra com a sua conta e pode ler e enviar tarefas e ler transcrições, mas nunca acessa chaves, faturamento ou configurações da conta. Nos planos Team e Enterprise, um Owner o adiciona uma vez em Organization settings, Connectors, e cada membro se conecta.

Claude Code#

Adicione o servidor e depois execute /mcp no Claude Code e escolha Authenticate para entrar.

claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp

Para CI e scripts, envie uma chave de API em vez de entrar:

claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp \
  --header "Authorization: Bearer td_live_YOUR_KEY"

Cursor e outros clientes#

{
  "mcpServers": {
    "transcriptdock": {
      "url": "https://www.transcriptdock.com/mcp",
      "headers": { "Authorization": "Bearer td_live_YOUR_KEY" }
    }
  }
}

O Windsurf usa serverUrl em vez de url, e o VS Code lista os servidores em servers com "type": "http". As páginas de cada cliente abaixo têm os arquivos exatos.

• Claude CodeUm comando no terminal.
• App do Claudeclaude.ai, Desktop e celular: adicione um conector personalizado.
• CursorAdicione ao mcp.json.
• WindsurfAdicione ao mcp_config.json.
• OpenClawAgentes autônomos via stdio.

Servidor local#

Para clientes que só aceitam stdio, como o OpenClaw, execute o mesmo servidor localmente com Node.js 22.15 ou mais recente. As duas variáveis são obrigatórias.

{
  "mcpServers": {
    "transcriptdock": {
      "command": "npx",
      "args": ["-y", "@transcriptdock/mcp"],
      "env": {
        "TRANSCRIPTDOCK_API_KEY": "td_live_YOUR_KEY",
        "TRANSCRIPTDOCK_BASE_URL": "https://www.transcriptdock.com"
      }
    }
  }
}

Ferramentas#

get_video_transcript#

A ferramenta que um agente deve usar quando perguntarem o que um vídeo diz.

urlstringObrigatório

URL de um vídeo do YouTube ou do TikTok.

mode"captions_only" | "auto" | "transcribe"Opcional

Padrão captions_only (1 crédito). auto usa a transcrição por IA quando o vídeo não tem legendas; transcribe sempre a usa (2 créditos por minuto iniciado, em planos pagos).

format"text" | "srt" | "vtt" | "segments"Opcional

text (padrão) é o mais compacto para um agente; segments retorna JSON com tempos.

timeout_secondsintegerOpcional

Padrão 120. Ao estourar o tempo, são retornados o estado e o id da tarefa.

{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

Never gonna give you up
Never gonna let you down
…

O mesmo vídeo com o mesmo modo é respondido a partir do resultado salvo no seu workspace, sem custo.

transcribe, wait_for_job, get_transcript#

A versão em três etapas, para agentes que querem mais controle: transcribe recebe url, mode, language opcional e max_credits, além de um idempotency_key (qualquer texto estável de 8 a 128 caracteres, para que uma chamada repetida nunca envie a mesma tarefa duas vezes), e devolve a tarefa. wait_for_job recebe job_id e um timeout_seconds opcional. get_transcript recebe o result_id da tarefa como transcript_id e um format.

Encontrar vídeos#

As ferramentas de pesquisa e listagem retornam vídeos com url, título, duração e número de visualizações, prontos para passar a get_video_transcript. channel aceita um @handle, um id de canal ou a URL do canal; playlist, um id ou uma URL; user, um @user do TikTok ou a URL do perfil. As ferramentas do YouTube paginam com limit (padrão 20) e cursor. O TikTok retorna no máximo 10 vídeos e não tem páginas seguintes; include_details adiciona curtidas, comentários, hashtags e idiomas das legendas de cada vídeo.

Erros#

Uma chamada com falha retorna isError: true com o código de erro da API, a mensagem e o id da requisição, para que o agente possa explicar o problema ou mudar de caminho. Os códigos são os da referência da API.

Solução de problemas#

• Unauthorized: no Claude, remova o conector e adicione-o de novo para entrar do zero. Com uma chave, ela vai na configuração do servidor (cabeçalho ou variável de ambiente), e não no seu shell. Confira se ela não foi revogada.
• Couldn't reach the MCP server: use a URL exata https://www.transcriptdock.com/mcp, incluindo o www.
• Tool not found: reinicie o cliente depois de editar a configuração.
• Local server will not start: instale o Node.js 22.15 ou mais recente e defina TRANSCRIPTDOCK_API_KEY e TRANSCRIPTDOCK_BASE_URL.
• NO_CAPTIONS: o vídeo não tem legendas. Em um plano pago, peça mode: "auto".