kogiQA MCP Web Browser
oficialEste é 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.
O que você pode fazer com kogiQA Web Browser MCP?
Peça ao seu assistente para controlar um navegador real por meio de linguagem natural—sem necessidade de seletores.
- Depurar problemas de estilo — Peça ao assistente para inspecionar uma página e explicar por que um elemento transborda ou fica desalinhado, e então sugerir uma correção de CSS.
- Corrigir erros de console — Peça ao assistente para navegar pelas páginas, coletar erros de console e aplicar correções no seu código-fonte.
- Mapear e documentar seu aplicativo — Instrua o assistente a explorar links internos e produzir uma visão geral em Markdown dos recursos de cada página.
- Gerar testes de ponta a ponta — Solicite testes Cypress que cubram o caminho feliz de um fluxo e os erros de validação.
- Executar testes exploratórios — Deixe o assistente testar entradas de casos extremos em formulários e relatar comportamentos quebrados ou inconsistentes.
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 por meio 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 do seu aplicativo web
- Escrever automaticamente testes de ponta a ponta
- Automatizar testes exploratórios do seu aplicativo
Veja exemplos de prompts Usage Examples
kogiQA MCP vs Playwright MCP
O kogiQA MCP Server 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:
Alternativamente, instale via CLI do VS Code:
code --add-mcp '{"name":"kogiqa-browser","command":"npx","args":["kogiqa-mcp@latest"]}'
Cursor
Alternativamente, vá para Cursor Settings → MCP → Add new MCP Server e insira o comando npx 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, basta conversar com seu agente em linguagem natural. Como o kogiQA é livre de seletores, você descreve o que deseja 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 seu aplicativo
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 de 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