O status Connected não garante que o agente consiga usar o navegador. Procure a primeira evidência ausente. O servidor inicializa, o cliente expõe ferramentas, a ação é permitida e a chamada retorna o estado esperado. Verifique por etapas.
1. O servidor iniciou?
Leia o primeiro erro de inicialização ou negociação. Em stdio, confirme que o cliente encontra e inicia o comando no ambiente real. No remoto, confira endpoint, transporte e login aprovado. No teste, um comando ausente gerou FileNotFoundError, errno 2, sem initialize.
2. O cliente expõe a ferramenta?
Compare tools/list com a lista da sessão ativa. Lista vazia do servidor é diferente de lista filtrada no cliente. Confira esquema, modo e descoberta. Playwright MCP 0.0.84 retornou 25 ferramentas, incluindo browser_navigate. Nosso filtro de diagnóstico mostrou zero. Não era o padrão do Playwright.
MCP · Tools VS Code · MCP servers
3. O navegador e a origem são permitidos?
Confira política, navegador, perfil, origem e ação. No teste, o filtro de rotas do Playwright rejeitou outra origem local com net::ERR_BLOCKED_BY_CLIENT. O servidor excluído recebeu zero requisições. É um filtro da aplicação. Controles de rede e administração são separados.
Playwright MCP · Configuration
4. O agente chamou a ferramenta?
Procure tools/call no registro. Um plano ou texto não comprova ação. O script parou após a descoberta com zero chamadas. Depois browser_navigate e browser_snapshot na origem permitida retornaram J01-FIXTURE. Não executamos modelo. Em uma sessão real, verifique modo e modelo e informe ferramenta, URL e resultado de leitura.
| Etapa | Resultado esperado |
|---|---|
| initialize | FileNotFoundError · errno 2 |
| tools/list | 25 → 0 |
| Origin filter | ERR_BLOCKED_BY_CLIENT · 0 requests |
| tools/call | 0 → J01-FIXTURE |
Faça uma verificação mínima
Peça que abra uma página aprovada, devolva URL final, título e marcador e pare. Compare resposta e resultado da ferramenta. Se a chamada direta funcionar mas o modelo não usar, confira seleção ou aprovação. Se falhar, guarde nome e erro estruturado.
| Ferramenta | Resultado esperado |
|---|---|
browser_navigate | URL · title |
browser_snapshot | J01-FIXTURE |
O que usuários relataram
No r/mcp, uma pessoa relatou timeout de tools/list após conectar um servidor stdio. No r/ClaudeAI, outra tinha conectores no Chat mas ferramentas indisponíveis no Code. São ambientes diferentes. Confira protocolo e sessão.
Connected significa que o navegador está pronto?
Pode indicar conexão com o servidor. Verifique ferramentas visíveis, chamada autorizada e resultado da página separadamente.
Perguntas frequentes
Connected significa que o navegador está pronto?
Pode indicar conexão com o servidor. Verifique ferramentas visíveis, chamada autorizada e resultado da página separadamente.
Como verificar a inicialização?
Leia o primeiro erro de inicialização ou negociação. Em stdio, confirme que o cliente encontra e inicia o comando no ambiente real. No remoto, confira endpoint, transporte e login aprovado. No teste, um comando ausente gerou FileNotFoundError, errno 2, sem initialize.
Por que a sessão mostra zero ferramentas?
Compare tools/list com a lista da sessão ativa. Lista vazia do servidor é diferente de lista filtrada no cliente. Confira esquema, modo e descoberta. Playwright MCP 0.0.84 retornou 25 ferramentas, incluindo browser_navigate. Nosso filtro de diagnóstico mostrou zero. Não era o padrão do Playwright.
Como verificar permissões?
Confira política, navegador, perfil, origem e ação. No teste, o filtro de rotas do Playwright rejeitou outra origem local com net::ERR_BLOCKED_BY_CLIENT. O servidor excluído recebeu zero requisições. É um filtro da aplicação. Controles de rede e administração são separados.
Como saber se a ferramenta foi chamada?
Procure tools/call no registro. Um plano ou texto não comprova ação. O script parou após a descoberta com zero chamadas. Depois browser_navigate e browser_snapshot na origem permitida retornaram J01-FIXTURE. Não executamos modelo. Em uma sessão real, verifique modo e modelo e informe ferramenta, URL e resultado de leitura.