Ir para a referência MCP

Documentação MCP

Suas transcrições no assistente de IA.

Conectar clienteExplorar ferramentas
Nesta página

Taption MCP

Conecte o Taption a um cliente MCP para transcrever e traduzir áudio e vídeo, ler transcrições e traduções concluídas e consultar trabalhos recentes sem sair da conversa.

O Model Context Protocol (MCP) permite que o assistente use ferramentas do Taption em seu nome. Esta conexão personalizada permite ler transcrições e criar novos trabalhos de transcrição e tradução.

Streamable HTTPOAuth 2.1

URL do servidor

https://api.taption.com/mcp-custom

Use esta URL completa ao adicionar o Taption como servidor MCP remoto.

Transporte
Streamable HTTP
Autenticação
OAuth 2.1

Requisitos

  • Uma conta Taption, sem assinatura paga obrigatória. Se usa e-mail e senha, verifique seu e-mail antes de conectar.
  • Minutos disponíveis para criar transcrições e traduções. Os limites da conta e do plano são aplicados.
  • Um cliente compatível com Streamable HTTP remoto e OAuth. O plano do cliente e as políticas da organização podem limitar o acesso.

Fontes de mídia compatíveis

Use uma URL direta de áudio ou vídeo, um arquivo público do Google Drive ou um vídeo do YouTube. O servidor personalizado também aceita publicações públicas de Facebook, Instagram, TikTok, X, Threads, Vimeo, Dailymotion, Bilibili (bilibili.tv), além de vídeos e clipes do Twitch.

O ChatGPT também pode fornecer áudio ou vídeo enviado quando sua integração de arquivos estiver disponível. Outros clientes podem usar uma URL para download.

O Taption precisa acessar o link. Transmissões ao vivo não são aceitas; use a gravação finalizada.

Configure seu cliente

Escolha a sua aplicação para consultar o guia completo de configuração passo a passo.

Autenticação

O Taption usa OAuth 2.1 com PKCE. Entre na conta e aprove a conexão. O cliente gerencia a autorização e renova automaticamente o token de acesso com validade de uma hora.

O MCP usa tokens OAuth. Chaves REST API do Taption não autenticam esta conexão.

Use /mcp-custom durante toda a configuração. Um token emitido para /mcp não funciona em /mcp-custom.

Para revogar o acesso, abra Conta → Aplicativos conectados no Taption e desconecte o cliente. Para restaurar, conecte e autorize novamente.

Permissões da conexão

transcripts:read
Ler estado e conteúdo das transcrições e listar as recentes.
transcripts:write
Criar transcrições e traduções usando os minutos da conta.

Fluxos de trabalho disponíveis

Informe a mídia e o resultado desejado. O assistente usa as ferramentas Taption para seguir estas etapas.

  1. Escolher mídia e resultado

    Forneça um link ou arquivo compatível, o idioma falado e a finalidade: texto simples, identificação de falantes ou legendas. O assistente pergunta o que falta antes de começar.

  2. Transcrever e acompanhar

    transcribe retorna um ID imediatamente. get_transcript aguarda um pouco por um trabalho prestes a terminar; se ainda estiver processando, pergunte de novo em cerca de um minuto. Se as notificações por e-mail estiverem ativadas no Taption, você também recebe um e-mail ao concluir.

  3. Ler, resumir e exportar

    Leia o texto concluído ou peça um resumo ao assistente. Use os links de SRT e do editor quando disponíveis. O editor Taption oferece outros formatos de exportação.

Experimente pedir ao assistente

Transcreva esta gravação em inglês com identificação de dois falantes: [your media URL].
Crie legendas para este vídeo em japonês: [your media URL]. Use 16 caracteres por linha.
Transcreva esta entrevista em inglês como legendas e depois traduza para japonês e espanhol: [your media URL].
Traduza minha transcrição “Weekly sync” para chinês tradicional.
Encontre minhas transcrições recentes do Taption e resuma a entrevista concluída. Inclua os links de legendas e do editor, se disponíveis.

Substitua [your media URL] pelo seu link. O assistente gera os resumos a partir do texto. A personalização do tamanho das legendas depende do plano Taption.

transcribe

Cria um trabalhotranscripts:write

Inicia uma transcrição em segundo plano com media_url ou file. O usuário precisa escolher idioma e finalidade. Se faltarem, são solicitados sem iniciar o trabalho. Adicione translate_to para traduzir a transcrição automaticamente ao terminar.

Parâmetros

media_urlstringUma fonte de mídia

Link de mídia compatível, até 2.048 caracteres. Use este campo ou file.

fileobjectUma fonte de mídia

Arquivo fornecido pelo cliente com download_url e file_id. mime_type e file_name são opcionais. O Taption precisa baixar a URL.

languagestringNecessário para iniciar

Idioma falado, como en-US, zh-TW, ja-JP ou es-ES. Pergunte ao usuário; não deduza pelo arquivo ou idioma do chat.

Ver códigos de idioma
purposestringNecessário para iniciar

transcript: texto pontuado; speakers: identificação de falantes; captions: trechos curtos de legendas. Pedir apenas para transcrever não escolhe uma finalidade.

transcriptspeakerscaptions
speaker_countinteger

