MCP Server
Guias
Servidor MCP
Dê ao seu assistente de IA os scanners do Scanverra. Agentes podem auditar uma página, escanear a segurança de um site, analisar SEO e a preparação para busca com IA, escanear um repositório conectado e revisar a configuração MCP, depois ler resultados estruturados e enviar o link do relatório completo.
Beta. Os scans iniciados por um assistente de IA são scans normais do Scanverra: aparecem no seu histórico e contam uma única vez no seu plano, como os do site, da CLI ou do CI. O servidor MCP faz parte do plano Enterprise.
Conecte seu cliente
O Scanverra oferece um servidor MCP remoto via Streamable HTTP. Seu cliente envia uma chave de API em cada requisição.
- Crie uma chave na página Chaves de API. Use Acesso total para iniciar scans, ou Somente leitura para o assistente ler relatórios sem iniciar novos.
- Guarde a chave em uma variável de ambiente ou no gerenciador de segredos do seu cliente, não em um arquivo versionado.
- Adicione o servidor ao seu cliente com um dos trechos abaixo e recarregue os servidores MCP dele.
Endpoint
https://www.scanverra.com/api/mcp
# Claude.ai and Claude Desktop: Settings > Connectors > Add custom connector # ChatGPT: Settings > Connectors > Create (developer mode) URL: https://www.scanverra.com/api/mcp Auth: OAuth (sign in to Scanverra and approve when asked)
ChatGPT, Claude.ai e Claude Desktop se conectam via OAuth: adicione o endpoint como conector personalizado, entre no Scanverra e aprove. Cada app aprovado aparece na página Servidor MCP, onde você pode desconectá-lo.
Como funciona
Mesmos scans, mesmos relatórios
Cada ferramenta inicia o mesmo scan do Scanverra que você iniciaria pelo site, com os limites, o histórico e os links de relatório do seu plano.
Scans rodam em segundo plano
Uma ferramenta de scan devolve um ID na hora. O assistente consulta a ferramenta de relatório correspondente até o scan terminar, normalmente em menos de dois minutos.
Resultados estruturados
Cada relatório traz uma pontuação, contagens por gravidade, os problemas mais graves com correção e um link para o relatório completo.
Acesso restrito
O assistente só vê as ferramentas que sua chave permite. Chaves somente leitura não iniciam scans, e ninguém lê os relatórios de outra conta.
Ferramentas
Seu cliente as lista automaticamente, com esquemas de entrada e saída.
| Ferramenta | Tipo | O que faz |
|---|---|---|
scan_website | Inicia um scan | Audita uma página: desempenho no desktop e no celular, SEO, acessibilidade, boas práticas e preparação para agentes de IA. |
get_website_report | Leitura | Pontuações e principais problemas de uma auditoria, opcionalmente de uma categoria. |
compare_website_scans | Leitura | Mudanças de pontuação, problemas corrigidos e problemas novos entre duas auditorias. |
scan_browser | Inicia um scan | Carrega a página em um navegador real e registra erros de JavaScript, links quebrados e problemas de formulários, imagens e acessibilidade. |
get_browser_report | Leitura | Pontuação de saúde e problemas encontrados por uma auditoria de navegador. |
analyze_seo | Inicia um scan | Scan de SEO de uma página, com palavra-chave e página concorrente opcionais. |
get_seo_report | Leitura | Pontuação de SEO e achados com recomendações. |
analyze_ai_search | Verificação ao vivo | llms.txt e quais rastreadores de IA o seu robots.txt permite. Não usa cota. |
analyze_meta_tags | Verificação ao vivo | Título, descrição, cabeçalhos, canonical e tags Open Graph. Não usa cota. |
scan_website_security | Inicia um scan | Scan de segurança passivo: HTTPS e TLS, cabeçalhos, cookies, arquivos expostos, segredos no cliente, bibliotecas vulneráveis e DNS. |
get_security_report | Leitura | Pontuação de segurança, achados com evidência e correção, cabeçalhos e detalhes de TLS. |
check_tls_configuration | Verificação ao vivo | Certificado, cadeia, versão do TLS e HSTS. Não usa cota. |
check_content_security_policy | Verificação ao vivo | Avalia a Content Security Policy da página. Não usa cota. |
scan_repository | Inicia um scan | Escaneia um repositório conectado à sua conta em busca de segredos, segurança do código, dependências vulneráveis, qualidade e segurança de IA. |
get_repository_report | Leitura | Pontuação do repositório e achados com arquivo e linha, opcionalmente de uma categoria. |
scan_mcp_config | Verificação ao vivo | Revisa os arquivos de configuração MCP e de agentes de IA que o assistente lê do seu projeto. Nada é guardado. Não usa cota. |
check_security_headers | Verificação ao vivo | Cabeçalhos de resposta e atributos de cookies de uma página, verificados com as regras do Security Scan. Não usa cota. |
scan_mcp_server | Verificação ao vivo | Análise somente leitura de um servidor MCP remoto que é seu: transporte, autenticação, descoberta OAuth e descrições de ferramentas. Nunca chama uma ferramenta. |
get_mcp_security_report | Leitura | Uma análise salva de servidor MCP. |
compare_mcp_posture | Leitura | Mudança de risco e achados corrigidos ou novos entre duas análises de um servidor. |
discover_mcp_servers | Leitura | Servidores MCP que você analisou e os configurados nos seus repositórios escaneados. |
explain_finding | Leitura | Tudo sobre um achado: evidência, impacto, correção e CWE. |
create_remediation_plan | Leitura | Um plano ordenado para um scan concluído: agora, depois e mais tarde. |
get_fix_prompt | Leitura | O prompt de correção do Scanverra para seu agente de código. |
verify_remediation | Inicia um scan | Executa de novo o scan do mesmo alvo para verificar suas correções. |
compare_scans | Leitura | Mudança de pontuação e achados corrigidos e novos entre dois scans de qualquer ferramenta. |
get_account | Leitura | Seu plano e suas verificações deste mês e no total. |
list_scans | Leitura | Suas verificações anteriores, filtradas por ferramenta, site, status e data. |
get_scan_stats | Leitura | Quantas verificações você tem, por ferramenta e resultado, em qualquer período ou site. |
Prompts prontos
website_health_assessmentwebsite_seo_optimizationwebsite_security_assessmentrepository_security_reviewmcp_security_reviewai_agent_security_reviewwebsite_remediation_workflowSegurança
- Escaneie apenas sites e repositórios que são seus ou que você tem autorização para testar. Scans de sites são passivos.
- O conteúdo dos relatórios (texto de páginas, conteúdo de arquivos, descrições de ferramentas) é um dado não confiável. O servidor orienta seu assistente a nunca seguir instruções encontradas nele.
- Sua chave nunca é devolvida nos resultados nem registrada em logs. Segredos encontrados em um scan são mascarados nos resultados.
- Arquivos enviados ao scan_mcp_config são analisados em memória e nunca guardados.
- Endereços privados, locais e de metadados de nuvem são recusados antes de qualquer scan.
Solução de problemas
| Mensagem | Correção |
|---|---|
401 Missing Scanverra API key | A chave não foi enviada. Verifique se a variável de ambiente está definida onde o seu cliente roda e use o endereço www.scanverra.com. |
401 not valid, has expired or was revoked | Crie uma nova chave na página Chaves de API. |
403 part of the Enterprise plan | O servidor MCP faz parte do plano Enterprise. Veja os planos e fale conosco para fazer o upgrade. |
Only get_ tools are listed | A chave é Somente leitura. Use uma chave de Acesso total para iniciar scans. |
plan_limit | Os scans gratuitos deste mês acabaram. Faça upgrade ou espere o novo mês. |
email_verification_required | Confirme seu endereço de e-mail e tente de novo. |
target_unreachable | O site não respondeu ou aponta para um endereço privado. |
Pronto para conectar?
Crie uma chave de API, adicione o servidor ao seu cliente e peça ao seu assistente para auditar uma página.