Saltar al contenido
WebFlowMCP

Instalar el worker

El worker es el proceso que corre en tu PC, abre tu Chrome real y ejecuta los flows que tu agente pide. Es la pieza que garantiza que tus credenciales nunca salgan de tu máquina.

Requisitos

  • Node.js 20 o superior
  • Google Chrome instalado
  • Una cuenta de WebFlowMCP para autorizar este equipo

Instalar y emparejar

El paquete instala tanto el gateway MCP como el CLI y el worker local:

terminal
npm install -g webflow-mcp

Empareja este equipo una sola vez. Se abrirá el dashboard para que autorices el dispositivo; después verifica que las credenciales worker y MCP quedaron guardadas:

terminal
webflow login --app https://app.webflowmcp.es
webflow login --status
webflow login crea la credencial de dispositivo wkr_... y guarda el token MCP en el keyring del sistema operativo. No tienes que pegar un token en la configuración de un cliente stdio compatible.

Arrancar el worker

Pide a tu agente que use start_worker para dejarlo en segundo plano. Como alternativa, puedes mantenerlo en primer plano desde una terminal:

terminal
webflow worker start

Es un comando de larga duración — se queda corriendo hasta que lo pares con Ctrl+C. Mientras esté activo, tu agente puede pedir flows que requieran tu sesión.

Ver el navegador mientras trabaja

Por defecto el worker corre en segundo plano, sin ventana visible. Para ver a Chrome trabajar en tiempo real, añade --headed:

webflow worker start --headed

Login de un proveedor

Esto es independiente del pairing del dispositivo. Para un flow que requiere sesión, tu agente debe consultar describe_flow, comprobar check_profile_status y, con tu permiso, abrir una ventana visible mediante start_profile_login. Inicia sesión, cierra esa ventana y vuelve a comprobar el estado.

El CLI también ofrece webflow profiles status --flow <flow> y webflow profiles login <profile> --url <login-url> para operar el profile manualmente.

Las sesiones se guardan únicamente en ~/.webflow/profiles/ y se reutilizan hasta que el proveedor las invalida. Nunca se sincronizan al relay ni al dashboard.
Instalar el worker — WebFlowMCP