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.
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
| Ferramenta | O que faz |
|---|---|
read_page | Lê a página ao vivo como texto ou markdown |
page_elements | Lista até 200 links, botões e inputs visíveis, cada um com um seletor CSS quando existe |
click | Clica num elemento |
fill_field | Digita num input ou textarea |
screenshot_page | Screenshot PNG da página inteira, salvo na pasta de escrita do servidor |
navigate | Carrega uma URL na aba atual e retorna a URL final e o título |
save_profile | Salva cookies e armazenamento num arquivo nomeado, para restaurar os cookies depois |
get_cdp_endpoint | Retorna 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.
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.
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 e fixe o mcp abaixo da 2.0, como no bloco de instalação acima (o clearcote-mcp 0.1.0 não roda no mcp 2.x), e depois use clearcote-mcp ou npx -y clearcote-mcp como comando.
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.
Vá mais fundo na documentação
Recursos relacionados
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.
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.
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.
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
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.
Grátis para um navegador com GitHub. Sem cartão.