Transloadit mediante MCP

Qué puede hacer tu agente

Al conectarse, obtiene siete herramientas, agrupadas en cuatro tareas:

• Averiguar qué es posible. transloadit_list_robots devuelve el catálogo con un resumen por Robot, y transloadit_get_robot_help devuelve los parámetros de uno de ellos. El agente no necesita haber sido entrenado con nuestra documentación para usarnos correctamente.
• Comprobar lo que ha hecho el agente antes de que cueste nada. transloadit_lint_assembly_instructions valida un conjunto de Assembly Instructions sin crear una Assembly y devuelve diagnósticos estructurados en lugar de prosa.
• Ejecutar la tarea. transloadit_create_assembly crea o reanuda una Assembly, sube archivos y espera el resultado si se lo pides.
• Seguirla hasta el final. transloadit_get_assembly_status y transloadit_wait_for_assembly hacen seguimiento de una Assembly en ejecución, y transloadit_list_templates reutiliza los Templates que ya tienes.

Puede explorar antes de poder gastar

El catálogo y el linter no necesitan credenciales. Un agente puede listar todos los Robots, leer los parámetros de los que le interesen y validar un borrador, todo antes de que exista una cuenta. Pídele que pase el linter a un Step que contenga un error y recibirá exactamente ese error:

{
  "severity": "error",
  "path": "instructions",
  "message": "Path `steps.resized` has unrecognized keys: `widht`"
}

Todo lo que afecta a una cuenta es otra cuestión. Listar tus Templates o crear una Assembly sin credenciales devuelve mcp_missing_auth, no una suposición ni un resultado parcial. Una vez autorizado, un agente puede crear trabajo facturable sin una confirmación independiente para cada Assembly. Controla sus permisos y su política de reintentos antes de darle credenciales.

Por qué esto es mejor que darle a un agente una clave de API

Un agente dirigido a una REST API tiene que saber de antemano cómo está estructurada. Adivina el nombre de un parámetro, envía la solicitud y descubre que se equivocó solo cuando el trabajo falla, lo que cuesta, en el mejor de los casos, una solicitud de ida y vuelta y, en el peor, un cargo de encoding.

Las Assembly Instructions son JSON declarativo, el tipo de artefacto que un agente produce bien. Combinarlas con el descubrimiento y un linter cierra el ciclo antes de que se ejecute nada: el agente puede preguntar qué existe, escribir los Steps, validarlos y solo entonces crear la Assembly. El procesamiento en sí ocurre en nuestra infraestructura, así que no hay FFmpeg que instalar ni un disco local que llenar.

Conéctalo

La vía más rápida es el endpoint alojado:

https://api2.transloadit.com/mcp

Los clientes que exploran capacidades pueden leer la tarjeta del servidor en /.well-known/mcp/server-card.json⁠. Esta tarjeta, legible por máquina, enumera las herramientas y sus esquemas de entrada.

Ejecutarlo tú mismo mediante stdio suele ser la mejor opción una vez superada la fase de prueba, porque entonces el proceso guarda tu TRANSLOADIT_KEY y tu TRANSLOADIT_SECRET y gestiona la autenticación por ti. La documentación del servidor MCP describe ambas configuraciones, incluidos los fragmentos de configuración para clientes.

Lo que no hará

• El servidor orquesta Transloadit. No ejecuta código arbitrario sobre tus archivos y no puede hacer nada que la API no pueda.
• El encoding se cobra como de costumbre. Limita los reintentos y la concurrencia del agente, usa credenciales con ámbitos restringidos y supervisa el uso del Workspace. La autenticación no es un límite de gasto.
• Las herramientas cubren Assemblies, Robots y Templates. La administración de la cuenta, la facturación y las credenciales quedan fuera de su alcance, de forma deliberada.
• No sustituye la lectura de la documentación de Robots cuando eres tú quien diseña el pipeline. Es lo que usas cuando quien lo diseña es el agente.

Crea un Workspace gratuito para obtener las credenciales, o lee primero la documentación del servidor MCP.