Estimativa de falantes para speakers: 2–10. Padrão: 2.

max_charactersinteger

1–200 caracteres por linha para captions em planos pagos elegíveis. Padrão: 16 para zh/ja/ko/yue e 65 para os demais.

translate_tostring[]

Opcional. 1–5 idiomas para traduzir ao concluir a transcrição, como en, ja ou zh-TW. Cada um usa também minutos iguais à duração da mídia.

extensionstring

Extensão do arquivo enviado quando não puder ser identificada. Desnecessária para links. Aceita áudio e formatos de vídeo compatíveis; não aceita 3gp.

namestring

Nome da transcrição, até 200 caracteres. Se omitido, usa o nome do arquivo.

Exemplo de argumentos

{
  "media_url": "https://example.com/interview.mp4",
  "language": "en-US",
  "purpose": "speakers",
  "speaker_count": 2,
  "translate_to": [
    "ja"
  ],
  "name": "Interview"
}

Valores ilustrativos: substitua a URL ou o ID pelos seus.

Retorna ID e estado. Cada criação bem-sucedida inicia um novo trabalho e usa minutos, além de minutos iguais à duração da mídia para cada idioma de translate_to. Confira o progresso pelo mesmo ID, em vez de enviar novamente.

get_transcript

Somente leituratranscripts:read

Consulta o progresso ou lê o resultado como texto com marcações de tempo, SRT ou VTT. Informe language para ler uma tradução. A primeira página inclui download_url e editing_url quando disponíveis, e as traduções da transcrição com seu estado.

Parâmetros

idstringObrigatório

ID de transcribe ou list_transcripts: 1–128 letras, números, sublinhados ou hífens.

languagestring

Tradução a ler, pelo código do idioma, como ja. Se omitido, lê a transcrição original.

formatstring

Formato de saída. Padrão: text.

textsrtvtt
offsetinteger

Posição da frase a partir de 0. Padrão: 0. Use next_offset para continuar.

limitinteger

1–500 frases por página. Padrão: 200.

Exemplo de argumentos

{
  "id": "TRANSCRIPT_ID",
  "format": "text",
  "offset": 0,
  "limit": 200
}

Valores ilustrativos: substitua a URL ou o ID pelos seus.

Passe next_offset como offset para continuar. Máximo de 30.000 caracteres por página; o MCP lê apenas as primeiras 2.000 frases. O texto completo está no Taption. Sem fala, retorna total_phrases: 0.

translate_transcript

Cria um trabalhotranscripts:write

Traduz uma transcrição concluída para até cinco idiomas. Se você citar uma transcrição pelo nome, o assistente a procura com list_transcripts e pede que você escolha quando não houver correspondência clara. Os idiomas de destino precisam vir do usuário.

Parâmetros

idstringObrigatório

ID de transcribe ou list_transcripts: 1–128 letras, números, sublinhados ou hífens.

target_languagesstring[]Obrigatório

1–5 códigos de idioma de tradução, como en, ja, es ou zh-TW. Uma transcrição não pode ser traduzida para o próprio idioma.

overwriteboolean

true substitui uma tradução existente, incluindo edições feitas no Taption. Apenas após a concordância do usuário.

Exemplo de argumentos

{
  "id": "TRANSCRIPT_ID",
  "target_languages": [
    "ja",
    "es"
  ]
}

Valores ilustrativos: substitua a URL ou o ID pelos seus.

Retorna os idiomas na fila e os minutos usados por idioma, iguais à duração da mídia. Uma tradução existente pode conter suas edições e só é substituída com overwrite, após sua concordância. Leia o resultado com get_transcript e language.

list_transcripts

Somente leituratranscripts:read

Lista transcrições por modificação mais recente, com ID, nome, estado, idioma, traduções e data. Informe query para encontrar uma transcrição pelo nome. Use o ID com get_transcript para ler o conteúdo.

Parâmetros

limitinteger

1–50 transcrições. Padrão: 10.

querystring

Parte do nome de uma transcrição para procurar entre as suas 100 mais recentes, sem diferenciar maiúsculas.

Exemplo de argumentos

{
  "query": "weekly sync",
  "limit": 10
}

Valores ilustrativos: substitua a URL ou o ID pelos seus.

Retorna um array transcripts vazio se não houver gravações. O número de resultados é limitado, sem paginação.

Solução de problemas

Erro de conexão ou permissão

Reconecte com OAuth e conceda as permissões. Confirme que a URL termina em /mcp-custom.

Não foi possível baixar a mídia

Confira se o arquivo ou publicação é público, compatível e não está ao vivo. No Google Drive, ative o acesso por link.

Minutos insuficientes ou muitos trabalhos

Confira seus minutos no Taption. Para limites de frequência ou concorrência, espere os trabalhos terminarem e respeite o intervalo indicado.

Processando ou transcrição falhou

Durante o processamento, consulte o mesmo ID aproximadamente a cada minuto. Com estado error, leia a mensagem e corrija a causa antes de criar outro trabalho.

Mais formatos de exportação

Abra a transcrição no Taption para exportar TXT, PDF, SRT, VTT, Final Cut Pro XML, JSON ou vídeo com legendas incorporadas. Não há uma ferramenta MCP de exportação separada.

Ler a documentação REST API