opencode-browser-tool-installer/docs/VALIDACION_ENTORNO_LIMPIO.md

Validacion en entorno limpio (OpenCode)

Objetivo: verificar que opencode-browser-tool puede instalarse y usarse desde cero en una maquina con OpenCode.

Alcance de la validacion

• Instalacion de dependencias y Chromium gestionado por Playwright.
• Compilacion del servidor MCP.
• Conexion MCP visible para OpenCode.
• Ejecucion de una prueba minima end-to-end.

Prerrequisitos

• Node.js 20+ y npm.
• OpenCode CLI instalado y funcional.
• Acceso a internet para instalar dependencias y Chromium.

Pasos

1. Copiar el proyecto completo en una carpeta local, por ejemplo:

cp -R opencode-browser-tool "$HOME/opencode-browser-tool"

2. Instalar:

cd "$HOME/opencode-browser-tool"
./install.sh

3. Verificacion basica:

npm run check
npm run build

4. Configurar MCP para OpenCode con la ruta local real de dist/server.js:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "browser-tool": {
      "type": "local",
      "command": [
        "node",
        "/ABSOLUTE/PATH/opencode-browser-tool/dist/server.js"
      ]
    }
  }
}

5. Comprobar que OpenCode detecta el MCP:

opencode mcp list

Resultado esperado: browser-tool aparece como connected.

6. Prueba minima desde OpenCode:

• abrir navegador visible
• navegar a https://example.com
• tomar snapshot con label clean-env-smoke
• cerrar navegador

7. Verificar artifacts:

• Debe existir una captura en artifacts/.

Criterios de aceptacion

• install.sh termina sin error.
• npm run build termina sin error.
• opencode mcp list muestra browser-tool conectado.
• La prueba minima produce screenshot en artifacts/.

Resultado de la ejecucion

Rellenar al completar la validacion real:

• Fecha:
• Equipo/SO:
• Version Node:
• Version OpenCode:
• Resultado: pendiente | ok | fallo
• Evidencia (capturas/logs):
• Notas: