Selenix MCP

Selenix MCP Server

Conecta Claude Desktop a Selenix mediante el Model Context Protocol. Chatea con Claude para crear, ejecutar, depurar y gestionar pruebas de automatización de navegador, igual que con el Asistente de IA integrado, pero impulsado por Claude.

Requisitos previos

• Aplicación de escritorio de Selenix instalada
• Claude Desktop instalado
• Node.js 18 o posterior

Habilitar el puente en Selenix

Antes de usar cualquiera de los métodos de configuración siguientes, habilita el puente dentro de Selenix:

1. Abre Selenix
2. Ve a Configuración del sistema (icono de engranaje en la barra lateral)
3. Desplázate hasta la sección Servidor MCP
4. Establece Habilitar servidor MCP en Sí

Esto inicia un servidor puente local al que se conecta el servidor MCP.

Configuración

Elige uno de los siguientes métodos:

Opción A: Instalar mediante npm (recomendado)

npm install -g @selenix/mcp-server

Luego encuentra tu ruta global de npm:

npm root -g

Abre tu archivo de configuración de Claude Desktop:

• Windows: Pulsa Win+R, pega %APPDATA%\Claude\claude_desktop_config.json, pulsa Enter
• macOS: Abre ~/Library/Application Support/Claude/claude_desktop_config.json

Añade el servidor MCP de Selenix, reemplazando la ruta con la salida de npm root -g:

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["<npm-root-path>/@selenix/mcp-server/dist/bundle.js"]
    }
  }
}

Ejemplo (Windows con nvm):

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["C:/Users/YourName/AppData/Local/nvm/v18.20.8/node_modules/@selenix/mcp-server/dist/bundle.js"]
    }
  }
}

Ejemplo (macOS/Linux):

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["/usr/local/lib/node_modules/@selenix/mcp-server/dist/bundle.js"]
    }
  }
}

Si ya tienes otros servidores MCP configurados, añade "selenix" junto a ellos dentro del objeto "mcpServers" existente.

Opción B: Usar la versión incluida (no requiere npm)

Si instalaste Selenix como aplicación de escritorio, el servidor MCP ya está incluido. No necesitas instalar nada: solo apunta Claude Desktop al archivo incluido.

Busca tu carpeta de instalación de Selenix y localiza resources/mcp-server/index.js, luego añádelo a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["C:/path/to/Selenix/resources/mcp-server/index.js"]
    }
  }
}

Ruta típica en Windows:

C:/Users/YourName/AppData/Local/Programs/Selenix/resources/mcp-server/index.js

Opción C: Descarga manual

1. Descarga bundle.js desde la página del paquete npm o desde la página de versiones
2. Guárdalo en algún lugar de tu máquina (p. ej., C:/selenix-mcp/bundle.js)
3. Añádelo a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["C:/selenix-mcp/bundle.js"]
    }
  }
}

Node.js sigue siendo necesario: el servidor MCP es un único archivo JavaScript sin otras dependencias.

Verificación

Reinicia Claude Desktop después de editar la configuración. Deberías ver el icono de herramientas de Selenix (martillo) en el área de entrada del chat.

Prueba a preguntarle a Claude:

• «¿Qué pruebas hay en mi proyecto de Selenix?»
• «Crea una prueba que abra google.com y busque "selenium automation"»
• «Ejecuta la prueba actual y corrige cualquier fallo»
• «Toma una captura de pantalla del navegador»

Cómo funciona

Claude Desktop <--stdio--> MCP Server <--HTTP--> Bridge Server (inside Selenix)

El servidor MCP traduce las llamadas a herramientas de Claude en solicitudes HTTP a un servidor puente que se ejecuta dentro de Selenix. El puente tiene acceso completo a los componentes internos de Selenix: las mismas capacidades que el Asistente de IA integrado.

• El puente solo escucha en 127.0.0.1 (localhost): sin exposición a la red
• La autenticación se gestiona mediante un token de portador generado automáticamente cada vez que se inicia Selenix
• La configuración de conexión se almacena en ~/.selenix/bridge.json y se vuelve a leer en cada llamada, por lo que reiniciar Selenix no requiere reiniciar Claude Desktop

Herramientas disponibles

Lectura e inspección

Herramienta	Descripción
get_screenshot	Captura una captura de pantalla de la ventana del navegador
get_page_html	Obtiene el HTML de la página con elementos interactivos anotados
get_search_html	Busca en el HTML de la página mediante un patrón regex
get_selected_command_info	Obtiene el contexto DOM del elemento objetivo de un comando
get_current_test	Obtiene todos los comandos de la prueba actual
get_test_list	Enumera todas las pruebas del proyecto
get_test_by_name	Obtiene una prueba por su nombre
get_command_list	Enumera todos los comandos disponibles de Selenix
get_command_info	Obtiene documentación detallada de un comando específico
get_project_info	Obtiene metadatos del proyecto
get_active_suite	Obtiene la suite de pruebas activa
get_step_results	Obtiene los resultados de aprobado/fallido de la última ejecución de pruebas
get_logs	Obtiene registros recientes (todos los tipos), 20 por página, los más recientes primero. Parámetro opcional page para paginación.
get_workspace_context	Obtiene un resumen del espacio de trabajo actual

Escritura y ejecución

Herramienta	Descripción
add_commands	Añade comandos a una prueba en una posición específica
run_test	Ejecuta una prueba y espera los resultados (hasta 2 minutos)
clear_and_replace_commands	Reemplaza todos los comandos de una prueba
fix_commands	Aplica correcciones específicas: actualiza, elimina o inserta comandos

Solución de problemas

«No se puede leer la configuración del puente de Selenix» Selenix no se está ejecutando o el servidor MCP no está habilitado. Abre Selenix → Configuración del sistema → establece Habilitar servidor MCP en Sí.

«No se puede conectar al puente de Selenix» Es posible que Selenix se haya reiniciado recientemente. Intenta la solicitud de nuevo: el servidor MCP detectará automáticamente los nuevos datos de conexión.

«Las herramientas no aparecen en Claude Desktop» Asegúrate de haber reiniciado Claude Desktop después de editar el archivo de configuración. Verifica que el JSON de configuración sea válido (sin comas finales, corchetes correctos).

«Claude Desktop no se abre después de cambiar la configuración» Es probable que el JSON de configuración esté mal formado. Abre el archivo de configuración en un editor de texto, corrige la sintaxis JSON e inténtalo de nuevo. Problemas comunes: falta una coma entre entradas, coma final después de la última entrada.

Desinstalación

npm uninstall -g @selenix/mcp-server

Luego elimina la entrada "selenix" de tu archivo de configuración de Claude Desktop y reinicia Claude Desktop.