Pular para o conteúdo
MCP · npx · pip

Um servidor MCP de navegador com uma identidade real

Adicione o Clearcote à configuração do seu cliente MCP e o modelo ganha um navegador em que consegue ler, clicar e digitar por meio de vinte ferramentas. A identidade é definida uma vez, em variáveis de ambiente, então a lista de ferramentas fica curta e o fingerprint continua consistente enquanto o agente trabalha.

Obter grátisLer a documentação do MCP

Roda o build aberto sem chave. Adicione uma chave grátis via GitHub para ter o build mais recente.

Adicione à configuração do seu cliente

{
  "mcpServers": {
    "clearcote": {
      "command": "npx",
      "args": ["-y", "clearcote-mcp"],
      "env": {
        "CLEARCOTE_FINGERPRINT": "acct-1",
        "CLEARCOTE_TIMEZONE": "America/New_York",
        "CLEARCOTE_ACCEPT_LANGUAGE": "en-US"
      }
    }
  }
}

Destaques

Vinte ferramentas

navigate, read_page, page_elements, click, fill_field e screenshot_page, além de espera, teclas, abas, cookies, PDFs e sessões salvas.

A identidade fora do prompt

Seed, plataforma, marca, idioma e fuso horário são variáveis de ambiente CLEARCOTE_*. O modelo nunca precisa raciocinar sobre fingerprints.

Os clientes que você já usa

Claude Desktop, Cursor e Cline usam o mesmo formato de configuração. Instale pelo PyPI e rode direto ou pelo launcher via npx.

Sem switch de automação

O servidor inicia o navegador sem o switch de automação do Playwright, então o navigator.webdriver continua false, e o motor mantém os efeitos colaterais habituais do CDP longe da página.

Uma saída para o CDP puro

O get_cdp_endpoint retorna a URL CDP do navegador, então um script pode continuar na mesma sessão em que o agente estava trabalhando.

O build mais recente com uma variável

Adicione CLEARCOTE_LICENSE_KEY para rodar o build licenciado mais recente em vez do aberto.

Como o servidor MCP funciona

O servidor inicia um navegador Clearcote e o mantém aberto enquanto estiver rodando. Cada chamada de ferramenta atua nesse navegador compartilhado: o modelo lê a página como texto ou markdown, lista os links, botões e inputs visíveis, com um seletor CSS para cada um quando existe, e age sobre eles com esses seletores, então raramente precisa escrever os próprios.

A identidade é fixada quando o servidor inicia. O básico da persona (seed, plataforma, marca, idioma, fuso horário, proxy e geoip) são variáveis CLEARCOTE_*, então uma entrada de servidor é uma identidade, e nenhuma ferramenta consegue mudá-la no meio de uma tarefa. Para o resto das flags de fingerprint, use o SDK diretamente.

Existem duas formas de deixar um modelo no comando do Clearcote. Este servidor mantém o modelo fora do navegador, chamando ferramentas. Já o agente embutido no navegador roda dentro do processo do navegador e conversa com um endpoint compatível com a OpenAI que você escolhe.

As ferramentas mais usadas

FerramentaO que faz
read_pageLê a página ao vivo como Markdown (padrão) ou como texto visível, com o status HTTP
page_elementsLista até 200 links, botões e inputs visíveis, cada um com um seletor CSS quando existe
clickClica num elemento
fill_fieldDigita num input ou textarea
screenshot_pageScreenshot PNG da página inteira, salvo na pasta de escrita do servidor
navigateCarrega uma URL na aba atual e retorna a URL final e o título
save_profileSalva cookies e armazenamento num arquivo nomeado, para restaurar os cookies depois
get_cdp_endpointRetorna a URL CDP para um cliente CDP puro

Além de get_page_html, press_key, wait_for, evaluate_js, current_page, get_cookies, list_tabs, new_tab, close_tab, load_profile, get_egress_info e save_page_pdf (só em headless).

Para que as pessoas usam

Pesquisa com um navegador de verdade

Deixe o modelo ler páginas que precisam de JavaScript para renderizar, em vez de um fetch só de texto.

Tarefas rotineiras na web

Cadastros, páginas de configuração e dashboards que, de outro modo, você percorreria clicando à mão.

Depuração com um assistente

Peça ao Cursor para reproduzir um bug no seu ambiente de staging e tirar um screenshot de cada etapa.

Prototipar uma automação

Percorra um fluxo com o modelo, depois pegue o endpoint CDP e transforme tudo em script.

O Clearcote foi feito para privacidade, testes, pesquisa e automação lícita. Você é responsável pela forma como o usa e por seguir os termos dos sites que visita.

O diff

38.921 linhas entre o Chromium original e o Clearcote Pro.

Essa é a distância entre o build Pro e o Chromium que o Google distribui. Cada valor que um site pode ler é definido onde o Chromium o calcula, então a página, seus workers e seus iframes descrevem o mesmo dispositivo.

  • Canvas
  • WebGL
  • WebGPU
  • Áudio
  • Fontes
  • Tela e janela
  • WebRTC
  • TLS
  • Client hints
  • Tempo de entrada
  • Vozes e codecs
Leia os patches do build aberto no GitHub

Build Pro, contado na pilha de patches do r57 (Chromium 156.0.8078.47). O build aberto gratuito é um conjunto de patches menor e público.

Chromium 156.0.8078.47 → Clearcote Pro r57

