kogiQA MCP Web Browser

oficial

Este é um navegador web que permite que seu agente de codificação, como o Claude Code, visite sites em seu nome e ajude você a identificar bugs ou criar casos de teste de interface do usuário.

GitHub
144

O que você pode fazer com Kogi QA Web Browser MCP?

  • Depurar problemas de estilo — Peça ao agente para inspecionar uma página em uma largura de viewport específica, identificar problemas de layout e sugerir correções de CSS.
  • Corrigir erros de console automaticamente — Faça o agente navegar por todas as páginas vinculadas a um menu, coletar erros de console e aplicar correções no código-fonte.
  • Mapear e documentar a funcionalidade do aplicativo web — Instrua o agente a rastrear links internos até uma profundidade definida e produzir um documento Markdown descrevendo cada página e seus recursos.
  • Gerar testes de ponta a ponta — Descreva um fluxo de usuário (ex.: cadastro) e peça ao agente para percorrê-lo e gerar testes Cypress cobrindo o caminho feliz e erros de validação.
  • Realizar testes exploratórios — Solicite testes exploratórios com tempo limitado, usando entradas de casos extremos em todos os formulários, com um relatório de qualquer coisa quebrada ou inconsistente.

Documentação

kogiQA MCP Web Browser

Um servidor Model Context Protocol (MCP) que fornece capacidades de automação de navegador usando kogiQA. Este servidor permite que LLMs interajam com páginas web através de linguagem natural, eliminando a necessidade de capturas de tela ou modelos ajustados visualmente.

Para que usar:

  • Depurar problemas de estilo na sua página
  • Corrigir automaticamente erros de console.
  • Mapear e documentar a funcionalidade da sua aplicação web
  • Escrever automaticamente testes ponta a ponta
  • Automatizar testes exploratórios da sua aplicação

Veja prompts de exemplo em Exemplos de Uso

kogiQA MCP vs Playwright MCP

O Servidor MCP kogiQA fornece um navegador que incorpora as capacidades do algoritmo de controle de navegador kogiQA. Isso permite que agentes interajam com páginas sem um seletor, economizando tempo e tokens.

Instalação

Instalação automática:

npx kogiqa-mcp@latest

Claude Code

claude mcp add kogiqa-browser npx kogiqa-mcp@latest

VS Code

Clique em um dos botões abaixo para instalar diretamente no VS Code:

Install in VS Code Install in VS Code Insiders

Alternativamente, instale via CLI do VS Code:

code --add-mcp '{"name":"kogiqa-browser","command":"npx","args":["kogiqa-mcp@latest"]}'

Cursor

Install in Cursor

Alternativamente, vá para Cursor Settings → MCP → Add new MCP Server e insira o comandonpx kogiqa-mcp@latest.

Configuração padrão

Para qualquer outro cliente MCP, adicione o seguinte à sua configuração MCP:

{ "mcpServers": { "kogiqa-browser": { "command": "npx", "args": [ "kogiqa-mcp@latest" ] } } }

Exemplos de Uso

Uma vez que o servidor esteja configurado, simplesmente fale com seu agente em linguagem natural. Como o kogiQA é livre de seletores, você descreve o que quer que seja feito — não como encontrar os elementos.

Teste de fumaça de um fluxo de usuário

Open http://localhost:3000, log in with the demo credentials, add the first product to the cart, and verify that the cart badge shows "1".

Depurar um problema de estilo

Go to https://myapp.example.com/pricing and check why the "Pro" plan card overflows its container on a 1280px-wide viewport. Suggest a CSS fix.

Corrigir erros de console

Navigate to http://localhost:5173, open every page linked from the main menu, collect all console errors, and fix them in the source code.

Mapear e documentar sua aplicação

Explore https://staging.example.com, follow all internal links up to two levels deep, and produce a Markdown document describing each page and its main features.

Gerar testes ponta a ponta

Walk through the sign-up flow at http://localhost:3000/signup and write Cypress end-to-end tests covering the happy path and validation errors.

Testes exploratórios

Do 10 minutes of exploratory testing on http://localhost:8080: try edge-case inputs in every form you find and report anything that looks broken or inconsistent.

Requisitos

  • Node.js 20 ou mais recente
  • VS Code, Cursor, Windsurf, Claude Desktop, Goose, Junie ou outro cliente MCP