Servidor MCP de Fast Transcriber

Permite que un asistente de IA compatible con MCP ponga enlaces públicos de audio y video en la cola, siga las tareas y recupere transcripciones completadas.

¿Qué es MCP?

Model Context Protocol ofrece a los clientes de IA una forma estandarizada de descubrir y llamar herramientas externas. Fast Transcriber proporciona herramientas de transcripción tipadas para que los asistentes trabajen con tareas sin extraer contenido del sitio.

Requisitos previos

• Una cuenta de Fast Transcriber con sesión iniciada.
• Una clave de API activa creada en la sección para desarrolladores.
• Un cliente MCP compatible con Streamable HTTP o servidores stdio locales.

Configuración remota

Usa este endpoint con clientes Streamable HTTP:

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

Los clientes que aceptan encabezados personalizados pueden usar la siguiente configuración. Siempre que sea posible, guarda la clave en un almacén de secretos o en una variable de entorno.

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

Autenticación

El endpoint MCP requiere una clave de API en el encabezado HTTP Authorization como token Bearer. OAuth no se anuncia actualmente, por lo que el cliente debe aceptar encabezados Authorization personalizados.

Authorization: Bearer ft_live_replace_me

Herramientas disponibles

El servidor remoto publica tres herramientas para usar en el servidor:

Ejemplo de llamada a una herramienta

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

El resultado contiene el identificador de una tarea. Llama a get_transcription con ese identificador hasta que la tarea esté completed o failed.

Servidor de archivos locales

Un servidor remoto no puede leer el contenido multimedia de tu computadora. Ejecuta el paquete stdio incluido cuando el cliente de IA necesite cargar archivos locales. Añade transcribe_file y wait_for_transcription a las tres herramientas 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"
      }
    }
  }
}

Seguridad

• Nunca envíes claves de API al repositorio ni las pegues en instrucciones enviadas a un modelo.
• Crea claves distintas para clientes diferentes.
• Revoca una clave de inmediato cuando un dispositivo deje de usarse.
• Da al servidor local acceso únicamente al directorio multimedia necesario.

Errores

Los fallos de las herramientas se devuelven como resultados de error MCP con un mensaje seguro. Los fallos de autenticación devuelven el estado HTTP 401 antes de ejecutar MCP. Los límites de la cuenta y las funciones no disponibles en el plan siguen las mismas reglas que la API REST.

Solución de problemas