T3rnel Browser — Session Bridge

Ponte de Sessão MCP

Um servidor MCP (Model Context Protocol) gratuito que expõe automação de sessão de navegador autenticada: session_* ferramentas que rodam no perfil Chrome do próprio usuário e na sessão real logada, algo que APIs de navegador em nuvem não conseguem fazer. Um modo standalone gratuito também está disponível; ele inicia um navegador de automação dedicado para que as mesmas ferramentas session_* funcionem sem a extensão ou uma licença.

O que ele faz

• Serve MCP via stdio (JSON-RPC delimitado por nova linha) para qualquer cliente que fale o Model Context Protocol. O guia de configuração cobre os mais comuns.
• Usa um design de transporte duplo:
  • Modo extensão (gratuito; ferramentas Pro controladas pela extensão) — encaminha chamadas por um socket de retransmissão local exclusivo do proprietário para um host de mensagens nativas que o Chrome inicia, e de lá para a extensão T3rnel Browser, que as executa contra as abas autenticadas ao vivo.
  • Modo standalone (gratuito) — inicia seu próprio navegador CDP com ou sem interface em um perfil persistente e o controla diretamente. Sem licença, sem extensão e sem acesso ao navegador diário do usuário.
• Retorna contexto de página estruturado, valores de formulário, snapshots e capturas de tela sem enviar cookies de sessão para um navegador remoto.

Preço

A ponte em si é gratuita, e este pacote não impõe licença própria.

O modo extensão alcança a sessão autenticada real do comprador por meio da extensão T3rnel Browser, e as ferramentas Pro que ele expõe são controladas pelo próprio nível Pro da extensão — US$ 29,99 uma vez, três dispositivos. O modo standalone é gratuito e não precisa nem da extensão nem de licença. Não há assinatura separada para este pacote, e nada aqui verifica uma; versões anteriores deste arquivo anunciavam níveis de US$ 9/mês e US$ 39/mês que nunca foram implementados, nunca foram aplicados e nunca foram compráveis.

Estrutura do projeto

• src/server.js — servidor MCP stdio: superfície de ferramentas, validação de esquema, roteamento de transporte duplo, cliente de retransmissão com reconexão e timeouts, e inicializador CDP standalone.
• src/cdp.js — gerenciamento de navegador CDP standalone e cliente WebSocket.
• src/native-host.js — host de mensagens nativas iniciado pelo Chrome; possui o socket de retransmissão e multiplexa servidores MCP concorrentes.
• src/framing.js — o enquadramento JSON de 4 bytes com prefixo de comprimento compartilhado por mensagens nativas e o socket de retransmissão.
• src/tools.js — as definições de ferramentas session_*, validação e mapeamento para as ferramentas browser_* da extensão.
• src/license.js — utilitários offline de verificação de licença Ed25519 usados pela extensão e testes.
• src/install.js — registro de host nativo --install / --uninstall para Chrome, Chromium, Brave e Edge.
• docs/setup-guide.md — instalação nos clientes MCP comuns, além de verificação e solução de problemas.
• docs/chrome-validation-checklist.md — etapas de validação de ponta a ponta para Chrome com a extensão T3rnel Browser.
• ads/ — ad-copy.md, o texto compartilhado de título e descrição usado ao enviar para MCPize, Smithery, mcp.so e PulseMCP.
• tests/ — suíte node --test, incluindo testes de ponta a ponta por um socket de retransmissão real e enquadramento de mensagens nativas, além de cobertura do modo standalone.

Suporte a navegadores

O modo extensão precisa da extensão T3rnel Browser, que instala em Chrome, Brave, Edge e Chromium a partir de um único pacote. O Opera não implementa API de painel lateral e o Firefox não implementa API de depurador, então ambos têm suporte parcial; o gerador de manifesto da extensão indica quais capacidades estão ausentes em cada um. O modo standalone não tem requisito de navegador — ele inicia seu próprio navegador CDP.

A extensão expõe 98 ferramentas de navegador, todas acessíveis por esta ponte, sujeitas ao controle Pro da própria extensão e ao seu gate de aprovação.

Clientes suportados

• Claude Code / Claude Desktop
• Cursor
• VS Code
• Windsurf
• Antigravity
• IntelliJ
• Codex
• Grok Build
• Kimi Code / Kimi Desktop
• JCode
• Cline
• OpenCode
• Continue.dev
• KiloCode
• Roo Code
• Aider
• OpenClaw
• Hermes
• OpenFang
• Qualquer cliente que fale MCP stdio

Instale a extensão T3rnel Browser

A ponte funciona melhor com a extensão T3rnel Browser, que permite que sua IA controle o navegador no qual você já está logado:

https://t3ratech.github.io/t3rnel-browser-plugin/