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 texto o markdown |
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.
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 y fija mcp por debajo de 2.0, como en el bloque de instalación de arriba (clearcote-mcp 0.1.0 no funciona con mcp 2.x), y luego usa clearcote-mcp o npx -y clearcote-mcp como comando.
¿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.
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 con GitHub. Sin tarjeta.