Integração do servidor MCP

1. O que é

O servidor MCP do SiteGuardian permite-te consultar os teus dados de monitorização diretamente a partir de clientes de IA compatíveis com MCP, como o Claude Desktop, Cursor, Claude Code e Windsurf. Pergunta por resultados de análise, eventos de drift e recomendações de correção em linguagem natural, sem sair do teu fluxo de trabalho.

O servidor corre na nossa infraestrutura; o teu cliente liga-se por Streamable HTTP. A v1 traz cinco ferramentas — uma anónima (scan_domain) e quatro autenticadas com uma chave de API.

2. Experimenta sem conta

A ferramenta scan_domain funciona sem autenticação. Cola isto num terminal para obter uma análise em direto de qualquer domínio:

curl -X POST https://mcp.siteguardian.io \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"scan_domain","arguments":{"domain":"example.com"}}}'

As análises anónimas estão limitadas a 10 por hora por IP de origem. Os resultados ficam em cache durante 2 horas — chamadas repetidas para o mesmo domínio devolvem o mesmo snapshot.

3. Instalar no teu cliente

Cursor

Instalação com um clique através do botão «Add to Cursor» na página inicial, ou edita ~/.cursor/mcp.json manualmente:

{
  "mcpServers": {
    "siteguardian": {
      "url": "https://mcp.siteguardian.io"
    }
  }
}

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) e reinicia a aplicação.

{
  "mcpServers": {
    "siteguardian": {
      "url": "https://mcp.siteguardian.io"
    }
  }
}

Claude Code (CLI)

Executa no terminal:

claude mcp add --transport http siteguardian https://mcp.siteguardian.io

Windsurf

Edita ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "siteguardian": {
      "serverUrl": "https://mcp.siteguardian.io"
    }
  }
}

VS Code / GitHub Copilot

Executa no terminal:

code --add-mcp '{"name":"siteguardian","type":"http","url":"https://mcp.siteguardian.io"}'

4. Obter uma chave de API

O scan_domain anónimo funciona sem chave. As outras quatro ferramentas (list_monitored_domains, get_domain_status, get_drift_events, get_fix_recommendations) exigem um token Bearer.

As chaves de API estão disponíveis nos planos Monitor, Compliance e Enterprise. Contas Free veem um convite de upgrade.

Entra em siteguardian.io.
Abra Settings → API e integrações.
Clica em «Gerar chave», dá-lhe um nome e copia-a. A chave completa só é mostrada uma vez.
Adiciona-a à configuração do teu cliente como cabeçalho Authorization: Bearer <key> . Para o Claude Desktop:

{
  "mcpServers": {
    "siteguardian": {
      "url": "https://mcp.siteguardian.io",
      "headers": {
        "Authorization": "Bearer sg_live_...your_key..."
      }
    }
  }
}

A mesma cabeçalho para Cursor, Windsurf, VS Code. Para o Claude Code: anexa --header "Authorization: Bearer <key>" ao comando mcp add .

5. O que podes perguntar

Analisar um domínio. "Executa uma análise de segurança em example.com e mostra-me a classificação." O teu cliente chama scan_domain e devolve a classificação A–F mais os 3 principais problemas.

Verifica os sites monitorizados. "Lista todos os domínios que estou a monitorizar." Devolve a classificação atual e o carimbo de data-hora da última análise para cada um.

Investigar uma queda. "O que mudou em example.com na última semana?" Devolve eventos de drift — renegociações TLS, alterações de cabeçalhos, novos scripts de terceiros — ordenados por data.

Obtém correções copy-paste. "Dá-me a configuração de nginx que preciso para corrigir o cabeçalho HSTS em falta em example.com." Devolve o trecho de configuração exato com o teu domínio interpolado.

6. Referência de ferramentas

Ferramenta	Entrada	Devolve	Auth
scan_domain	`domain`	Classificação, top 3 problemas, permalink	Anónimo
list_monitored_domains	—	Todos os domínios monitorizados + classificações	Chave de API
get_domain_status	`domain`	Classificação atual + problemas ativos	Chave de API
get_drift_events	`domain, since?, limit?`	Eventos de drift com severidade	Chave de API
get_fix_recommendations	`domain, issue_id?`	Trechos + comandos de verificação	Chave de API + plano pago

7. Limites de pedidos

Anónimo: 10 chamadas scan_domain por hora por IP de origem
Autenticado: 120 chamadas por minuto por chave de API
Por alvo: o mesmo domínio não é re-analisado mais de 2× por minuto — os resultados em cache servem as chamadas repetidas numa janela de 2 horas

8. Privacidade

🇪🇺 Alojamento na UE. Sem LLM de terceiros. Sem treino.

O servidor MCP do SiteGuardian corre na nossa infraestrutura na Alemanha. As tuas consultas e argumentos de ferramentas são registados para prevenção de abusos e faturação, mas não são enviados a nenhum serviço de IA de terceiros. Não usamos o teu tráfego MCP para treinar qualquer modelo.

As respostas das ferramentas são geradas de forma determinística a partir dos dados de monitorização existentes na tua conta — do nosso lado não há inferência de LLM.

9. Resolução de problemas

O servidor não se liga: Verifica que o URL do endpoint é exatamente https://mcp.siteguardian.io (sem barra final, sem /v1). Reinicia o cliente depois de editar a config. Confirma que a tua firewall permite HTTPS de saída para siteguardian.io.
Erros de autenticação: Confirma que o cabeçalho Authorization é Bearer sg_live_... com um único espaço. Na dúvida, revoga a chave em Definições e cria uma nova.
A ferramenta não aparece no cliente: Atualiza para a versão mais recente do cliente; o suporte a MCP está nas versões recentes do Claude Desktop, Cursor, Claude Code, Windsurf e VS Code Copilot.
Erros de limite de pedidos: O scan_domain anónimo está limitado a 10/hora/IP. As ferramentas autenticadas a 120/min/chave. Se atingires algum limite, aguarda ou faz upgrade de plano para mais throughput.
A análise anónima devolve um resultado em cache: As análises ficam em cache durante 2 horas por domínio. O campo cached na resposta é true quando servido a partir da cache.