Servidor MCP Squidler
Squidler.io
Agentes de codificação de IA são excelentes na fase de Build de uma aplicação web, mas têm dificuldade na fase de Verify. O Squidler foi projetado para validar sua aplicação web como um humano, com base em casos de uso em linguagem natural e sem escrever testes frágeis e dependentes de DOM.
O Squidler não é apenas uma ferramenta de teste; ele permite que seu agente de codificação analise seu próprio trabalho sob a perspectiva do usuário, desacoplado da implementação. O Squidler fecha o ciclo autônomo de Build → Verify → Fix e permite que você atue como o verdadeiro humano no circuito, gerenciando o resultado em vez da saída.
Servidor MCP Squidler
Com o servidor MCP Squidler, você habilita seus agentes de codificação de IA, como Cursor, Claude Code, Replit, Lovable, etc., a trabalhar com o Squidler. Isso significa que você pode fazer seu agente de codificação criar um recurso, descrever o caso de uso em linguagem natural para o Squidler, pedir ao Squidler para testá-lo, obter os detalhes de como a execução do teste ocorreu e detalhes de todos os problemas ou atritos encontrados ao usar sua aplicação web.
Abaixo estão detalhes e exemplos de como começar com o Squidler via MCP. Se você tiver alguma dúvida, não hesite em entrar em contato pelo e-mail mattias@squidler.io.
Configuração
Adicione à sua configuração do cliente MCP:
{
"mcpServers": {
"squidler": {
"transport": "http",
"url": "https://mcp.squidler.io",
"headers": {
"Authorization": "Bearer YOUR_SQUIDLER_API_TOKEN"
}
}
}
}
Obtenha seu token de API em squidler.io/integrations/api-keys.
Orientação Integrada do Agente
O servidor MCP inclui instruções integradas que ensinam ao seu agente de IA um Fluxo de Trabalho de Teste-Após-Recurso. Quando conectado, o agente automaticamente sabe como usar o Squidler sem que você precise explicar. O fluxo de trabalho que ele segue:
- Executar testes existentes — verificar se nada foi quebrado pelo novo recurso.
- Investigar falhas — usar os resultados e eventos da execução de testes para entender o que falhou. Corrija o código se for um bug, ou atualize/exclua o teste se estiver obsoleto.
- Rotular o recurso — criar um rótulo para o recurso concluído (por exemplo, "Login do Usuário", "Fluxo de Checkout") para organizar seu catálogo de testes.
- Cobrir o novo recurso — criar casos de teste para o novo comportamento usando a conversa guiada (
test_case_create), marcá-los com o rótulo do recurso e executá-los para confirmar que passam.
- Para páginas sem link clicável (endpoints ocultos, links profundos), escreva as etapas como: "Navegue diretamente para /caminho"
- Confirmar verde — reexecutar até que todos os testes passem e, em seguida, passar para o próximo recurso.
Com o tempo, isso constrói um catálogo crescente de testes organizados por recurso que previne regressões e documenta como o sistema deve funcionar.
Recursos
| URI do Recurso | Descrição |
|---|
squidler://help | Documentação do servidor e capacidades disponíveis |
squidler://sites | Lista de todos os sites disponíveis |
Ferramentas
Sites
| Ferramenta | Descrição |
|---|
sites_list | Listar todos os sites disponíveis |
site_details | Obter informações do site (proprietário, URL, nome, link do frontend) |
site_create | Criar um novo site |
Problemas
| Ferramenta | Descrição |
|---|
problems_summary | Visão geral dos problemas (contagem total por tipo) |
problems_list | Listar problemas com paginação e filtragem |
problem_get | Obter informações detalhadas sobre um problema específico |
problem_resolve | Marcar um problema como resolvido |
problem_dismiss | Marcar um problema como falso positivo |
Criação de Casos de Teste
| Ferramenta | Descrição |
|---|
test_case_create | Iniciar uma conversa guiada para criar um caso de teste de alta qualidade armazenado no Squidler. Utiliza o conhecimento das páginas do site, a cobertura de testes existente e as melhores práticas de teste. Retorna um conversationId — continue com test_case_create_respond. |
test_case_create_respond | Continuar uma conversa de criação de caso de teste em andamento — responder perguntas, revisar o rascunho ou confirmar a criação. Funciona tanto para test_case_create quanto para test_case_create_standalone. |
Casos de Teste
| Ferramenta | Descrição |
|---|
test_cases_list | Listar todos os casos de teste |
test_case_get | Obter detalhes do caso de teste |
test_cases_list_by_label | Listar casos de teste com um rótulo específico |
validate_test_case | Validar um caso de teste quanto à qualidade, viabilidade e melhores práticas |
test_case_update | Atualizar um caso de teste existente (inclui feedback automático de validação) |
test_case_delete | Excluir um caso de teste |
test_case_run | Executar um único caso de teste |
test_cases_run_all | Executar todos os casos de teste |
test_cases_run_by_label | Executar casos de teste com um rótulo específico |
Casos de Teste Armazenados no Repositório / Autônomos
Para agentes que gerenciam casos de teste como arquivos markdown em seu próprio repositório (sem armazenamento no Squidler). Cobre o ciclo criar → validar → executar → promover. Particularmente útil para iteração de desenvolvimento local: combine test_case_run_standalone com o proxy npx @squidlerio/squidler-mcp para rotear execuções através de um Chrome local contra http://localhost:<port>.
| Ferramenta | Descrição |
|---|
test_case_create_standalone | Conversa guiada que produz texto markdown autônomo (sem armazenamento no Squidler). O arquiteto faz mais perguntas de esclarecimento do que o fluxo vinculado ao site, pois não tem contexto do site. O resultado final é {filename, markdown} para o agente escrever em seu repositório local. Continue com test_case_create_respond. |
validate_test_case_text | Validar o markdown de um arquivo de caso de teste do Sistema B sem executá-lo. Retorna erros tipados para problemas de frontmatter, esquema e corpo, cada um com o número da linha do arquivo quando disponível. Use antes de escrever arquivos gerados, após edições manuais ou em ganchos de CI. |
test_case_run_standalone | Executar um caso de teste fornecido como markdown inline contra um baseUrl personalizado (tipicamente um servidor de desenvolvimento localhost ou deploy de pré-visualização). A Otimização de Etapas / Ações Fixas usa automaticamente execuções anteriores do mesmo (org, contentHash). Retorna um checkId. |
test_case_runs_standalone_list | Listar execuções autônomas passadas para a organização do chamador com um identificador fornecido, da mais recente para a mais antiga. Contraparte autônoma de test_runs_list — útil para deduplicação antes de reexecutar via hash de conteúdo. |
test_case_promote | Promover um arquivo markdown armazenado no repositório para um caso de teste vinculado ao site no Squidler. Idempotente em (siteId, identifier): produz UNCHANGED, UPDATED ou CREATED dependendo da comparação de hash de conteúdo com a revisão mais recente. |
Execuções de Teste
| Ferramenta | Descrição |
|---|
test_runs_list | Listar histórico de execução de um caso de teste |
test_case_poll | Long-poll para atualizações de status e eventos de execução de teste |
test_run_outcome | Obter resultado de aprovação/reprovação e resultados de metas para uma execução de teste |
test_run_events | Obter eventos detalhados de execução e capturas de tela |
test_run_stop | Parar um teste atualmente em execução |
pending_checks_list | Listar verificações na fila (aguardando início) para um site, além das verificações atualmente em execução que bloqueiam cada uma. Use quando test_case_run retornar queued: true. |
Rótulos
| Ferramenta | Descrição |
|---|
labels_list | Listar todos os rótulos |
label_get | Obter detalhes do rótulo |
label_create | Criar um novo rótulo |
label_update | Atualizar um rótulo |
label_delete | Excluir um rótulo |
test_case_labels_add | Adicionar rótulos a um caso de teste |
test_case_label_remove | Remover um rótulo de um caso de teste |
Cabeçalhos
| Ferramenta | Descrição |
|---|
headers_list | Listar cabeçalhos personalizados para um site |
header_add | Adicionar ou atualizar um cabeçalho personalizado |
header_delete | Remover um cabeçalho personalizado |
Credenciais
| Ferramenta | Descrição |
|---|
credentials_list | Listar credenciais de login disponíveis |
credentials_create_userpass | Criar credenciais com e-mail/nome de usuário e senha explícitos |
credentials_create_email | Criar credenciais com e-mail @squidlermail.io gerado automaticamente para testes de verificação |
credentials_create_oidc | Criar credenciais OIDC para sites que usam OpenID Connect |
Revisões de Persona (Feedback de UX)
| Ferramenta | Descrição |
|---|
personas_list | Listar todas as personas disponíveis para revisões de UX |
persona_review_run | Executar uma revisão de persona em um caso de teste validado |
persona_review_findings | Obter descobertas detalhadas de uma revisão de persona concluída |
persona_findings_list | Listar descobertas de persona para um site e persona, filtradas por status |
persona_finding_triage | Atualizar status da descoberta (RESOLVED, DISMISSED, IN_PROGRESS, OPEN) |
Gerenciamento de Conta
| Ferramenta | Descrição |
|---|
account_status | Verificar plano atual, cota de testes restante e upgrades disponíveis |
account_upgrade_url | Gerar uma URL de curta duração para fazer upgrade do seu plano |
Prompts
| Prompt | Description |
|---|
create-test-case | Criação guiada de casos de teste com objetivos, etapas e estratégias de falha |
site-health-check | Visão geral rápida do status de qualidade do site com recomendações acionáveis |
run-test-suite | Execute todos os testes ou testes rotulados e monitore os resultados |
get-started-with-squidler | Onboarding completo: crie o site, gere testes iniciais e execute-os |
suggest-initial-tests | Analise o código-fonte para sugerir 2 a 4 casos de teste iniciais |
enhance-tests-from-runs | Analise eventos de execução de testes para identificar e corrigir pontos fracos |
identify-ux-improvements | Descubra problemas de usabilidade a partir de padrões de atrito do testador de IA |
correlate-accessibility-and-ux | Cruze referências de problemas de acessibilidade com atrito na execução de testes |
run-persona-review | Execute revisões de persona em casos de teste validados para descobrir problemas de UX |
migrate-legacy-tests | Migre casos de teste legados para o formato atual |
Exemplos de Prompts
| O que você pode dizer | O que isso faz |
|---|
| "Crie um site para https://myapp.com chamado 'My App'" | Registre seu site com o Squidler para começar a monitorar e testar |
| "Analise o código-fonte e crie casos de teste para os principais fluxos de usuário" | Usa conversas guiadas para criar casos de teste abrangentes cobrindo fluxos felizes, casos extremos e testes negativos |
| "Execute todos os meus casos de teste" | Execute seus casos de teste em um navegador real com validação de objetivos e detecção de problemas |
| "Mostre-me os resultados das minhas execuções de teste mais recentes" | Veja quais objetivos passaram ou falharam e entenda o que aconteceu durante a execução |
| "Obtenha os eventos detalhados de teste para o caso de teste nº 1 e analise a UX" | Revise os logs de execução para identificar atrito de UX e problemas de usabilidade |
| "Corrija os problemas que impedem o caso de teste nº 1 de passar" | Analisa falhas de teste e corrige os problemas de código subjacentes |
| "Obtenha o problema nº 42 e ajude-me a corrigi-lo" | Aborde problemas específicos de acessibilidade, funcionalidade ou conteúdo |
| "Corrija todos os problemas de acessibilidade do meu site" | Corrija em lote os problemas de conformidade com WCAG iterando pelos problemas |