Selenix MCP

Servidor Selenix MCP

Conecte o Claude Desktop ao Selenix por meio do Model Context Protocol. Converse com o Claude para criar, executar, depurar e gerenciar testes de automação de navegador — exatamente como usar o Assistente de IA integrado, mas com o poder do Claude.

Pré-requisitos

• Aplicativo de desktop Selenix instalado
• Claude Desktop instalado
• Node.js 18 ou posterior

Ative a Ponte no Selenix

Antes de usar qualquer um dos métodos de configuração abaixo, ative a ponte dentro do Selenix:

1. Abra o Selenix
2. Vá para Configurações do Sistema (ícone de engrenagem na barra lateral)
3. Role até a seção Servidor MCP
4. Defina Ativar Servidor MCP como Sim

Isso inicia um servidor de ponte local ao qual o servidor MCP se conecta.

Configuração

Escolha um dos seguintes métodos:

Opção A: Instalar via npm (recomendado)

npm install -g @selenix/mcp-server

Em seguida, encontre o caminho global do seu npm:

npm root -g

Abra o arquivo de configuração do Claude Desktop:

• Windows: Pressione Win+R, cole %APPDATA%\Claude\claude_desktop_config.json, pressione Enter
• macOS: Abra ~/Library/Application Support/Claude/claude_desktop_config.json

Adicione o servidor Selenix MCP, substituindo o caminho pela saída de npm root -g:

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

Exemplo (Windows com nvm):

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

Exemplo (macOS/Linux):

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

Se você já tiver outros servidores MCP configurados, adicione "selenix" junto a eles dentro do objeto "mcpServers" existente.

Opção B: Usar a versão integrada (sem necessidade de npm)

Se você instalou o Selenix como aplicativo de desktop, o servidor MCP já está integrado. Não é necessário instalar nada — basta apontar o Claude Desktop para o arquivo integrado.

Encontre a pasta de instalação do Selenix e procure por resources/mcp-server/index.js, depois adicione à configuração do Claude Desktop:

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

Caminho típico no Windows:

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

Opção C: Download manual

1. Baixe bundle.js da página do pacote npm ou da página de versões
2. Salve-o em algum lugar da sua máquina (por exemplo, C:/selenix-mcp/bundle.js)
3. Adicione à configuração do Claude Desktop:

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

O Node.js ainda é necessário — o servidor MCP é um único arquivo JavaScript sem outras dependências.

Verificação

Reinicie o Claude Desktop após editar a configuração. Você deve ver o ícone de ferramentas do Selenix (martelo) na área de entrada do chat.

Tente perguntar ao Claude:

• "Quais testes existem no meu projeto Selenix?"
• "Crie um teste que abra google.com e pesquise por 'automação selenium'"
• "Execute o teste atual e corrija quaisquer falhas"
• "Tire uma captura de tela do navegador"

Como Funciona

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

O servidor MCP traduz as chamadas de ferramentas do Claude em solicitações HTTP para um servidor de ponte executado dentro do Selenix. A ponte tem acesso total aos componentes internos do Selenix — as mesmas capacidades do Assistente de IA integrado.

• A ponte escuta apenas em 127.0.0.1 (localhost) — sem exposição à rede
• A autenticação é feita por meio de um token de portador gerado automaticamente a cada inicialização do Selenix
• A configuração da conexão é armazenada em ~/.selenix/bridge.json e relida a cada chamada, portanto, reiniciar o Selenix não exige reiniciar o Claude Desktop

Ferramentas Disponíveis

Leitura e Inspeção

Ferramenta	Descrição
get_screenshot	Capturar uma captura de tela da janela do navegador
get_page_html	Obter o HTML da página com elementos interativos anotados
get_search_html	Pesquisar o HTML da página por padrão de regex
get_selected_command_info	Obter o contexto DOM para o elemento alvo de um comando
get_current_test	Obter todos os comandos do teste atual
get_test_list	Listar todos os testes do projeto
get_test_by_name	Obter um teste pelo nome
get_command_list	Listar todos os comandos Selenix disponíveis
get_command_info	Obter documentação detalhada de um comando específico
get_project_info	Obter metadados do projeto
get_active_suite	Obter o conjunto de testes ativo
get_step_results	Obter resultados de aprovação/reprovação da última execução de teste
get_logs	Obter logs recentes (todos os tipos), 20 por página, mais recentes primeiro. Parâmetro opcional page para paginação.
get_workspace_context	Obter um resumo do espaço de trabalho atual

Escrita e Execução

Ferramenta	Descrição
add_commands	Adicionar comandos a um teste em uma posição específica
run_test	Executar um teste e aguardar resultados (até 2 minutos)
clear_and_replace_commands	Substituir todos os comandos de um teste
fix_commands	Aplicar correções direcionadas — atualizar, remover ou inserir comandos

Solução de Problemas

"Não foi possível ler a configuração da ponte do Selenix" O Selenix não está em execução ou o Servidor MCP não está ativado. Abra o Selenix → Configurações do Sistema → defina Ativar Servidor MCP como Sim.

"Não foi possível conectar à ponte do Selenix" O Selenix pode ter acabado de reiniciar. Tente a solicitação novamente — o servidor MCP detectará automaticamente os novos detalhes de conexão.

Ferramentas não aparecem no Claude Desktop Certifique-se de ter reiniciado o Claude Desktop após editar o arquivo de configuração. Verifique se o JSON da configuração é válido (sem vírgulas finais, colchetes corretos).

O Claude Desktop não abre após alteração na configuração O JSON da configuração provavelmente está malformado. Abra o arquivo de configuração em um editor de texto, corrija a sintaxe JSON e tente novamente. Problemas comuns: vírgula ausente entre entradas, vírgula final após a última entrada.

Desinstalação

npm uninstall -g @selenix/mcp-server

Em seguida, remova a entrada "selenix" do arquivo de configuração do Claude Desktop e reinicie o Claude Desktop.