Automatización web con Kitesurf WebMCP: guía práctica

Cómo usar Kitesurf WebMCP para la automatización web

Para usar Kitesurf WebMCP, conecta un agente compatible con MCP a Cloudflare Browser Run mediante Chrome DevTools MCP, configura el endpoint WebSocket con browser=kitesurf y habilita la categoría experimental de herramientas WebMCP. El agente obtendrá dos comandos esenciales: list_webmcp_tools, para descubrir las acciones de una página, y execute_webmcp_tool, para ejecutar una de ellas.

Empieza con una acción de solo lectura o reversible. Cloudflare Radar es un buen destino documentado porque expone acciones como navigate-to y set-location. Revisa el esquema que devuelve Kitesurf, proporciona únicamente los argumentos admitidos por ese esquema y compara después el resultado estructurado con el estado visible de la página. Una llamada a una herramienta no supera la prueba hasta que ambos coinciden.

Este recorrido es un plan de pruebas documentado, no la afirmación de que se haya realizado una prueba en vivo. En esta ejecución no había una cuenta de prueba de Cloudflare ni un token de Browser Run disponibles, por lo que no se inventa ningún resultado satisfactorio más adelante.

Qué cambia realmente Kitesurf WebMCP

MCP y WebMCP cumplen funciones distintas. MCP conecta al agente con el navegador remoto. WebMCP permite que el sitio web publique sus propias acciones con nombre dentro de ese navegador. MCP es la línea telefónica y WebMCP, el menú al otro lado: la línea establece la conexión; el menú indica con precisión qué se puede pedir y qué datos requiere cada opción.

Sin ese menú, un agente suele leer la página, localizar un control, hacer clic, esperar y volver a leer. Con WebMCP, una página puede exponer una función como set-location con entradas tipadas. El agente aún debe elegir la acción correcta y validar la salida, pero ya no necesita deducir cada interacción a partir de píxeles o de la estructura de la página.

Según la documentación de WebMCP de Cloudflare, Kitesurf tiene una implementación propia, por lo que no necesita una sesión de Chrome Lab. Las páginas pueden registrar herramientas programáticas mediante document.modelContext, y Kitesurf también reconoce herramientas declarativas de formularios marcadas con los atributos toolname y tooldescription.

Cómo conectar un cliente MCP a Kitesurf

Se necesita Node.js 20.19 o una versión posterior, un cliente compatible con MCP, el ID de una cuenta de Cloudflare y un token de API con el permiso Browser Rendering - Edit. La configuración de clientes MCP de Cloudflare incluye Claude Desktop, Claude Code, Cursor y OpenCode. Si esta es la primera conexión MCP del equipo, la selección de servidores MCP ayuda a entender qué función cumple el servidor local.

El lanzamiento de Kitesurf de Cloudflare propone esta configuración para el cliente local:

{
  "mcp": {
    "kitesurf": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "chrome-devtools-mcp@latest",
        "--wsEndpoint=wss://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/browser-run/devtools/browser?browser=kitesurf",
        "--wsHeaders={\"Authorization\":\"Bearer <CLOUDFLARE_API_TOKEN>\"}",
        "--category-experimental-webmcp"
      ],
      "enabled": true
    }
  }
}

Adapta la estructura al formato que espere el cliente, pero conserva los argumentos del comando. Guarda el ID real de la cuenta y el token en secretos respaldados por variables de entorno, no en un archivo de configuración versionado. No copies en esta URL los parámetros de Chrome Lab. Kitesurf utiliza browser=kitesurf, no necesita lab=true y no admite keep_alive.

La última bandera es imprescindible. --category-experimental-webmcp añade list_webmcp_tools y execute_webmcp_tool a Chrome DevTools MCP. Sin ella, la conexión puede funcionar sin problemas y, aun así, no mostrar ninguno de los dos comandos WebMCP.

Cómo ejecutar una tarea verificada en Cloudflare Radar

La prueba útil más pequeña debe demostrar cuatro cosas: que el descubrimiento funciona, que el esquema se puede leer, que la ejecución devuelve datos y que la página refleja el resultado.

