Tokens y repertorio

El token MCP autentica al cliente ante el relay, el pairing autoriza este dispositivo y el repertorio guarda una preferencia local de flows. Son tres conceptos distintos.

Tokens

webflow login genera un token tok_... y lo guarda en el keyring del sistema. Los clientes stdio compatibles lo usan sin incluir un valor literal en su configuración. Este token nunca arranca el worker.

Cada token es una credencial bearer revocable desde /tokens. Si alguien lo obtiene mientras tu worker está conectado, puede invocar los flows disponibles para tu cuenta. La creación manual y las variables de entorno quedan disponibles para CI y clientes avanzados.

Credencial del dispositivo

webflow login empareja este PC mediante el navegador y guarda una credencial wkr_... para la conexión del worker, separada del token MCP del keyring. Ninguna credencial sustituye a la otra.

Repertorio local de esta máquina

Los nombres guardados viven en ~/.webflow/repertoire.json. Es una preferencia del worker local, compartida por los clientes de esa máquina; no pertenece a un token o proyecto y no se sincroniza a Postgres.

El gateway mantiene una superficie estable: guardar un flow no crea una tool dinámica. Para descubrir, guardar, retirar y ejecutar se usan estas tools:

El agente explora el catálogo con browse_catalog o search_flows, pide detalle con describe_flow, y puede añadir un flow a su repertorio localmente con add_to_repertoire. Para retirarlo usa remove_from_repertoire; ambas acciones requieren tu acuerdo porque cambian una preferencia persistente de la máquina.

Ejecutar flows

Un flow guardado se ejecuta mediante run_flow_with_options. Para probar una vez un flow descubierto sin guardarlo, usa run_flow_once: primero devuelve una solicitud de confirmación y solo se repite con confirmed: true después de que aceptes.