---
name: auroflow
description: Conectar y operar Auro por MCP o HTTPS con una clave propia; elegir una receta de vídeo, audio o gráficas, recuperar el mismo trabajo y verificar entregas. Usar para Auro, sin acceso del agente a Chrome ni administración del servidor.
---

# Auro: entrada para agentes

Versión 2026.11.01.3 · Contrato `auroflow/public-agent/v1`.

## Conectar

Lee [la conexión compatible](references/connect-agent.md). El usuario crea su
clave propia revocable en https://auroflow.club/app#developers, también si entra
con Google. Guárdala en el gestor seguro como `AUROFLOW_API_TOKEN`; no la pidas
en el prompt ni la copies a otro ordenador. Sin credencial, prepara una propuesta
y explica el alta. Un chat que sólo lee no puede atribuirse ejecución.

MCP HTTP: `https://api.auroflow.club/v1/mcp`, con Authorization Bearer.
Stdio: `scripts/auroflow_mcp.py`, Python 3.9+ sin dependencias.
Selecciona `AUROFLOW_MCP_TOOLSET=film`, `graphics`, `editing`, `audio` o `full` según el encargo.
Basic Auth es una alternativa documentada. Un cliente remoto sólo OAuth sin
cabeceras ni stdio no es compatible actualmente.

Con la clave suministrada por el entorno seguro,
`python3 scripts/check_connection.py --toolset film` verifica conexión y
planificación sin guardar, inferir ni generar.

## Descubrir y elegir

Para vídeo empieza por `auroflow_agent_start {}`. La respuesta orienta el recorrido;
no comprueba todos los gates vivos ni autoriza generación. Para continuar un
trabajo usa `auroflow_list {kind:"films", limit:5}` y `auroflow_get {view:"next"}` de su ID
observado. Lee `response.project` para el guion completo.
Con el toolset `audio`, empieza por `auroflow_capabilities {area:"production"}` y los
catálogos de voces/fuentes; no uses el bootstrap de películas ausente de ese filtro.

Consulta `auroflow_capabilities {area:"production"}` para distinguir contratos
instalados, comprobación de runtime y disponibilidad de cada proveedor.
Para unir vídeo propio, locución terminada y capas editables, usa
`auroflow_plan_finishing` y [el recorrido de acabado](https://auroflow.club/production-finishing.md).
El plan es puro: no vincula fuentes, guarda capas ni renderiza. Una locución
`tts-` propia y terminada se usa como fuente `narration`. `audio.tracks`
combina hasta ocho capas de voz, música propia y sonido de tomas, con posición,
recorte, volumen, fundidos y silencio. Para conservar el audio base en una mezcla,
inclúyelo explícitamente como pista. Lee la [skill de montaje](https://auroflow.club/skills/auroflow-editing/SKILL.md).
Conserva los tiempos y textos literales; no produce subtítulos automáticos ni certifica el acento.

Elige una sola familia en https://auroflow.club/skills/manifest.json:
películas, producto, documental, Ingredients, series, dirección visual, capas,
motion graphics o Remotion. Los helpers locales de explicación, narración y
subtítulos declaran sus propios requisitos; su publicación no instala un
proveedor en el servidor. ElevenLabs requiere una clave y un presupuesto
independientes explícitos.

Para voces y locución independiente de Vids, consulta `auroflow_capabilities {area:"vids_voices"}` y
la [referencia de voces](https://auroflow.club/skills/auroflow-audio-production/references/vids-voices.md).
La [galería](https://auroflow.club/voces) reúne pruebas reales; la opción de
español de España es experimental. Los trabajos `tts-` tienen recuperación y
WAV privado propios, con coste vivo exactamente 0.
`auroflow_recover {action:"resume_preparation"}` retoma sólo la primera preparación
autorizada del mismo ID con prueba nativa de que nunca se envió; recover
continúa siendo sólo recogida. No cambia voz o texto ni abre otro documento.

Para voz, canción y mezcla WAV separadas, leer
[producción de audio](https://auroflow.club/audio-production.md) y su
[skill](https://auroflow.club/skills/auroflow-audio-production/SKILL.md).
`audio`: 14 herramientas. `auroflow_queue` lee tu actividad sin generar.
Mezcla con `auroflow_plan_audio_mix` y `auroflow_create_audio_mix`; Vids Music,
según `features.vids_music`, con `auroflow_plan_music` y
`auroflow_generate_music_zero`. Cada `mix-` o `mus-` se lee con `auroflow_get`,
se lista con `auroflow_list {kind}` y se recoge con `auroflow_recover`.
Mezclar no genera las fuentes ni acredita el coste de su creación.
Recover sólo recoge un envío; `action:"resume_preparation"` retoma la primera preparación
autorizada del mismo ID sólo con prueba nativa de que no hubo envío previo.
Se observó Lyria 3 en `clip` y Lyria 3.5 en `full_song`, con duración
aproximada30/180 s, no exacta. La narración y Vids Music exigen coste vivo0; Flow Music es otro
proveedor con presupuesto incluido y sigue bloqueado sin cotización/colector.

Las skills pueden leerse como recursos MCP o instalarse como ZIP verificado.
Cada ZIP contiene sus referencias compartidas; no necesita otras carpetas del
repositorio. El manifiesto declara versión, contrato, alcance y SHA-256.
Consulta una referencia al llegar a la operación; el [manual completo](references/manual.md)
queda disponible para tomas manuales, HTTP, errores y acabado avanzado.

## Trabajar con estado durable

Persiste brief, intención, IDs estables y petición antes de escribir. Consulta
motor, cuenta, estado, créditos, cola y referencias propias según la operación.
`auroflow_plan_workflow` es un plan sin IA ni guardado; sus `planned_*` no existen.

Para una película: prepara un borrador `auto_render:false`, lee y revisa el
guion, guarda el objeto completo con su revisión observada y relee la revisión
nueva. Conserva literalmente los diálogos. Elige reparto explícito y recursos
propios observados. Cada render exige alcance autorizado, controles vivos y
costes Auro/Flow exactamente cero, con Agent desactivado.

Comprueba errores JSON-RPC, `isError` y `http_status` interno. Una aceptación
202 requiere consultar el mismo ID; un HTTP 200 exterior no prueba éxito.
Tras timeout, consulta ese recurso; nunca repitas Generate ni crees un ID de
reemplazo. `401/403` requieren acceso, `409` releer revisión y `429` backoff.
La recuperación usa el ID existente y no cambia de perfil o transporte.

El agente no abre Chrome/CDP. Leer estado no reconecta ni rota; reconectar no
reenvía. Conserva IDs; el manual detalla `managed_endpoint` y sus límites.

Chrome, cola, montaje y acabado permanecen en el servidor. Descarga las variantes
propias verificadas y revisa todos sus segundos con audio. La validación técnica,
observación perceptual y aprobación humana se registran por separado.

Consulta https://auroflow.club/service.json para condiciones públicas y la API
autenticada para disponibilidad de tu cuenta. `account_check_required` no es
una caída confirmada. La caducidad de una clave, una promoción y el acceso al
servicio son condiciones distintas; no deduzcas una de otra.

La admisión puede estar restringida temporalmente: `403 access_restricted`
impide operar aunque la clave sea válida. Informa del bloqueo y conserva los
trabajos; no cambies cuenta, rol o clave para eludir la política.

Los trabajos y vídeos aparecen en Comunidad para miembros verificados; prompts,
referencias, email y saldo permanecen privados. Un post con título o texto
público requiere una instrucción específica del usuario. Consulta el manual
para el alcance de visibilidad antes de trabajar con contenido sensible.