sncro.net

oficial

Depuração de navegador ao vivo para assistentes de IA — DOM, console, rede via MCP.

O que você pode fazer com Sncro Net MCP?

Criar uma sessão de depuração — peça ao seu assistente de IA para chamar create_session para que você possa conectar uma aba ativa do navegador ao relay.
Inspecionar a página atual — solicite um snapshot completo do DOM da aba do navegador conectada usando get_page_snapshot.
Consultar um elemento específico — peça ao assistente para recuperar detalhes sobre um elemento do DOM via query_element.
Capturar saída do console — faça o assistente exibir logs e erros do console que agent.js enviou do navegador.
Integrar o sncro em um aplicativo FastAPI ou Flask — adicione o middleware fornecido para que seu servidor de desenvolvimento local injete agent.js automaticamente.

Documentação

sncro-relay

Componentes de código aberto do sncro — o relay MCP, o agente do lado do navegador e os plugins de framework que permitem que assistentes de codificação com IA inspecionem um navegador ativo.

O que este repositório contém

Caminho	O quê
`relay/`	Aplicação FastAPI que expõe um servidor MCP mais endpoints de long-poll para agent.js
`relay/static/agent.js`	Script do lado do navegador injetado pelo middleware; envia dados do console + DOM para o relay
`middleware/sncro_middleware.py`	Plugin FastAPI / Starlette — middleware drop-in para aplicações FastAPI
`middleware/sncro_flask.py`	Plugin Flask — middleware drop-in para aplicações Flask
`trysncro/`	`try.sncro.net` — uma aplicação de demonstração deliberadamente quebrada para exercitar o sncro de ponta a ponta

Como funciona

 ┌──────────────┐    MCP     ┌──────────┐   long-poll   ┌─────────────┐
 │ Claude Code  │──tools────▶│  relay   │◀──────────────│  agent.js   │
 │ (or other    │            │ (relay/) │   snapshots   │ (injected   │
 │  MCP client) │◀──results──│          │──────────────▶│  by plugin) │
 └──────────────┘            └──────────┘               └─────────────┘
                                                              ▲
                                                              │ same-origin
                                                              │ cookies
                                                       ┌─────────────┐
                                                       │  your app   │
                                                       │ (plugin is  │
                                                       │  installed) │
                                                       └─────────────┘

Claude chama create_session (ferramenta MCP) → o relay retorna uma chave de sessão de 9 dígitos + URL
O usuário visita a URL no navegador onde sua aplicação está rodando → confirma via "Permitir depuração sncro?"
O plugin define um cookie, agent.js é injetado nas respostas HTML subsequentes naquela origem
agent.js envia dados de linha de base (console, erros) e faz long-poll para consultas sob demanda (query_element, get_page_snapshot, etc.)

Usando o sncro

A maioria dos usuários não precisa executar o relay por conta própria — a versão hospedada em relay.sncro.net é amigável ao plano gratuito. Registre seu projeto em sncro.net e obtenha sua chave de projeto.

FastAPI: adicione middleware/sncro_middleware.py ao seu projeto e então:

from middleware.sncro_middleware import SncroMiddleware, sncro_routes

app = FastAPI(debug=True)  # sncro only loads when debug=True
if app.debug:
    app.include_router(sncro_routes)
    app.add_middleware(SncroMiddleware, relay_url="https://relay.sncro.net")

Flask: adicione middleware/sncro_flask.py ao seu projeto e então:

from sncro_flask import init_sncro

app = Flask(__name__)
if app.debug:
    init_sncro(app, relay_url="https://relay.sncro.net")

Ambos os middlewares são ativados apenas em modo de depuração — zero sobrecarga em produção.

Contribuindo

Adoramos novos plugins de framework. CONTRIBUTING.md contém a especificação completa do que um plugin deve fazer — cookies, rotas, cabeçalhos de segurança — além do modelo de teste. Django, Rails, Express, Next.js, ASP.NET, Go — todos são bem-vindos.

Relatórios de bugs e problemas de segurança: veja SECURITY.md.

Licença

MIT. Veja LICENSE.

O painel em sncro.net (gerenciamento de projetos, cobrança, administração) reside em um repositório proprietário separado.