teste
/
testes
Template
2
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects 1 Releases Wiki Activity
testes/.agent/project/WORKSPACE_MCP_ENABLE_GUIDE.md

5.8 KiB
Raw Blame History

Guia para Habilitar MCP Browser Tools no Cursor

Data: 2026-01-24
Objetivo: Habilitar os servidores MCP do navegador para realizar testes automatizados

Método 1: Via Interface do Cursor (Recomendado)

Passo a Passo:

  1. Abrir Configurações do Cursor:

    • Pressione Ctrl + , (ou Cmd + , no Mac)
    • Ou vá em: File > Preferences > Settings

  2. Navegar para MCP:

    • Na barra de busca das configurações, digite: MCP
    • Ou navegue manualmente: Features > MCP

  3. Adicionar Novo Servidor MCP:

    • Clique no botão "+ Add New MCP Server" ou "New MCP server"
    • Preencha os campos:
      • Name: cursor-ide-browser (ou qualquer nome descritivo)
      • Type: stdio (Standard Input/Output)
      • Command: O comando para executar o servidor
      • Args: Argumentos adicionais (se necessário)

  4. Configuração para cursor-ide-browser:

    • Se o servidor já estiver instalado localmente, você pode precisar apenas habilitá-lo
    • Verifique se há uma opção para "Enable" ou "Activate" o servidor

  5. Recarregar/Refresh:

    • Após adicionar, clique no botão de refresh (🔄) para recarregar os servidores
    • Isso deve popular a lista de ferramentas disponíveis

  6. Verificar Ferramentas:

    • As ferramentas MCP devem aparecer na lista de ferramentas disponíveis
    • Ferramentas esperadas do cursor-ide-browser:
      • browser_navigate - Navegar para uma URL
      • browser_snapshot - Capturar estrutura da página
      • browser_click - Clicar em elementos
      • browser_type - Digitar texto
      • browser_tabs - Gerenciar abas
      • browser_lock / browser_unlock - Bloquear/desbloquear navegador

Método 2: Via Arquivo de Configuração

Localização do Arquivo:

Windows:

%APPDATA%\Cursor\User\settings.json

Ou:

%USERPROFILE%\.cursor\config\mcp.json

Configuração JSON:

Adicione ao settings.json:

{
  "window.commandCenter": true,
  "mcp.servers": {
    "cursor-ide-browser": {
      "command": "node",
      "args": ["path/to/cursor-ide-browser/server.js"],
      "env": {}
    }
  }
}

OU crie um arquivo mcp.json separado:

{
  "mcpServers": {
    "cursor-ide-browser": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    },
    "browsermcp": {
      "command": "npx",
      "args": ["@browsermcp/mcp@latest"]
    }
  }
}

Após Editar:

  1. Salvar o arquivo
  2. Reiniciar o Cursor completamente (fechar todas as janelas e abrir novamente)
  3. Verificar se as ferramentas estão disponíveis

Método 3: Verificar Instalação do Servidor

Verificar se o servidor está instalado:

# Verificar se há servidores MCP no diretório do projeto
Get-ChildItem "C:\Users\Daivid.alves\.cursor\projects\c-Users-Daivid-alves-Desktop-Repositorios-PlatformSistemas\mcps" -Directory

Instalar servidor MCP do navegador (se necessário):

# Tentar instalar via npm (pode falhar se cache estiver configurado incorretamente)
npm install -g @browsermcp/mcp

# OU instalar localmente no projeto
npm install @browsermcp/mcp --save-dev

Verificação de Funcionamento

Teste Rápido:

Após habilitar, tente usar as ferramentas MCP:

  1. Abrir o Composer no Cursor
  2. Solicitar: "Navegue para https://dev.workspace.itguys.com.br/plataforma/workspace/login"
  3. Verificar: Se a ferramenta browser_navigate é chamada automaticamente

Se as ferramentas não aparecerem:

  1. Verificar logs do Cursor:

    • Abra o Developer Tools: Help > Toggle Developer Tools
    • Verifique a aba "Console" para erros relacionados a MCP

  2. Verificar se o Node.js está no PATH:

    node --version
npm --version

  3. Reiniciar o Cursor completamente

  4. Verificar permissões:

    • Certifique-se de que o Cursor tem permissão para executar comandos
    • Em alguns casos, pode ser necessário executar como administrador

Solução de Problemas

Problema: "Tool not found"

Causa: Servidor MCP não está ativo ou não está configurado corretamente.

Solução:

  1. Verificar se o servidor está listado nas configurações MCP
  2. Verificar se o servidor está habilitado (toggle ON)
  3. Clicar no botão de refresh
  4. Reiniciar o Cursor

Problema: "Command not found"

Causa: O comando especificado não está no PATH ou não existe.

Solução:

  1. Verificar se o Node.js está instalado e no PATH
  2. Usar caminho absoluto para o comando
  3. Verificar se o pacote npm está instalado globalmente ou localmente

Problema: "Connection refused" ou "Server not responding"

Causa: O servidor MCP não está iniciando corretamente.

Solução:

  1. Verificar logs de erro no Developer Tools
  2. Testar o comando manualmente no terminal
  3. Verificar se há conflitos de porta
  4. Verificar variáveis de ambiente necessárias

Próximos Passos Após Habilitar

Uma vez que o MCP estiver habilitado e funcionando:

  1. Testar Navegação Básica:

    • Navegar para a URL de login
    • Capturar snapshot da página
    • Verificar elementos visíveis

  2. Executar Testes Automatizados:

    • Seguir o guia em WORKSPACE_MANUAL_TEST_EXECUTION.md
    • Mas agora usando automação via MCP
    • Documentar resultados automaticamente

  3. Integrar com Agentes de Teste:

    • Os agentes podem usar as ferramentas MCP diretamente
    • Testes podem ser executados de forma automatizada
    • Resultados podem ser gerados automaticamente

Referências

Última atualização: 2026-01-24