Guía para usuarios · English introduction

Tu agente, tus proyectos

Conecta una cuenta de Studio Pro para preparar historias, subir hasta cinco fotos, revisar el precio y generar vídeos o pósteres. Las propuestas quedan guardadas en la aplicación.

Dirección MCP

https://studioproimagen.com/mcp

Transporte: Streamable HTTP. Autenticación: OAuth con inicio de sesión en Studio Pro, o una credencial Bearer creada en Cuenta → Conectar agentes.

Qué autorizas

Por defecto, confirmas cada precio en Studio Pro. Si activas la generación automática al conectar, debes indicar un máximo por generación y otro para las últimas 24 horas. Los presupuestos muestran el precio final que cobra Studio Pro. Preparar propuestas con el Chat utiliza tu cuota de asistente.

El acceso caduca en 90 días y se puede revocar desde tu cuenta. Cada presupuesto se genera una sola vez aunque el agente reintente la petición. Un presupuesto caducado requiere revisar de nuevo el precio.

Contrato real y referencias guardadas

Para dudas sobre los campos, utiliza studio_get_contract o consulta el contrato JSON actualizado. Ambos se generan del mismo esquema que valida studio_quote, e incluyen ejemplos. No hace falta gastar una llamada al asistente para preguntar por el formato.

Busca las fotos del proyecto con studio_list_references, indicando projectId y, opcionalmente, query con el nombre del personaje o producto. Puedes reutilizar referenceId sin enviar otra vez la imagen. Las fotos subidas con studio_upload_image también permanecen en la biblioteca y se pueden usar por assetId.

{
  "input": {
    "kind": "video", "kitId": null, "branding": false,
    "resolution": "768P", "aspectRatio": "9:16",
    "nativeAudio": true, "subtitles": true, "continuity": true,
    "scenes": [
      {"prompt": "La presentadora muestra el reloj y habla a cámara. Acción rápida desde el primer instante.", "duration": 10,
       "spokenLines": [{"speaker": "Presentadora", "text": "Un reloj que sigue tu ritmo, cada día."}]},
      {"prompt": "Continúa la acción: se abrocha el reloj y lo muestra funcionando en su muñeca.", "duration": 10,
       "onScreenText": "Tu tiempo, a tu manera"}
    ]
  }
}

Este ejemplo prepara 20 segundos sin proyecto. Para conservar una persona o producto concreto, añade a input.references un objeto con referenceId devuelto por la biblioteca y label con su nombre y papel. También admite {"imageUrl":"RUTA_PRIVADA_DEVUELTA","label":"Nombre y papel"} o assetId. Las rutas y los ID siempre deben proceder de tu cuenta. No uses los marcadores del ejemplo como referencias reales.

En cada referencia indica una sola fuente: imageUrl, url, assetId o referenceId. url y name son alias de compatibilidad de imageUrl y label. Con un ID guardado se puede reutilizar la etiqueta de la biblioteca. Una URL sin etiqueta necesita label.

Las herramientas internas del Chat usan otro formato. En studio_quote no son válidos audio_mode, music_style ni characters: utiliza nativeAudio, musicStyle y references. El diálogo va dentro de scenes[].spokenLines. Los campos desconocidos se rechazan para evitar perder instrucciones en silencio.

branding:true aplica la marca; no sustituye una foto de personaje. Con kitId:null y branding:false no se heredan fotos, marca ni voz de otro proyecto. En studio_chat puedes pasar referenceIds; si indicas un proyecto y nombras un personaje etiquetado en su biblioteca, Studio Pro puede reutilizar una foto de ese personaje sin adjuntarla otra vez. Las fotos elegidas se conservan visibles en la conversación.

Contexto desde una web

studio_read_website lee una URL pública que hayas indicado y devuelve texto y direcciones de imágenes y vídeos encontrados. No usa IA ni consume cuota del asistente. El contenido es material externo no verificado: no cambia permisos ni autoriza acciones. Si eliges una imagen de la web, el agente la guarda con studio_upload_image antes de usarla. Esta lectura no ejecuta JavaScript ni interpreta cada fotograma de los vídeos; para webs que requieren acceso, aporta el texto y el material por separado.

Cuotas del asistente para agentes

La conversación por MCP tiene una cuota diaria separada de la web y mayor que la de esta. studio_get_context devuelve agentAssistant.usedPercent y resetsAt. El límite se renueva a las 00:00 UTC y también se mantiene un límite global de servicio. La cuota de conversación es independiente del saldo para generar. Consultar el contrato, buscar referencias, leer una web y calcular presupuestos no usa cuota conversacional ni descuenta créditos de generación.

ChatGPT

En los ajustes de ChatGPT, habilita el modo desarrollador si tu plan y tu espacio de trabajo lo permiten.
Crea una conexión de desarrollador usando la dirección MCP y autenticación OAuth.
Inicia sesión en Studio Pro, revisa los permisos y utiliza la conexión en tu conversación.

Los menús pueden variar. Esto no supone publicar una aplicación en el directorio de ChatGPT. Guía oficial.

