Transloadit mediante MCP

Qué puede hacer tu agente

Las herramientas se agrupan en cuatro tareas. La documentación del servidor MCP enumera cada herramienta con los permisos que necesita.

• 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 descubrimiento y el linting no crean Assemblies. Un agente puede listar todos los Robots, leer los parámetros de los que le interesen y validar un borrador antes de ejecutar nada. 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`"
}

El endpoint alojado te pide que inicies sesión antes de que se ejecute cualquier herramienta, incluidos el descubrimiento y el linting. Para usarlos sin una cuenta, ejecuta el servidor tú mismo. Listar tus Templates y crear Assemblies siempre requiere credenciales, también en un servidor autohospedado.

Crear una Assembly puede iniciar trabajo facturable. La herramienta transloadit_create_assembly está marcada como destructiva, y que se te pida o no confirmar cada llamada depende de tu cliente. No confíes en esa confirmación: define los permisos y la política de reintentos del agente antes de conectarlo.

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

Te recomendamos añadir el endpoint alojado al cliente de tu agente:

https://api2.transloadit.com/mcp

Después apruebas el acceso en tu navegador y eliges el Workspace que puede usar el agente. No hay nada que instalar ni claves que copiar.

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

Para CI y otros clientes en los que nadie puede aprobar el acceso en un navegador, o para ejecutar el servidor tú mismo, consulta Elige cómo conectarte. La documentación del servidor MCP también incluye la configuración para cada cliente.

Lo que no hará

• El servidor orquesta Transloadit. No puede hacer nada que nuestra API y nuestros Robots no admitan.
• El encoding se cobra como de costumbre. Limita los reintentos y la concurrencia del agente, conecta solo el Workspace que necesita, restringe los ámbitos de cualquier Auth Key que crees para él y supervisa el uso del Workspace. Ni la autenticación ni la solicitud de confirmación de un cliente son un límite de gasto.
• Las herramientas trabajan con Assemblies, Robots y Templates, y pueden identificar el Workspace conectado. 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 conectar tu agente, o lee primero la documentación del servidor MCP.