345 files changed, 35915 insertions(+), 3006 deletions(-)

240 patches

Arquivos alterados, por área

  • Motor de renderização (Blink)118
  • Navegador (chrome/)52
  • Camada content42
  • Componentes39
  • Pilha de rede22
  • Interface e janelas14
  • TLS (BoringSSL)11
  • V8 e URL17
  • Todo o resto30

Qual plano inclui

O servidor MCP é grátis em todos os planos. Ele roda o build aberto, a não ser que encontre uma chave de licença (CLEARCOTE_LICENSE_KEY, ou uma salva pelo clearcote login); uma chave grátis via GitHub roda o build mais recente, um navegador por vez.

Comparar planos

Perguntas frequentes

Com quais clientes MCP ele funciona?

Clientes que iniciam servidores MCP a partir de um arquivo de configuração. O exemplo acima é do Claude Desktop, e o Cursor e o Cline usam o mesmo formato.

O modelo controla o fingerprint?

Não. A identidade vem de variáveis de ambiente quando o servidor inicia, e nenhuma ferramenta a altera. Isso mantém a persona consistente durante toda a sessão e a lista de ferramentas curta.

Preciso de Node ou de Python?

Python 3.10 ou mais recente, em qualquer caso: o pacote npm é um launcher para o mesmo servidor Python. Instale com pip, como no bloco de instalação acima — o próprio clearcote-mcp depende da biblioteca mcp e roda nas versões 1.x e 2.x, então não há nada para fixar —, e depois use clearcote-mcp como comando, ou deixe que o npx -y clearcote-mcp o encontre ou instale para você (com uvx, pipx ou pip).

Qual é a diferença para o agente embutido no navegador?

O servidor MCP deixa um modelo externo (o do seu cliente de chat) controlar o navegador por meio de ferramentas. O agente embutido roda dentro do navegador e chama um endpoint de modelo que você configura. Os dois controlam o mesmo motor.

Um script pode assumir a sessão do agente?

Sim. O get_cdp_endpoint retorna a URL CDP do navegador que o agente está usando, e o Playwright ou o Puppeteer podem se conectar a ela.

O agente consegue acessar a minha rede local?

Não por padrão. Desde o clearcote-mcp 0.3.0, endereços da sua máquina, da rede local e endpoints de metadados de nuvem são recusados em toda requisição que o navegador faz, não só na URL passada a uma ferramenta. O WebSocket aberto pelo script de uma página e um hostname cujo endereço muda depois da verificação não estão cobertos, então isso é uma proteção contra erros, não uma sandbox. CLEARCOTE_ALLOW_PRIVATE_EGRESS=1 desativa a proteção para desenvolvimento local. O texto que as ferramentas retornam de uma página é marcado como dado não confiável, para que o modelo consiga distingui-lo das suas instruções.

O que aconteceu com o servidor MCP do Puppeteer?

O servidor MCP do Puppeteer (@modelcontextprotocol/server-puppeteer) foi um dos servidores de referência do Model Context Protocol: sete ferramentas (navigate, screenshot, click, hover, fill, select e evaluate) que deixavam um modelo controlar um Chrome local pelo Puppeteer. O projeto MCP o arquivou em 29 de maio de 2025, então ele não recebe mais atualizações. Este servidor cobre o mesmo terreno com vinte ferramentas, mantém a identidade do navegador consistente e continua aceitando o Puppeteer: passe o endereço retornado por get_cdp_endpoint para puppeteer.connect().

Vá mais fundo na documentação

Recursos relacionados

Navegador para agentes de IA

Dê ao browser-use, Stagehand, Crawl4AI ou ao seu próprio agente um Chromium com identidade no nível do motor, ou rode o agente opcional embutido no Clearcote com o seu próprio modelo.

Docker e endpoint CDP

Rode o Clearcote como endpoint CDP permanente pela imagem Docker oficial, pelo serve() ou por uma CLI, e conecte qualquer framework sem mudar o código.

Navegadores hospedados

Inicie um navegador Clearcote na nuvem com uma chamada de API e conecte o Playwright ou o Puppeteer via CDP. IP residencial incluído, cobrança por GB de tráfego.

Controle de fingerprint

Canvas, WebGL, WebGPU, áudio, fontes, tela e hardware derivados no motor C++ a partir de um único seed, com locale e fuso horário ajustados para combinar, para que todas as superfícies concordem entre si.

Leituras relacionadas

Perguntas e respostasWhat is CDP detection?The Chrome DevTools Protocol drives automation but leaves side-effects — Runtime.enable, injected init scripts, main-world execution — that a page can observe. Spotting those is CDP detection.Perguntas e respostasHow do anti-bot systems detect automation?Anti-bot systems read three layers: driver/binary artifacts, CDP side-effects, and the fingerprint surface (canvas, WebGL, TLS). One tool rarely fixes all three.DocumentaçãoServidor MCP: Clearcote para agentes de IALigue Claude Desktop, Cursor ou Cline ao MCP do Clearcote: navegador stealth compartilhado e 20 ferramentas — read_page, click, fill_field, screenshot_page.

Experimente o Clearcote

Plug-and-play no Playwright e no Puppeteer, coerente até o handshake TLS, com um build de código aberto para começar.

Obter grátisTodos os recursos

Grátis para um navegador: GitHub, uma verificação de cartão ou uma conta corporativa do Google. Nunca é cobrado.