Conecta tu agente.

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

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:

{"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:

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