Un servidor MCP de navegador con una identidad real
Agrega Clearcote a la configuración de tu cliente MCP y el modelo obtiene un navegador en el que puede leer, hacer clic y escribir mediante veinte herramientas. La identidad se define una sola vez, en variables de entorno, así que la lista de herramientas sigue siendo corta y la huella digital se mantiene coherente mientras el agente trabaja.
Ejecuta el build abierto sin clave. Agrega una clave gratuita de GitHub para usar el build más reciente.
Agrégalo a la configuración de tu cliente
{
"mcpServers": {
"clearcote": {
"command": "npx",
"args": ["-y", "clearcote-mcp"],
"env": {
"CLEARCOTE_FINGERPRINT": "acct-1",
"CLEARCOTE_TIMEZONE": "America/New_York",
"CLEARCOTE_ACCEPT_LANGUAGE": "en-US"
}
}
}
}Lo más destacado
Veinte herramientas
navigate, read_page, page_elements, click, fill_field y screenshot_page, además de esperas, pulsaciones de teclas, pestañas, cookies, PDF y sesiones guardadas.
La identidad, fuera del prompt
Seed, plataforma, marca, idioma y zona horaria son variables de entorno CLEARCOTE_*. El modelo nunca tiene que razonar sobre huellas digitales.
Los clientes que ya usas
Claude Desktop, Cursor y Cline comparten la misma estructura de configuración. Instálalo desde PyPI y ejecútalo directamente o con el lanzador de npx.
Sin flag de automatización
El servidor inicia el navegador sin el flag de automatización de Playwright, así que navigator.webdriver sigue en false, y el motor mantiene los efectos secundarios habituales de CDP lejos de la página.
Una salida a CDP directo
get_cdp_endpoint devuelve la URL de CDP del navegador, así que un script puede retomar la misma sesión en la que trabajaba el agente.
El build más reciente, con una variable
Agrega CLEARCOTE_LICENSE_KEY para ejecutar el build con licencia más reciente en lugar del abierto.
Cómo funciona el servidor MCP
El servidor inicia un navegador Clearcote y lo mantiene mientras el servidor está en ejecución. Cada llamada a una herramienta actúa sobre ese navegador compartido: el modelo lee la página como texto o markdown, lista los enlaces, botones y campos visibles con un selector CSS para cada uno cuando existe, y actúa sobre ellos con esos selectores, así que rara vez tiene que escribir los suyos.
La identidad queda fija cuando se inicia el servidor. Lo básico de la persona (seed, plataforma, marca, idioma, zona horaria, proxy y geoip) son variables CLEARCOTE_*, así que una entrada del servidor es una identidad, y ninguna herramienta puede cambiarla a mitad de una tarea. Para el resto de los flags de huella digital, usa el SDK directamente.
Hay dos formas de poner a un modelo al mando de Clearcote. Este servidor mantiene al modelo fuera del navegador, llamando a herramientas. El agente integrado en el navegador, en cambio, corre dentro del proceso del navegador y se comunica con un endpoint compatible con OpenAI que tú eliges.
Las herramientas más usadas
| Herramienta | Qué hace |
|---|---|
read_page | Lee la página en vivo como Markdown (por defecto) o su texto visible, con el código de estado HTTP |
page_elements | Lista hasta 200 enlaces, botones y campos visibles, cada uno con un selector CSS cuando existe |
click | Hace clic en un elemento |
fill_field | Escribe en un campo de entrada o un textarea |
screenshot_page | Captura de pantalla PNG de la página completa, guardada en la carpeta de escritura del servidor |
navigate | Carga una URL en la pestaña actual y devuelve la URL final y el título |
save_profile | Guarda las cookies y el almacenamiento en un archivo con nombre, para restaurar las cookies más tarde |
get_cdp_endpoint | Devuelve la URL de CDP para un cliente directo |
También están get_page_html, press_key, wait_for, evaluate_js, current_page, get_cookies, list_tabs, new_tab, close_tab, load_profile, get_egress_info y save_page_pdf (solo en headless).
Para qué se usa
Investigación con un navegador real
Deja que el modelo lea páginas que necesitan JavaScript para renderizarse, en lugar de una petición que solo trae texto.
Tareas web rutinarias
Registros, páginas de configuración y paneles que, si no, tendrías que recorrer a mano.
Depuración con un asistente
Pídele a Cursor que reproduzca un bug en tu sitio de staging y haga una captura de pantalla de cada paso.
Prototipar una automatización
Recorre un flujo con el modelo y luego toma el endpoint CDP y automatízalo con un script.
Clearcote está hecho para la privacidad, las pruebas, la investigación y la automatización lícita. Tú eres responsable de cómo lo usas y de respetar los términos de los sitios que visitas.
38.921 líneas entre Chromium original y Clearcote Pro.
Esa es la distancia entre el build Pro y el Chromium que distribuye Google. Cada valor que un sitio puede leer se define donde Chromium lo calcula, así que la página, sus workers y sus iframes describen el mismo dispositivo.
- Canvas
- WebGL
- WebGPU
- Audio
- Fuentes
- Pantalla y ventana
- WebRTC
- TLS
- Client hints
- Tiempos de entrada
- Voces y códecs
Build Pro, contado sobre su pila de parches de r57 (Chromium 156.0.8078.47). El build abierto gratuito es un conjunto de parches más pequeño y público.
345 files changed, 35915 insertions(+), 3006 deletions(-)
240 parches
Archivos modificados, por área
- Motor de renderizado (Blink)118
- Navegador (chrome/)52
- Capa content42
- Componentes39
- Pila de red22
- Interfaz y ventanas14
- TLS (BoringSSL)11
- V8 y URL17
- Todo lo demás30
Qué plan lo incluye
El servidor MCP es gratis en todos los planes. Ejecuta el build abierto a menos que encuentre una clave de licencia (CLEARCOTE_LICENSE_KEY, o una guardada con clearcote login); una clave gratuita de GitHub ejecuta el build más reciente, con un navegador a la vez.
Preguntas frecuentes
¿Con qué clientes MCP funciona?
Con los clientes que lanzan servidores MCP desde un archivo de configuración. Arriba se muestra Claude Desktop, y Cursor y Cline usan la misma estructura.
¿El modelo controla la huella digital?
No. La identidad viene de variables de entorno cuando se inicia el servidor, y ninguna herramienta la cambia. Así la persona se mantiene coherente durante toda la sesión y la lista de herramientas sigue siendo corta.
¿Necesito Node o Python?
Python 3.10 o posterior, en cualquier caso: el paquete de npm es un lanzador del mismo servidor en Python. Instálalo con pip, como en el bloque de instalación de arriba (clearcote-mcp depende por sí mismo de la biblioteca mcp y funciona con 1.x y 2.x, así que no hay nada que fijar), y luego usa clearcote-mcp como comando, o deja que npx -y clearcote-mcp lo encuentre o lo instale por ti (con uvx, pipx o pip).
¿En qué se diferencia del agente integrado en el navegador?
El servidor MCP permite que un modelo externo (el de tu cliente de chat) controle el navegador mediante herramientas. El agente integrado en el navegador corre dentro del navegador y llama a un endpoint de modelo que tú configuras. Ambos controlan el mismo motor.
¿Puede un script tomar el control de la sesión del agente?
Sí. get_cdp_endpoint devuelve la URL de CDP del navegador que usa el agente, y Playwright o Puppeteer pueden conectarse a ella.
¿Puede el agente acceder a mi red local?
No por defecto. Desde clearcote-mcp 0.3.0, las direcciones de tu máquina, de la red local y los endpoints de metadatos de la nube se rechazan en cada solicitud que hace el navegador, no solo en la URL que recibe una herramienta. El WebSocket de un script de la página y un nombre de host cuya dirección cambia después de la comprobación no están cubiertos, así que es una protección contra errores, no un sandbox. CLEARCOTE_ALLOW_PRIVATE_EGRESS=1 la desactiva para el desarrollo local. El texto que las herramientas devuelven de una página se marca como datos no confiables, para que el modelo pueda distinguirlo de tus instrucciones.
¿Qué pasó con el servidor MCP de Puppeteer?
El servidor MCP de Puppeteer (@modelcontextprotocol/server-puppeteer) era uno de los servidores de referencia del Model Context Protocol: siete herramientas (navigate, screenshot, click, hover, fill, select y evaluate) que permitían a un modelo controlar un Chrome local mediante Puppeteer. El proyecto MCP lo archivó el 29 de mayo de 2025, así que ya no recibe actualizaciones. Este servidor cubre lo mismo con veinte herramientas, mantiene coherente la identidad del navegador y sigue permitiendo usar Puppeteer: pasa la dirección que devuelve get_cdp_endpoint a puppeteer.connect().
Profundiza en la documentación
Características relacionadas
Dale a browser-use, Stagehand, Crawl4AI o tu propio agente un Chromium con identidad a nivel del motor, o ejecuta el agente opcional de Clearcote integrado en el navegador con tu propio modelo.
Ejecuta Clearcote como endpoint CDP permanente desde la imagen oficial de Docker, con serve() o una CLI, y conecta cualquier framework sin cambiar código.
Inicia un navegador Clearcote en la nube con una llamada a la API y conecta Playwright o Puppeteer por CDP. IP residencial incluida, facturación por GB de tráfico.
Canvas, WebGL, WebGPU, audio, fuentes, pantalla y hardware derivados en el motor C++ a partir de un solo seed, con la configuración regional y la zona horaria a juego, para que cada superficie coincida con todas las demás.
Lecturas relacionadas
Prueba Clearcote
Un reemplazo directo para Playwright y Puppeteer, coherente hasta el handshake TLS, con un build de código abierto para empezar.
Gratis para un navegador: GitHub, una verificación de tarjeta o una cuenta de Google de empresa. Nunca se cobra.