# Agentes de IA Los agentes de programación con IA, como Claude Code, OpenAI Codex y Cursor, pueden conectarse a Transloadit y usar los 88 Robots para subir, codificar y transformar archivos. Hay tres formas de integración: el servidor MCP para acceder a herramientas durante la ejecución, Agent Skills para flujos de trabajo repetibles y llms.txt para proporcionar contexto de documentación. ## Servidor MCP El [Protocolo de Contexto de Modelo](https://modelcontextprotocol.io/) (MCP) proporciona a los agentes acceso directo durante la ejecución a las herramientas de Transloadit. ![Demostración: codificación de videos para streaming adaptativo HLS mediante el servidor MCP de Transloadit en Claude](/_next/static/media/mcp-demo.0_tw8arokc4ks.gif?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL) Para la mayoría de los equipos, la opción funcional más rápida es alojar MCP por cuenta propia mediante stdio: ![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL) ```bash TRANSLOADIT_KEY=MY_AUTH_KEY TRANSLOADIT_SECRET=MY_SECRET_KEY npx -y @transloadit/mcp-server stdio ``` Si no puedes ejecutar `npx` en tu entorno, usa el endpoint alojado`https://api2.transloadit.com/mcp` con `Authorization: Bearer `. Genera el token en otro entorno de confianza (por ejemplo, tu backend, CI o shell local) y luego pásalo al entorno de ejecución de tu agente: ![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL) ```bash npx -y @transloadit/node auth token --aud mcp ``` También puedes emitir tokens mediante [POST /token](/es/docs/api/token-post.md) o el[SDK de Node.js](/es/docs/sdks/node-sdk.md). Para consultar ejemplos de configuración de clientes (Claude, Cursor, VS Code/Copilot), detalles de autenticación, documentación de herramientas, límites y el comportamiento de las versiones alojada y autoalojada, consulta la [página del SDK del servidor MCP](/es/docs/sdks/mcp-server.md). ## Opciones de automatización Las herramientas de Transloadit para agentes son útiles más allá de los agentes de programación basados en chat. Proporcionan a los equipos varias formas prácticas de ejecutar el mismo flujo de trabajo multimedia desde scripts locales, tareas de CI, consolas de operaciones y agentes autónomos: * **CLI:** usa `@transloadit/node` cuando una persona o una tarea de CI necesite un comando repetible para crear una Assembly, esperar a que finalice y recopilar los resultados. * **MCP:** expón un conjunto limitado de herramientas de Transloadit a agentes integrados o alojados que no deban obtener acceso al shell. El agente puede consultar la documentación de Robots, validar Assembly Instructions, crear Assemblies y seguir las actualizaciones de estado mediante el servidor MCP. * **Agent Skills:** conserva en el control de versiones las guías de flujos de trabajo multimedia específicas de tu equipo para agentes que ya cuenten con herramientas útiles, como acceso a la terminal, MCP, la CLI o SDK. Las Skills indican al agente qué Templates, pasos de verificación y alternativas debe usar, pero por sí solas no conceden nuevas capacidades. * **llms.txt:** proporciona a cualquier LLM un mapa actualizado de los Robots, parámetros y documentación de Transloadit antes de que proponga una Assembly. Para la automatización en producción, mantén las credenciales en tu entorno de confianza y permite que los agentes llamen a un servidor MCP autoalojado o a tu propio backend. El MCP alojado resulta práctico cuando el entorno de ejecución del agente no puede iniciar procesos locales, mientras que la CLI sigue siendo la opción más sencilla para tareas deterministas en CI. ## Agent Skills Las [Agent Skills](https://agentskills.io/) son archivos Markdown (`SKILL.md`) que enseñan a los agentes a realizar tareas paso a paso. ![Demostración: codificación de videos para streaming adaptativo HLS mediante Agent Skills de Transloadit en Claude](/_next/static/media/skills-demo.17qq6b.p2vo_b.gif?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL) En términos prácticos, un servidor MCP es una interfaz de API que un agente puede llamar durante la ejecución (mediante un proceso MCP local o alojado), mientras que las Skills son guías con control de versiones que indican a un agente qué hacer, en qué orden y cómo verificarlo. Por sí solas, las Skills no añaden acceso a nuevas herramientas. Codifican cómo quieres que el agente use de forma coherente las herramientas disponibles en tu entorno (MCP, CLI, SDK). * Usa **MCP** para una ejecución integrada y repetible (subidas, Assemblies, consultas periódicas, resultados). * Usa **Skills** para trabajos puntuales dirigidos por una persona (configuración, estructura inicial, Templates, migraciones). También se complementan entre sí. Una Skill puede estandarizar un flujo de trabajo y luego indicar al agente que use MCP (o una CLI local como alternativa) para la ejecución propiamente dicha. ### Instala con la CLI de Skills ![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL) ```bash npx skills add transloadit/skills ``` Esto instala las 7 Skills de Transloadit en tu proyecto: * **docs-transloadit-robots**: Consulta sin conexión de los Robots de Transloadit y de la documentación y los ejemplos de sus parámetros mediante la CLI `transloadit`. Úsala para redactar o validar el JSON de `steps` sin tener que adivinar nombres ni parámetros de Robots. * **integrate-asset-delivery-with-transloadit-smartcdn-in-nextjs**: Agregar la firma de URLs de Transloadit Smart CDN a un proyecto de Next.js con App Router (ruta de firma del lado del servidor y página de demostración opcional para el cliente). * **integrate-uppy-transloadit-s3-uploading-to-nextjs**: Agregar Uppy Dashboard y subidas de Transloadit a una aplicación de Next.js con App Router, con generación de firmas del lado del servidor y exportación opcional mediante /s3/store. * **transform-encode-hls-video-with-transloadit**: Codificación HLS puntual (video local -> variantes HLS + lista de reproducción) con Transloadit mediante la CLI `transloadit`. Es preferible usar Builtin Templates (`builtin/encode-hls-video@latest`) y descargar los resultados localmente mediante `-o`. * **transform-generate-image-with-transloadit**: Generación puntual de imágenes (prompt -> archivo de imagen) con Transloadit mediante la CLI `transloadit`. Es preferible usar Builtin Templates (`builtin/generate-image@latest`) y descargar los resultados localmente mediante `-o`. * **transform-remove-background-with-transloadit**: Eliminación puntual del fondo (imagen local -> PNG transparente) con Transloadit mediante la CLI `transloadit`. Usa un JSON de `steps` mínimo con `/image/bgremove` y descarga el resultado en una ruta `.png` explícita mediante `-o`. * **transloadit**: Skill principal como punto de entrada para Transloadit. Dirige la tarea al skill `integrate-*`, `transform-*` o `docs-*` adecuado y, para obtener un comportamiento determinista, prioriza la ejecución mediante `npx -y @transloadit/node ...` (CLI). ### Detección automática El catálogo de Skills también está disponible en[transloadit.com/.well-known/skills/index.json](/.well-known/skills/index.json), de acuerdo con la[RFC de detección de Agent Skills](https://agentskills.io/specification). Esto significa que también puedes instalarlo con: ![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL) ```bash npx skills add https://transloadit.com ``` ### Instalación manual Clona o crea un enlace simbólico al repositorio [transloadit/skills](https://github.com/transloadit/skills) en el directorio de Skills de tu agente: |Agente|Ruta| |-|-| |Claude Code|.claude/skills/| |OpenAI Codex|.codex/skills/| |Gemini CLI|.gemini/skills/| |Cursor|.cursor/skills/| |Windsurf|.codeium/windsurf/skills/| ## llms.txt Transloadit publica un archivo [llms.txt](/llms.txt), un índice estructurado de toda la documentación de Robots que sigue el [estándar llms.txt](https://llmstxt.org/). Los agentes y LLM pueden obtener este archivo para acceder a una descripción actualizada de cada Robot, sus parámetros y enlaces a la documentación completa. Hay una variante detallada disponible en [llms-full.txt](/llms-full.txt), que incluye toda la documentación de Robots directamente en el archivo en lugar de enlazarla. ## ¿Qué opción debo usar? |Opción|Más adecuada para|Tiempo de configuración| |-|-|-| |**MCP alojado**|Flujos de trabajo de agentes en producción, configuraciones de equipos|2 minutos| |**MCP autoalojado**|Entornos aislados, desarrollo local|5 minutos| |**Agent Skills**|Enseñar a los agentes las prácticas recomendadas y los patrones de Transloadit|2 minutos| |**llms.txt**|Proporcionar a cualquier LLM contexto sobre los Robots de Transloadit|Cero (solo obtén la URL)| Estas opciones se complementan entre sí. Usa el servidor MCP alojado para acceder a las herramientas, instala Skills para orientar los flujos de trabajo y dirige tu LLM a llms.txt cuando necesite documentación de Robots.