1. Pide al agente conectado que abra https://radar.cloudflare.com/. Limita la tarea a una cuenta de prueba y evita cualquier acción con consecuencias económicas, destructivas o para toda la cuenta.
2. Ejecuta list_webmcp_tools. Guarda el nombre, la descripción y el esquema de entrada de cada herramienta devuelta. El conjunto disponible puede cambiar tras navegar o ejecutar otra acción, por lo que este inventario corresponde al estado actual de la página.
3. Si aparece una acción inocua como set-location, selecciónala y lee el esquema devuelto. No deduzcas los nombres de los argumentos a partir de este artículo: el esquema en vivo es el contrato.
4. Ejecuta execute_webmcp_tool con un valor de ubicación válido según el esquema. Registra el nombre exacto de la herramienta, los argumentos, el resultado estructurado, el tiempo transcurrido y el estado visible de la página.
5. Compara la respuesta con lo que muestra Radar. Vuelve a ejecutar list_webmcp_tools después del cambio de estado y registra las acciones que se hayan añadido o eliminado.

Un prompt útil para el agente puede ser así de directo:

Trata la evidencia como un pequeño registro de pruebas, no como una transcripción del chat. Como mínimo, conserva estos campos:

Así, una demostración se convierte en una prueba que un equipo de ingeniería puede repetir. También permite distinguir un fallo de WebMCP de un error de razonamiento del agente. Si la herramienta indicada no aparece, la interfaz falló antes de la ejecución. Si la llamada se completa pero la página no coincide, la implementación o la verificación fallaron después.

Cuándo necesita Kitesurf una ruta alternativa

Kitesurf WebMCP no es una capa universal para controlar el navegador. Sus límites actuales determinan qué tareas de producción pueden canalizarse por esta vía con seguridad.

• Las herramientas registradas dentro de un iframe o una ventana emergente no se exponen mediante CDP. Deben considerarse inaccesibles para el agente y resolverse con una ruta de navegador convencional, una intervención humana o una herramienta de nivel superior si el sitio es propio.
• Las sesiones de Kitesurf no aparecen en wrangler browser list y no ofrecen vista en vivo. Un agente no puede completar una herramienta que se detenga para pedir la confirmación de una persona.
• Para una acción sujeta a confirmación, la vía manual que documenta Cloudflare es el panel WebMCP, dentro de Application, en el entorno de pruebas de Kitesurf. Se trata de un traspaso, no de automatización desatendida.
• Kitesurf no implementa la política de permisos tools de WebMCP ni el filtrado de herramientas por origen. Descubrir una herramienta no equivale a tener autorización. Mantén una lista de permitidos independiente para dominios, acciones e identidades de prueba.
• La lista de herramientas depende del estado. Vuelve a enumerarla después de navegar o de ejecutar cualquier acción que cambie la página antes de asumir que la siguiente herramienta continúa disponible.

El patrón honesto para producción es un enrutador: WebMCP primero cuando haya una acción con nombre adecuada, automatización convencional del navegador cuando no exista y traspaso a una persona cuando la acción exija consentimiento. No escondas esas ramas detrás de un único prompt optimista.

El cálculo de negocio está en el mantenimiento, no solo en el precio del navegador

Kitesurf es gratuito durante la beta dentro de los límites de la cuenta, pero Cloudflare no ha indicado que las tarifas generales por uso adicional de Browser Run se apliquen a esa beta gratuita. El panorama actual de precios y límites de Kitesurf se analiza por separado, junto con las razones para no construir un modelo de costos permanente a partir de una oferta beta.

Este mercado ya tiene un presupuesto real para infraestructura de navegador. Browserbase ofrece planes de pago de $20 y $99 al mes. Browserless ofrece planes de $25 y $140 al mes con facturación anual. Estos productos cubren trabajos de infraestructura más amplios, así que no se afirma que sean sustitutos equivalentes. Lo que demuestran es que los equipos ya pagan por operar agentes de navegador.

WebMCP modifica otra partida del presupuesto: el mantenimiento de selectores, los reintentos y la revisión por parte de operadores. No elimina el navegador, el modelo, los controles de seguridad, la validación de resultados ni la ruta alternativa. Mide la misma tarea de las dos formas y compara el tiempo transcurrido, los intentos fallidos, las intervenciones humanas y las correcciones de ingeniería. Conserva Kitesurf solo cuando la reducción comprobada del mantenimiento supere el trabajo de integración.

Siete casos de uso, ordenados por quién obtiene más valor

