Servidor MCP

Com o servidor remoto do transcript1, seu assistente de IA pode pedir transcrições e ler o texto. A conexão usa Model Context Protocol. Você pode enviar links do YouTube, X, TikTok, Instagram, Facebook e Bluesky, ou arquivos de áudio e vídeo por upload. Consulte as outras gravações públicas aceitas e suas restrições em Links aceitos e opções.

Envie posts públicos. Se houver vários vídeos no post, transcrevemos só o primeiro. Além do suporte a legendas do YouTube e do X, podemos usar as legendas no idioma original do TikTok, Bluesky, Dailymotion e LinkedIn. No modo auto, se não pudermos usar as legendas, transcrevemos o áudio com IA pelo mesmo preço por minuto. Fora do YouTube, as legendas só trazem marcações de tempo por segmento (words: null), mesmo quando são geradas automaticamente. O modo captions (somente legendas) não baixa áudio nem usa STT. Já source=stt e a identificação de falantes fazem o serviço ir direto ao áudio. Veja os detalhes em Links aceitos e opções.

• Endpoint: https://api.transcript1.com/mcp (streamable HTTP)
• Autenticação: no Claude e no ChatGPT, use OAuth 2.1: entre no transcript1 e autorize o acesso. No Cursor, VS Code, Claude Code e em agentes, envie uma chave de API como Authorization: Bearer t1_.... Você cria a chave em “API keys”.

As ferramentas chamam a API REST /v1 com a sua credencial. As regras de validação, cobrança e erros são as mesmas. As chamadas MCP usam o mesmo saldo de minutos e os mesmos limites da conta que as demais chamadas.

Ferramentas

Formato, espera e paginação

• Por padrão, format é text: cada segmento ocupa uma linha com marcação de tempo e, se você ativou a identificação de falantes, o rótulo de quem fala. Exemplo: [00:01:02] Speaker 1: Good morning. Você também pode escolher srt, vtt ou json.
• A espera padrão de wait_seconds é de 50 segundos. O campo aceita de 0 a 55. Se a transcrição continuar em andamento, a resposta avisa e inclui o id. Passe esse ID a get_transcription para aguardar novamente.
• Textos longos vêm em páginas. O padrão de max_chars é 60.000, com valores de 1.000 a 100.000. A página termina entre segmentos, sem cortar um deles, e a resposta inclui next_from_seconds. Use esse valor em from_seconds para continuar a leitura.
• A resposta informa de onde veio o texto em transcript_source: youtube_captions, x_captions, tiktok_captions, bluesky_captions, dailymotion_captions, linkedin_captions ou speech_to_text. Se vier caption_kind: null, a origem da faixa é desconhecida. Não interprete esse valor como legendas enviadas pelo criador.

Consulte antes de enviar novamente

Antes de repetir um envio, consulte a transcrição com get_transcription ou procure em list_transcriptions. A ferramenta transcribe sempre pede reuse_recent: com um link completo, o mesmo vídeo e as mesmas opções, ela reutiliza uma transcrição das últimas 24 horas sem cobrar de novo. Isso não funciona com links curtos. A resposta avisa quando reutilizou uma transcrição anterior.

Arquivos

O MCP não transporta os bytes do arquivo. Para enviar um arquivo, o assistente chama create_upload e recebe o id da transcrição, o modelo de URL para as partes, um X-Upload-Token e a lista de partes. Depois, envia cada parte com um PUT HTTP fora do MCP e chama complete_upload. A resposta também indica a página de upload do painel, caso seja mais fácil enviar por lá. Veja o protocolo em Uploads.

Sem webhooks

Para receber webhooks, use a API REST. As ferramentas MCP não aceitam esse parâmetro.

Claude

No Claude, adicione o servidor remoto como um conector personalizado:

1. Abra as configurações de conectores e escolha adicionar um conector personalizado.
2. Dê o nome transcript1 e informe https://api.transcript1.com/mcp no endereço do servidor.
3. Quando o transcript1 abrir, entre na sua conta e autorize o acesso. O conector pede os escopos transcriptions:read e transcriptions:write.

Depois, envie um pedido como “Transcreva https://www.youtube.com/watch?v=dQw4w9WgXcQ”. A disponibilidade de conectores personalizados depende do seu plano do Claude.

ChatGPT

No ChatGPT, a conexão também usa um conector personalizado:

1. Nas configurações de conectores, adicione um conector personalizado para servidor MCP.
2. Use https://api.transcript1.com/mcp como endereço do servidor.
3. Faça login no transcript1 e autorize a conexão.

O acesso a conectores personalizados depende do plano do ChatGPT e das configurações do workspace. Talvez seja preciso ativar o modo desenvolvedor.

Conecte no Cursor

Use o link de instalação: Adicionar transcript1 ao Cursor

Se preferir configurar manualmente, adicione este trecho a .cursor/mcp.json com sua chave no cabeçalho Authorization:

{
  "mcpServers": {
    "transcript1": {
      "url": "https://api.transcript1.com/mcp",
      "headers": {
        "Authorization": "Bearer t1_YOURKEY"
      }
    }
  }
}

VS Code

Use o link de instalação: Adicionar transcript1 ao VS Code

Para configurar manualmente, adicione este trecho a .vscode/mcp.json no seu workspace:

{
  "servers": {
    "transcript1": {
      "type": "http",
      "url": "https://api.transcript1.com/mcp",
      "headers": {
        "Authorization": "Bearer t1_YOURKEY"
      }
    }
  }
}

Conecte no Claude Code

Coloque sua chave de API no lugar de t1_YOURKEY e rode:

claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"

Outros clientes

Se o cliente aceita servidores MCP remotos, aponte para https://api.transcript1.com/mcp e envie o cabeçalho Authorization: Bearer t1_....

Inicie por comando no Claude Desktop e em outros clientes

Alguns clientes iniciam a conexão MCP por um comando local. Neles, rode npx -y @transcript1/mcp com sua chave em TRANSCRIPT1_API_KEY. O pacote faz a ponte com o servidor hospedado do transcript1. Você precisa de Node.js 18 ou mais recente.

No Claude Desktop, adicione a configuração abaixo a claude_desktop_config.json. Crie uma chave em “API keys” e coloque no lugar de t1_YOURKEY.

{
  "mcpServers": {
    "transcript1": {
      "command": "npx",
      "args": ["-y", "@transcript1/mcp"],
      "env": { "TRANSCRIPT1_API_KEY": "t1_YOURKEY" }
    }
  }
}

Agent Skill

A Agent Skill ensina o agente a usar o transcript1 por meio de um arquivo curto de instruções, SKILL.md. Se o seu agente aceita skills, adicione o arquivo disponível em https://transcript1.com/.well-known/agent-skills/transcript1/SKILL.md.

Agentes com descoberta de skills podem encontrá-la no índice https://transcript1.com/.well-known/agent-skills/index.json.

Como as ferramentas informam erros

Se uma ferramenta falhar, ela retorna o mesmo code da API REST, uma mensagem e uma orientação para o assistente continuar. O formato é <code>: <message>. <next step>. Quando falta saldo, por exemplo:

insufficient_minutes: 20 minutes needed, 3 remaining. Top up at https://transcript1.com/dashboard/billing

Consulte os códigos em Erros e novas tentativas. Falhas no processamento aparecem nesse mesmo formato, com códigos como media_private ou no_captions.