Servidor MCP: controla Clearcote desde un agente de IA

Conecta Claude Desktop, Cursor o Cline al servidor MCP de Clearcote y deja que el modelo controle un único navegador compartido con 20 herramientas. La persona se define una sola vez por variables de entorno, así que el conjunto de herramientas queda limpio: el agente trabaja y, por debajo, la identidad se mantiene coherente.

Configura tu cliente MCP

Agrega Clearcote a la configuración MCP de tu cliente (el ejemplo es de Claude Desktop; Cursor y Cline usan la misma estructura):

json

{
  "mcpServers": {
    "clearcote": {
      "command": "npx",
      "args": ["-y", "clearcote-mcp"],
      "env": {
        "CLEARCOTE_FINGERPRINT": "acct-1",
        "CLEARCOTE_PLATFORM": "windows",
        "CLEARCOTE_PROXY": "http://host:8080",
        "CLEARCOTE_GEOIP": "1"
      }
    }
  }
}

Las dos vías ejecutan el mismo servidor en Python, así que necesitas Python 3.10+. Instálalo primero con pip —el lanzador de npx reutiliza después esa instalación— o usa "command": "clearcote-mcp" en la configuración. Fijar la versión de mcp mantiene el servidor en la versión de la biblioteca MCP para la que se desarrolló (clearcote-mcp 0.1.0 no funciona con mcp 2.x):

bash

pip install -U clearcote clearcote-mcp "mcp[cli]<2"

Sin clave de licencia, el servidor ejecuta el build abierto. Agrega CLEARCOTE_LICENSE_KEY a env (o ejecuta clearcote login una vez) para usar el build con licencia más reciente, ya sea Gratis con GitHub o Pro. Las claves gratuitas requieren el SDK clearcote 0.30.0 o posterior, y el comando anterior ya lo instala.

Herramientas

Veinte herramientas controlan un único navegador compartido:

Herramienta	Qué hace
`navigate`	Carga una URL en la pestaña actual (devuelve la URL final + el título)
`read_page`	Lee la página en vivo como texto/markdown
`page_elements`	Lista hasta 200 enlaces, botones y campos visibles, cada uno con su selector CSS cuando existe
`click`	Hace clic en un elemento
`fill_field`	Escribe en un input / textarea
`press_key`	Presiona una tecla (Enter, Tab, …)
`wait_for`	Espera a que aparezca un selector
`screenshot_page`	Captura PNG de la página completa, guardada en la carpeta del sandbox (devuelve la ruta)
`list_tabs / new_tab / close_tab`	Administra las pestañas
`save_profile / load_profile`	Guarda cookies + storage en un archivo con nombre dentro del sandbox y restaura las cookies más adelante: inicias sesión una vez y reutilizas la sesión
`get_egress_info`	La IP pública y la persona activa
`get_cdp_endpoint`	Devuelve la URL de CDP para conectar un cliente directamente

…además de get_page_html, evaluate_js, current_page, get_cookies (solo lectura) y save_page_pdf (solo en headless). El agente lee la página, decide y actúa, todo a través de una única instancia de Clearcote con una persona consistente.

La persona, por variables de entorno

Lo básico de la persona se define con variables de entorno CLEARCOTE_*, así que el modelo nunca tiene que ocuparse de la identidad. Para el resto de las opciones de huella digital, usa el SDK directamente.

bash

CLEARCOTE_FINGERPRINT=acct-1          # seed -> stable identity
CLEARCOTE_PLATFORM=windows            # windows | linux | macos | android
CLEARCOTE_BRAND=Edge                  # Chrome (default) | Edge | Opera | Vivaldi
CLEARCOTE_ACCEPT_LANGUAGE=en-US
CLEARCOTE_TIMEZONE=America/New_York
CLEARCOTE_PROXY=http://user:pass@host:8080
CLEARCOTE_GEOIP=1                     # timezone + language + WebRTC follow the proxy exit
CLEARCOTE_HEADLESS=0                  # show the window (default: headless)
CLEARCOTE_LICENSE_KEY=cc_lic_...      # optional -> the latest licensed build

Los proxies con autenticación requieren el build con licencia; el build abierto no puede pasarle al navegador las credenciales del proxy.

Protecciones

Se rechazan las llamadas a herramientas cuya URL apunte a localhost, a una red privada o a un endpoint de metadatos de la nube. Es una protección contra errores, no un sandbox: los scripts que se ejecutan con evaluate_js y los enlaces que sigue la página todavía pueden llegar a esas direcciones. Define CLEARCOTE_ALLOW_PRIVATE_EGRESS=1 para permitirlas (por ejemplo, para probar un servidor de desarrollo local).
Las capturas de pantalla, los PDF y las sesiones guardadas se escriben en <temp>/clearcote-mcp (CLEARCOTE_MCP_WRITE_DIR para cambiar la ubicación).
Cada llamada a una herramienta expira a los 90 segundos (CLEARCOTE_MCP_TOOL_TIMEOUT).
El navegador arranca en cuanto tu cliente MCP lanza el servidor. Con una clave Gratis con GitHub, eso ocupa de inmediato tu único slot de navegador; define CLEARCOTE_MCP_PREWARM=0 para que arranque con la primera llamada a una herramienta.

El servidor MCP lanza el navegador directamente, sin el flag de automatización de Playwright, así que navigator.webdriver se queda en false y el motor mantiene los efectos secundarios habituales de CDP fuera del alcance de la página. Hay dos formas de automatizar: un LLM fuera del navegador (este servidor MCP) o el agente de IA integrado en el navegador, que se ejecuta dentro del proceso.

¿Necesitas un endpoint directo en lugar de MCP? Consulta Despliegue & Docker.