Todos los casos siguientes parten de que la página de destino realmente expone una herramienta WebMCP adecuada. Kitesurf no puede crear una acción que el sitio no ofrezca.

El primer caso tiene el valor más amplio porque la mayoría de los equipos trabajará durante años con una web híbrida. Un enrutador que sepa cuándo no debe usar WebMCP resulta más útil que una demostración que solo funciona en una página preparada.

Tres productos que vale la pena crear

1. Un enrutador WebMCP con ruta alternativa

Crea una capa de políticas para equipos que trabajan con agentes. Debe enumerar las herramientas de una página, cotejar la acción solicitada por el usuario con un esquema autorizado y dirigir la tarea a execute_webmcp_tool, a la automatización convencional del navegador o a una cola atendida por personas. Es la oportunidad más sólida porque resuelve el vacío de adopción sin esperar a que todos los sitios implementen WebMCP.

Ya se percibe demanda en torno a esta necesidad: browser automation recibe unas 720 búsquedas mensuales, mientras que la consulta comercial browser automation tools alcanza unas 260 y registra un CPC de $34.28 en los datos de palabras clave de esta ejecución. La versión mínima vendible necesita un conector de cliente MCP, una lista de dominios y acciones permitidos, un comparador de esquemas, un registro de ejecución y un adaptador para la ruta alternativa.

El obstáculo es el alcance. La cobertura de WebMCP sigue siendo limitada, los conjuntos de herramientas pueden cambiar con el estado de la página y Kitesurf no puede exponer mediante CDP herramientas alojadas en iframes o ventanas emergentes. El motor alternativo forma parte del producto; no es una función opcional para más adelante.

2. Un monitor de regresiones de WebMCP

Ofrece a los propietarios de sitios una comprobación programada que registre los nombres y esquemas de las herramientas expuestas, ejecute una acción de prueba reversible, compare el resultado con la página visible y avise si detecta diferencias. Cerca de 590 búsquedas mensuales corresponden a website automation, con un CPC de $33.88. La consulta relacionada en singular browser automation tool creció un 24% interanual en los datos de sugerencias.

Un MVP puede supervisar una lista breve de rutas propias con credenciales de prueba, guardar los inventarios de herramientas anteriores y posteriores, y producir un registro compacto del fallo con los argumentos, el resultado, el tiempo y el estado de la página. El problema es el estado: la ausencia de una herramienta puede deberse a una ruta o sesión incorrectas, no necesariamente a una versión defectuosa. Por eso, el producto necesita navegación reproducible y datos de prueba bien controlados.

3. Un auditor de preparación para WebMCP

Crea un servicio de evaluación previa para equipos web que identifique qué recorridos de cliente exponen herramientas de nivel superior, qué acciones se encuentran detrás de iframes o ventanas emergentes y cuáles requieren la aprobación de una persona. El indicador de demanda es práctico: playwright browser automation recibe unas 320 búsquedas mensuales y creció un 129% interanual, mientras que website automation alcanza unas 590.

La versión más pequeña acepta las rutas de un sitio propio y una identidad de prueba, enumera y clasifica las herramientas disponibles y entrega un informe de implementación priorizado. La limitación real es la observabilidad. Como Kitesurf no puede exponer mediante CDP las herramientas anidadas en iframes o ventanas emergentes, el auditor no puede deducir desde Kitesurf cuáles eran sus contratos previstos. Necesita información del propietario del sitio o un segundo método de inspección para distinguir entre lo oculto y lo inexistente.

Límites y conclusión sin adornos

Usa Kitesurf WebMCP ahora para tareas acotadas y reversibles en las que una acción estructurada sea claramente mejor que una secuencia de clics. No lo conviertas en la única ruta de un flujo crítico, una experiencia de pago anidada o una tarea que deba esperar la aprobación de una persona en vivo.

La función aporta valor, pero el lanzamiento va por delante del ecosistema. El modelo de acciones con nombre puede reducir la ambigüedad y facilitar el diagnóstico de errores. No prepara automáticamente todos los sitios web para los agentes ni convierte una respuesta devuelta en prueba de que la página actuó correctamente. El límite de producto que importa es la verificación.

Si necesitas construir esta conexión, el sistema de pruebas de verificación y la política de rutas alternativas para un agente de producción, puedo ayudarte con el sistema de producción.