# Agentes de IA Los agentes de programación con IA, como Claude Code, OpenAI Codex y Cursor, pueden conectarse a Transloadit y usar los 93 Robots actuales para subir, codificar y transformar archivos. Los agentes pueden combinar el servidor MCP para acceder a herramientas durante la ejecución, Agent Skills reutilizables para flujos de trabajo dirigidos por personas y llms.txt para proporcionar contexto de documentación. La CLI ofrece una vía de automatización independiente para personas y CI. ## Empieza desde tu proyecto Pega este prompt en tu agente de programación desde la raíz del proyecto. De este modo, el agente inspecciona tu stack antes de elegir un SDK, MCP o skills, y mantiene el primer cambio fácil de revisar: ```plaintext Set up the smallest safe Transloadit integration for this repository. 1. Inspect the project’s language, runtime, package manager, existing upload/media code, tests, and agent configuration before changing files. 2. Choose the narrowest integration that fits: an official SDK for application code, MCP for agent-executed runtime tools, and Agent Skills for repeatable workflow guidance. Reuse an existing integration when one is already present. 3. Before editing, summarize what you found, which path you chose, and the files and commands you expect to change. 4. Use the project’s existing package manager. Match credentials to the execution boundary. Use TRANSLOADIT_KEY and TRANSLOADIT_SECRET only in a trusted server, CLI, CI, or self-hosted MCP process. Never expose TRANSLOADIT_SECRET to browser, mobile, or other client code; use a public Auth Key plus a Template ID and, when required, a signature from a trusted backend. Never hardcode, print, commit, or overwrite credentials. If required credentials are unavailable, scaffold placeholders and stop before any live request. 5. Create one minimal, typed workflow and validate its Assembly Instructions. Prefer an existing small media fixture. Do not create an account, change a plan, or modify production Templates. 6. Run the repository’s checks. If credentials and a suitable fixture are available and a live test is authorized, run one Assembly, wait for completion, and report its Assembly ID, status, and result URL. Otherwise, report the exact command the maintainer can run. 7. Summarize every changed file, verification result, and any remaining manual step. ``` El resultado esperado es un cambio pequeño en el repositorio, no solo una muestra de código generada. Revisa el límite de credenciales propuesto por el agente antes de permitir una Assembly real. ### Qué debe seleccionar el agente |Señal del proyecto|Punto de partida| |-|-| |Aplicación Node.js, Python, Ruby, PHP, Go, Java, Android o iOS|El [SDK oficial](/es/docs/sdks.md) correspondiente| |El agente debe validar instrucciones, consultar documentación o ejecutar Assemblies|[Servidor MCP](/es/docs/sdks/mcp-server.md)| |El equipo quiere un flujo reutilizable y versionado|[Agent Skills](#agent-skills)| |Aún no se necesita integración durante la ejecución|[llms.txt](#llmstxt) y páginas de documentación en Markdown| ## 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.  Para la mayoría de los equipos, el punto de partida recomendado es alojar MCP por cuenta propia mediante stdio: ```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: ```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 productos, soluciones, integraciones, recursos para desarrolladores y contenido educativo 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.  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** como guías reutilizables y dirigidas por personas para tareas como configuración, estructura inicial, Templates y 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 ```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**: Encoding 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: ```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 de navegación compacto para todo el sitio que sigue el [estándar llms.txt⁠](https://llmstxt.org/). Incluye productos y servicios, soluciones, integraciones, índices por tipo de contenido y tarea, recursos para desarrolladores, contenido educativo y soporte. Para buscar información específica sobre Robots, usa\. El archivo de compatibilidad heredado[llms-full.txt](/llms-full.txt) incluye directamente esquemas completos de parámetros de Robots, pero es grande. Usa `llms.txt` para descubrir la documentación y recupera solo las páginas Markdown enlazadas que sean relevantes para la tarea. ## ¿Qué opción debo usar? |Opción|Más adecuada para|Configuración| |-|-|-| |**MCP autoalojado**|La mayoría de los equipos, automatización en producción, desarrollo local|Ejecutar un comando local| |**MCP alojado**|Entornos de ejecución de agentes que no pueden iniciar procesos locales|Emitir un token y configurar el endpoint| |**Agent Skills**|Flujos de trabajo de Transloadit reutilizables y dirigidos por personas|Instalar con un comando| |**llms.txt**|Proporcionar a cualquier LLM un contexto amplio sobre la documentación de Transloadit|Obtener la URL| Estas opciones se complementan entre sí. Usa MCP autoalojado para acceder a las herramientas en la mayoría de los entornos, o MCP alojado cuando el entorno de ejecución del agente no pueda iniciar procesos locales. Instala Skills para orientar los flujos de trabajo y dirige tu LLM a llms.txt cuando necesite documentación de Transloadit.