SnapVisor MCP

Revise builds de regressão visual, aprove ou rejeite alterações de capturas de tela e gerencie projetos SnapVisor. Servidor remoto com login via OAuth.

Servidor MCP hospedado

npx add-mcp 'https://mcp.snapvisor.io/'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Snapvisor

Snapvisor é uma plataforma de testes visuais construída sobre um motor de código aberto. Capture screenshots da sua suíte de testes existente, compare-as com uma linha de base e revise as alterações nos seus pull requests.

Snapvisor é uma plataforma de testes de regressão visual construída sobre um motor de diff visual de código aberto comprovado. Ela captura screenshots da suíte de testes que você já executa — Playwright, Cypress, Puppeteer, Storybook ou qualquer ferramenta que grave arquivos de imagem — compara-os com uma linha de base aprovada e publica o resultado como um status check no seu pull request.

Por que testes visuais

Testes unitários verificam lógica, não pixels. Regressões visuais passam despercebidas em suítes verdes o tempo todo:

  • Mudanças silenciosas de layout — um ajuste de CSS dois componentes adiante move seu botão de checkout para fora da área visível.
  • Tipografia quebrada — uma fonte falha ao carregar e seu título invade a barra de navegação.
  • Regressões responsivas — perfeito em 1440px, quebrado em 375px.

O Snapvisor expõe esses problemas como diffs de screenshots revisáveis, em vez de deixá-los ir para produção.

Início rápido

O Snapvisor usa os SDKs de código aberto @snapvisor (forks drop-in dos SDKs @argos-ci) para capturar screenshots e enviá-los para comparação. Siga estes passos para criar seu primeiro build.

1. Crie um projeto e obtenha seu token

Entre no aplicativo Snapvisor, crie um projeto e copie o ARGOS_TOKEN das configurações do projeto. Este token autentica os uploads para aquele projeto específico.

export ARGOS_TOKEN="<your project token>"

2. Instale um SDK

Instale a CLI, além do adaptador para o seu executor de testes. O Snapvisor tem SDKs oficiais para Playwright, Cypress, Puppeteer, Storybook e um núcleo agnóstico de framework.

npm install --save-dev @snapvisor/cli
npm install --save-dev @snapvisor/playwright

3. Capture e envie no CI

Execute seus testes para que eles gravem screenshots em uma pasta e, em seguida, envie essa pasta. Em um pull request, o Snapvisor compara o upload com a linha de base do branch e publica um status check com um link para revisão.

# after your tests have written screenshots to ./screenshots
npx @snapvisor/cli upload ./screenshots

Como funciona

  1. Captura — seu CI envia screenshots das histórias do Storybook, specs do Playwright ou Cypress que você já executa.
  2. Diff — cada screenshot é comparado com uma linha de base elegível usando um motor perceptual que reduz ruídos de anti-aliasing e renderização.
  3. Revisão — as alterações aparecem como um status check no seu pull request. Aprove as intencionais, rejeite as regressões. Builds aprovados tornam-se linhas de base elegíveis para comparações futuras.

Próximos passos

Introdução

Crie um projeto, instale um SDK e envie seu primeiro build.

Builds de linha de base

Como o build de referência e o branch base são resolvidos.

Fluxo de revisão

Linhas de base, aprovações, modo de monitoramento, tratamento de alterações instáveis e checks de resumo.

Integração com CI

Status checks do GitHub e GitLab, autenticação sem token e testes paralelos.

SDKs

Pacotes JavaScript oficiais e um SDK e CLI para Python.

Servidor MCP

Deixe o Claude Code, Cursor ou qualquer cliente MCP ler diffs e aprovar alterações.

Tokens de acesso

Tokens de projeto para CI, tokens de acesso pessoal para a API e MCP.

Referência da API

Uma API REST versionada descrita por uma especificação OpenAPI.

Suporte

Fale com a equipe se ficar travado.

De relance

  • Diff perceptual de pixels com detecção de anti-aliasing e limites ajustáveis
  • Fluxo de revisão aprovar/rejeitar com linhas de base por branch
  • Status checks de pull requests no GitHub e GitLab
  • Testes paralelos: divida suítes grandes entre máquinas e revise-as como um único build
  • Notificações por Slack e e-mail
  • Um servidor MCP remoto para que agentes de IA possam revisar sua interface
  • Construído sobre um núcleo de código aberto inspecionável; entre em contato com o suporte para acesso de auto-hospedagem

[

Introdução

Crie um projeto Snapvisor, defina o token do projeto, capture screenshots da sua suíte de testes existente e envie seu primeiro build.

](https://snapvisor.io/docs/getting-started)