# Conectar un agente a Auro

Documentación 2026.11.01.3 · Contrato `auroflow/public-agent/v1` · Actualizado el 2026-11-01.

## 1. Crear tu clave propia

Entra en https://auroflow.club/app#developers con tu cuenta de Auro. También
puedes entrar con Google: no necesitas una contraseña local. Si aún no tienes
cuenta, empieza en https://auroflow.club/app?register=1 y completa la verificación.
En «API y tokens», activa tu token permanente de Auroflow. No caduca; puedes
mostrarlo, copiarlo y rotarlo desde tu sesión. Rotar invalida inmediatamente el
anterior: actualiza los clientes que lo usaban. Las claves temporales con nombre
y caducidad de 7/30/90 días siguen como opción para agentes separados y sólo se
muestran una vez. Guarda el token en el almacén de secretos del cliente. No lo
pegues en conversaciones, repositorios, URLs ni archivos de petición. No necesita
credenciales de Google, Chrome o SSH.

El acceso también depende de la política de admisión vigente. Si recibes
`403 access_restricted`, la cuenta no está admitida temporalmente aunque su
clave y contraseña sigan siendo válidas. Comunica ese código al titular; no
cambies cuenta, rol o clave para eludir la restricción. La documentación pública
sigue siendo legible. `503 access_policy_unavailable` requiere revisión del
operador, no significa acceso abierto ni contraseña incorrecta.

## 2. Elegir una conexión compatible

| Capacidad del cliente | Conexión |
| --- | --- |
| HTTP con cabecera Authorization | MCP HTTP o REST con tu clave Bearer |
| MCP por stdio y Python 3.9+ local | Puente Python, sin dependencias externas |
| Sólo lectura de páginas | Preparar una propuesta; no atribuir llamadas reales |
| MCP remoto sólo OAuth, sin cabeceras ni stdio | Incompatible por ahora; necesita alguna de las dos capacidades anteriores |

### MCP por HTTP

Endpoint: `https://api.auroflow.club/v1/mcp`, transporte Streamable HTTP,
JSON-RPC sin sesión persistente del cliente. Configura la cabecera
`Authorization: Bearer <tu clave>` exclusivamente mediante el almacén seguro.
No se ofrece OAuth. Usa la configuración HTTP de tu cliente; no hay un JSON
de instalación universal. La sesión Chrome del servidor es independiente.

### MCP por stdio

Descarga el paquete general desde https://auroflow.club/skills/manifest.json,
verifica su SHA-256 y elige una carpeta compatible con tu agente. Este ejemplo
contiene sólo una ruta a sustituir y una variable no secreta:

```json
{"mcpServers":{"auroflow":{"command":"python3","args":["/ruta/absoluta/auroflow/scripts/auroflow_mcp.py"],"env":{"AUROFLOW_MCP_TOOLSET":"film"}}}}
```

Proporciona `AUROFLOW_API_TOKEN` desde el gestor de secretos o el entorno
protegido del proceso. No pongas el valor de la clave dentro de ese JSON.
Elige `film` para películas/documentales/anuncios, `graphics` para capas,
`editing` para montaje, `audio` para locución/canciones/mezcla WAV o `full`
para el catálogo completo.
Los filtros sólo reducen descubrimiento; no cambian permisos ni costes.
Para producción de audio, `audio` reúne 14 herramientas; consulta
https://auroflow.club/audio-production.md. Vids Music exige disponibilidad y
coste vivo0; Flow Music es otro proveedor con presupuesto incluido y continúa
bloqueado si no tiene cotización y colector verificados.

### REST y alternativa Basic

El cliente `scripts/auroflow.py` del mismo paquete lee `AUROFLOW_API_TOKEN`.
`python3 scripts/auroflow.py agent-start` hace una lectura sin generar.
Basic Auth con `AUROFLOW_API_EMAIL` y `AUROFLOW_API_PASSWORD` sigue disponible
como alternativa para cuentas con contraseña propia. Elige un solo método.

## 3. Comprobar sin crear trabajos

Desde el paquete general instalado, ejecuta:

```sh
python3 scripts/check_connection.py --toolset film
```

El comprobador usa la credencial de su entorno seguro. Comprueba initialize,
el catálogo seleccionado, entrada, estado y un plan determinista sin guardar
proyectos, ejecutar modelos ni generar. Devuelve un recibo JSON sin la clave.
Un plan válido no acredita disponibilidad viva ni autoriza un render.

Para MCP directo: initialize → tools/list con
`_meta:{"auroflow/toolset":"film"}` → `auroflow_agent_start {}`.
Comprueba error JSON-RPC, `isError` y `http_status` interno; HTTP 200 exterior
no convierte un error interno en éxito. `401/403`: resolver acceso;
`409`: releer revisión; `429`: respetar Retry-After. Un timeout exige consultar
el mismo ID; no repetir generación ni inventar otro ID.
Para comprobar sólo el catálogo y planes de audio, usa
`python3 scripts/check_connection.py --toolset audio`: no llama al bootstrap
de películas ni genera narración, música o mezcla.

## 4. Elegir una sola receta y continuar

Lee https://auroflow.club/llms.txt y la skill apropiada del manifiesto. Por MCP,
usa `resources/list` y `resources/read` con su URI anunciada. Instalar un ZIP
es opcional; cada paquete incluye sus referencias compartidas obligatorias.

Trabajo nuevo: `auroflow_agent_start` → motor/cuenta → plan → borrador
`auto_render:false` → leer/revisar guion → guardar completo/releer revisión →
render explícito una vez, si está autorizado y pasan ambos costes cero.
Para continuar: `auroflow_list {kind:"films", limit:5}` → `auroflow_get {view:"next"}` del ID
observado. No conviertas un ejemplo, `ready` o una sugerencia en autorización.

Estado público: https://auroflow.club/service.json describe un agregado.
`account_check_required` significa comprobar tu cuenta autenticada, no una
caída confirmada ni un bloqueo de tu trabajo. La cuenta, la cola y cada trabajo
tienen estados separados. Un MP4 completed necesita revisión completa de imagen
y audio; una transcripción automática no es aprobación humana.

## Compatibilidad y alcance de las comprobaciones

El paquete admite Python 3.9+ y los transportes anteriores. La comprobación de
publicación distingue HTTPS, stdio y contratos con fixtures. No certifica todos
los productos que implementan MCP ni genera un vídeo para comprobar conexión.
La versión y los hashes del manifiesto permiten detectar paquetes anteriores;
contrasta su `contract_version` antes de usar instrucciones antiguas.

Manual navegable: https://auroflow.club/docs · Texto completo:
https://auroflow.club/guide.md · Cambios: https://auroflow.club/agent-changelog.md