Servidor MCP do Fast Transcriber

Permita que um assistente de IA compatível com MCP coloque links públicos de áudio e vídeo na fila, acompanhe tarefas e recupere transcrições concluídas.

O que é MCP?

O Model Context Protocol oferece aos clientes de IA uma forma padronizada de descobrir e chamar ferramentas externas. O Fast Transcriber disponibiliza ferramentas de transcrição tipadas para que assistentes trabalhem com tarefas sem extrair conteúdo do site.

Pré-requisitos

• Uma conta conectada do Fast Transcriber.
• Uma chave de API ativa criada na seção de desenvolvedores.
• Um cliente MCP compatível com Streamable HTTP ou servidores stdio locais.

Configuração remota

Use este endpoint com clientes Streamable HTTP:

https://fast-transcriber.com/api/mcp

Clientes que aceitam cabeçalhos personalizados podem usar a configuração a seguir. Quando possível, armazene a chave em um cofre de segredos ou em uma variável de ambiente.

{
  "mcpServers": {
    "fast-transcriber": {
      "url": "https://fast-transcriber.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ft_live_replace_me"
      }
    }
  }
}

Autenticação

O endpoint MCP exige uma chave de API no cabeçalho HTTP Authorization como token Bearer. O OAuth não é anunciado no momento, portanto o cliente precisa aceitar cabeçalhos Authorization personalizados.

Authorization: Bearer ft_live_replace_me

Ferramentas disponíveis

O servidor remoto publica três ferramentas para uso no servidor:

Exemplo de chamada de ferramenta

{
  "url": "https://www.youtube.com/watch?v=example",
  "speaker_diarization": false
}

O resultado contém o identificador de uma tarefa. Chame get_transcription com esse identificador até que a tarefa esteja completed ou failed.

Servidor de arquivos local

Um servidor remoto não pode ler a mídia presente no seu computador. Hospede o pacote stdio incluído quando o cliente de IA precisar enviar arquivos locais. Ele adiciona transcribe_file e wait_for_transcription às três ferramentas remotas.

cd mcp-server
npm ci
npm run build

{
  "mcpServers": {
    "fast-transcriber": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "FAST_TRANSCRIBER_API_TOKEN": "ft_live_replace_me",
        "FAST_TRANSCRIBER_ALLOWED_DIRS": "/absolute/path/to/media"
      }
    }
  }
}

Segurança

• Nunca envie chaves de API para o repositório nem cole chaves em prompts enviados a um modelo.
• Crie chaves separadas para clientes diferentes.
• Revogue uma chave imediatamente quando um dispositivo deixar de ser usado.
• Dê ao servidor local acesso apenas ao diretório de mídia necessário.

Erros

As falhas das ferramentas são retornadas como resultados de erro MCP com uma mensagem segura. Falhas de autenticação retornam o status HTTP 401 antes da execução do MCP. Limites da conta e recursos indisponíveis no plano seguem as mesmas regras da API REST.

Solução de problemas