Puppeteer MCP: abrir páginas num navegador local e ver a consola

Para quem serve

Para quem precisa que um modelo abra páginas web num navegador local real, leia a consola ou deixe capturas. A evidência afirma: é um servidor MCP de automatização de navegador com Puppeteer; o modelo pode interagir com páginas, tirar capturas e executar JavaScript num ambiente de navegador real.

Corre na sua máquina, por isso também pode alcançar ficheiros locais e IPs locais/internas. Só ligue se aceitar essa fronteira de privacidade e puder vigiar dados sensíveis. A evidência não lista clientes; só cobre: já tem um cliente que consegue configurar MCP e pode executar npx.

A página oficial está na árvore servers-archived. A evidência não escreve à parte o estado de manutenção nem um substituto; não o trate como um produto atual ainda atualizado.

Concluir a primeira tentativa em 3 minutos

Siga o caminho NPX da evidência. Na configuração MCP do cliente use:

"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-puppeteer"]

Não tome o Docker como caminho principal ao mesmo tempo. A evidência só acrescenta: o Docker usa Chromium sem cabeça; o NPX abre uma janela do navegador.

Pré-condições: Node/npx está instalado localmente; a primeira tentativa só abre uma página pública a que tem direito, sem submeter formulário nem iniciar sessão. Depois de arrancar, um navegador corre nesta máquina e pode aceder a ficheiros locais e endereços internos.

Onde configurar: a configuração de servidor MCP do cliente (comando e argumentos stdio). Depois de guardar, reinicie ou recarregue o cliente.

Primeira chamada de baixo risco: chame apenas puppeteer_navigate, escrito por completo na evidência, e navegue para o URL acabado de mencionar. A evidência não dá os campos de parâmetros; o resumo collect também menciona screenshot, click, hover, fill, select, evaluate, mas esses locators não estão expandidos — não os chame na primeira tentativa.

Sinal de sucesso: no caminho NPX deve ver uma janela de navegador local aberta e ficar no endereço que deu. Depois pode ler o recurso console://logs (saída de consola em texto) ou screenshot://<name> (PNG). Se a janela não aparecer, confirme primeiro que usa NPX e não Docker.

Casos de uso

Caso 1: Fazer o modelo abrir uma página pública indicada. Chame puppeteer_navigate. A evidência só garante «navegar para qualquer URL no navegador»; não fala de tempos limite, redirecionamentos nem cookies locais. O que pode confirmar: a navegação acontece num navegador local real; não assuma uma sessão cloud isolada.

Caso 2: Depois de abrir a página, verificar a consola ou deixar uma captura. A primeira evidência indica capturas e execução de JavaScript; a evidência de recursos dá console://logs (todas as mensagens de consola do navegador) e screenshot://<name> (PNG de uma captura). A evidência não nomeia a ferramenta de captura, como se gera <name> nem os parâmetros de evaluate. Assim, o segundo passo só lê esses recursos, ou para em «a evidência só garante captura/JS» — não invente seletores nem scripts.

Limites de uso

Um navegador local pode aceder a ficheiros locais e IPs locais/internas e levar dados sensíveis. O NPX abre uma janela visível; o Docker usa Chromium sem cabeça. Os comportamentos diferem; não os misture e depois use uma janela como sinal de sucesso. A única ferramenta plenamente nomeada é puppeteer_navigate; as capacidades de interação (clique, preenchimento) não têm locator com parâmetros e têm efeitos secundários. Os recursos só listam consola e capturas; não há anulação, limpeza de cookies nem fecho do navegador. A evidência não dá lista de clientes, modelo de permissões nem pacote de substituição após o arquivo.