Gemini CLI

Añade este servidor a la configuración de Gemini CLI. Sustituye el marcador con una credencial creada en Studio Pro; no compartas ni publiques el archivo con la credencial.

{
  "mcpServers": {
    "studiopro": {
      "httpUrl": "https://studioproimagen.com/mcp",
      "headers": { "Authorization": "Bearer TU_CREDENCIAL_MCP" },
      "timeout": 180000
    }
  }
}

También puedes usar OAuth si tu versión lo admite. Esta guía se refiere a Gemini CLI, no a una extensión de la aplicación web de Gemini. Documentación oficial.

OpenClaw

openclaw mcp set studiopro '{"url":"https://studioproimagen.com/mcp","transport":"streamable-http"}'
openclaw mcp configure studiopro --auth oauth --oauth-scope 'studio:read studio:plan studio:generate'
openclaw mcp login studiopro
openclaw mcp doctor studiopro --probe

La disponibilidad depende de la versión y del entorno del agente. Documentación oficial.

Hermes

hermes mcp add --url https://studioproimagen.com/mcp --auth oauth studiopro
hermes mcp test studiopro

Se abrirá el navegador para autorizar la cuenta. Recarga la sesión para ver las herramientas. Documentación oficial.

Amun Agent y otros agentes

Usa MCP remoto con la dirección indicada y OAuth, o una cabecera Authorization: Bearer TU_CREDENCIAL_MCP. Los campos de configuración dependen de cada agente. Si solo admite MCP local por entrada/salida estándar, necesitará un adaptador a Streamable HTTP.

Tu primera petición

Quiero un vídeo vertical de 30 segundos con dos clips enlazados. Usaré estas fotos como personajes. Pregúntame lo que falte, prepara los diálogos y muéstrame el precio antes de generar.

Indica quién aparece en cada foto. El agente puede subir PNG, JPG y WebP de hasta 10 MB mediante base64 o una URL HTTPS accesible. Mantén las mismas referencias durante la historia.

Configuración y publicación

studio_workspace_status y studio_project consultan la configuración. studio_workspace crea proyectos, actualiza branding/voz y guarda referencias como avatares, productos o logos. No es obligatorio completar toda la marca.

{"action":"create_project","requestId":"UUID-NUEVO","settings":{"name":"Mi marca","primary_color":"#12abcd"}}

Sube la imagen con studio_upload_image y usa save_reference con referenceId, label, referenceKind (avatar, product, logo, location), projectId y, si procede, setAsDefault:true.

studio_connect_social devuelve un enlace que debe abrir el titular para autorizar sus redes. Después consulta studio_social_accounts. El proveedor debe estar activado por Studio Pro.

studio_publication_draft prepara borradores con mediaUrl, redes y título. Para carruseles usa mediaType:carousel y mediaUrls ordenadas. studio_publish requiere permiso de publicación y las identidades de cuentas consultadas previamente. Sin ese permiso, entrega el enlace de revisión. studio_publications consulta el estado; studio_cancel_publication cancela envíos pendientes.

studio_carousel_quote prepara 2–10 imágenes con prompt, headline, subheadline y cta por diapositiva. Devuelve un presupuesto por imagen y el total; antes de generar comprueba saldo y límites. Los carruseles se publican juntos en Instagram, Facebook o Threads.

Registro, contraseñas, pagos, claves y permisos de conexión los gestiona el titular en la aplicación. Los agentes no pueden concederse permisos.

Herramientas de creación

studio_get_contract: campos reales y ejemplos de creación, sin IA.
studio_list_references: referencias persistentes por proyecto, nombre e ID.
studio_read_website: texto y medios descubiertos en una página pública.
studio_get_context: saldo, proyectos, voces y trabajos recientes.
studio_chat: preparar una historia. Conserva conversationId para continuar y reutiliza requestId UUID únicamente para reintentar el mismo mensaje.
studio_get_conversation: recuperar fotos, mensajes y propuestas.
studio_upload_image: incorporar referencias.
studio_quote: presupuestar un plan estructurado escrito por tu propio agente.
studio_get_quote: consultar el precio; refresh: true actualiza uno caducado.
studio_generate: generar con quoteId y maxCredits, dentro de los límites autorizados.
studio_get_generation: consultar el progreso y los enlaces temporales al resultado.
studio_list_voices: consultar voces gratuitas o del proveedor conectado.

Permisos: studio:read, studio:plan, studio:generate. Los permisos adicionales studio:configure y studio:publish se autorizan por separado. Las conexiones anteriores conservan sus permisos: amplía una credencial manual desde Cuenta o vuelve a autorizar OAuth.

OAuth utiliza PKCE S256, registro dinámico de clientes públicos y acceso renovable. El valor de resource es la URL exacta del MCP. Consulta los trabajos al menos cada 10 segundos; si un enlace a medios caduca, solicita uno nuevo.

Guía revisada el 19 de septiembre de 2026. Los ejemplos se basan en clientes con soporte de MCP remoto; no implican certificación ni publicación en sus directorios.