Scansiona il tuo sito e correggilo senza lasciare l’editor
Il server MCP di SagBot permette al tuo strumento di coding con IA di scansionare un sito online, leggere ogni controllo fallito con la sua correzione e ripetere la scansione dopo il deploy.
Funziona con Claude Code, Cursor, OpenAI Codex CLI, Gemini CLI, VS Code (modalità agente di Copilot) e Windsurf.
IniziaCome funziona
Collega
Crea un token e aggiungi il server al tuo strumento. Un comando o una voce di configurazione.
Chiedi una scansione
Di’ al tuo agente di scansionare il sito. Riceve i punteggi e una correzione da copiare per ogni controllo fallito.
Correggi, fai il deploy, riscansiona
Il tuo agente modifica il codice, tu controlli e fai il deploy, poi riscansiona per verificare che il punteggio sia salito.
Inizia
Crea un account gratuito, genera un token e incollalo nel tuo strumento. Ci vogliono circa due minuti.
Configura il tuo strumento
Scegli il tuo strumento. Gli snippet mostrano un segnaposto finché non crei un token.
Claude Code
Esegui questo in un terminale. Aggiunge SagBot a tutti i tuoi progetti:
claude mcp add --transport http --scope user sagbot https://mcp.sagbot.app/mcp --header "Authorization: Bearer sgb_…"Verifica: claude mcp list dovrebbe mostrare sagbot ✔ Connected. In Claude Code lo mostra anche /mcp.
Cursor
Aggiungi questo a ~/.cursor/mcp.json (tutti i progetti). Se il file ha già mcpServers, metti sagbot lì dentro:
{
"mcpServers": {
"sagbot": {
"url": "https://mcp.sagbot.app/mcp",
"headers": {
"Authorization": "Bearer sgb_…"
}
}
}
}Verifica: sagbot compare, attivo, nelle impostazioni MCP di Cursor. Se non si connette, Output → MCP Logs spiega perché.
OpenAI Codex CLI
Aggiungi questo a ~/.codex/config.toml:
[mcp_servers.sagbot]
url = "https://mcp.sagbot.app/mcp"
bearer_token_env_var = "SAGBOT_TOKEN"Codex legge il token dalla variabile d’ambiente SAGBOT_TOKEN. Metti questa riga in un file fuori da qualsiasi repository, come ~/.config/sagbot.env (chmod 600), aggiungi source ~/.config/sagbot.env al profilo della shell e apri un nuovo terminale:
export SAGBOT_TOKEN="sgb_…"Verifica: codex mcp list elenca sagbot. In Codex, /mcp mostra i suoi strumenti.
Gemini CLI
Aggiungi questo a ~/.gemini/settings.json. Se il file ha già mcpServers, metti sagbot lì dentro:
{
"mcpServers": {
"sagbot": {
"httpUrl": "https://mcp.sagbot.app/mcp",
"headers": {
"Authorization": "Bearer sgb_…"
}
}
}
}Verifica: gemini mcp list mostra sagbot come Connected. In Gemini CLI, /mcp elenca i suoi strumenti.
VS Code (Copilot agent mode)
Aggiungi questo a .vscode/mcp.json nel tuo progetto, o al tuo mcp.json utente (Riquadro comandi → MCP: Open User Configuration):
{
"inputs": [
{
"type": "promptString",
"id": "sagbot-token",
"description": "SagBot token",
"password": true
}
],
"servers": {
"sagbot": {
"type": "http",
"url": "https://mcp.sagbot.app/mcp",
"headers": {
"Authorization": "Bearer ${input:sagbot-token}"
}
}
}
}Il file non contiene il token: VS Code lo chiede al primo avvio del server e lo conserva in modo sicuro. Incolla questo quando lo chiede:
sgb_…Verifica: Riquadro comandi → MCP: List Servers mostra sagbot in esecuzione. Nella chat, la modalità agente elenca i suoi strumenti.
Windsurf
Aggiungi questo a ~/.config/devin/mcp_config.json (versioni meno recenti di Windsurf: ~/.codeium/windsurf/mcp_config.json). Per aprire di sicuro il file giusto usa il menu MCP di Cascade → Open MCP config file. Se il file ha già mcpServers, metti sagbot lì dentro:
{
"mcpServers": {
"sagbot": {
"serverUrl": "https://mcp.sagbot.app/mcp",
"headers": {
"Authorization": "Bearer sgb_…"
}
}
}
}Verifica: dopo aver salvato, premi aggiorna nelle impostazioni MCP di Cascade. sagbot compare con 2 strumenti.
Due strumenti
scan_site
Scansiona un sito online e restituisce i punteggi Agent-ready e Answer-ready, più ogni controllo fallito o parziale con istruzioni di correzione scritte per un agente di coding.
domain: il sito da scansionare, per esempio example.com.siteType: content (predefinito), app o shop.rescan: true avvia una scansione nuova invece di riusare un risultato più recente di un’ora.
get_latest_scan
Legge l’ultima scansione salvata di un sito senza scansionare e senza consumare il tuo limite. Usalo per rileggere le correzioni o quando una chiamata a scan_site è andata in timeout: la scansione termina comunque.
domain,siteType: come in scan_site.
Prompt da provare
Incollane uno nel tuo agente dopo averlo collegato.
- Scansiona example.com con SagBot e correggi in questo repository quello che puoi.
- Ho appena fatto il deploy. Riscansiona example.com con SagBot e dimmi cosa non passa ancora.
- Cosa dice SagBot sul llms.txt di example.com?
Limiti
- 3 scansioni al minuto per account, a prescindere da quanti token hai.
- Un sito può essere riscansionato una volta ogni 2 minuti.
- Solo URL pubblici. SagBot scarica il tuo sito da internet, quindi fai prima il deploy o usa un URL di anteprima pubblico.
- I risultati sono pubblici, come in ogni scansione SagBot: chiunque conosca il dominio può aprirne la pagina dei risultati.
Domande
Il server MCP è gratuito?
Sì. Serve un account SagBot gratuito per creare un token. Non c’è un tetto giornaliero, solo il limite di 3 scansioni al minuto.
Quali strumenti di IA funzionano?
Claude Code, Cursor, OpenAI Codex CLI, Gemini CLI, VS Code con la modalità agente di Copilot e Windsurf. Anche un client che può inviare un header Authorization a un server MCP remoto può collegarsi, ma documentiamo questi sei.
Perché non Claude Desktop, claude.ai o ChatGPT?
I loro connettori accedono dal browser con OAuth, che SagBot non offre ancora. I token funzionano negli strumenti in cui l’header lo imposti tu.
Il mio token è al sicuro?
SagBot mostra il token una sola volta e non può mostrarlo di nuovo. Tienilo fuori da git: usa la configurazione del tuo utente, non un file nel repository. Chi ha il token può avviare scansioni a tuo nome.
Come revoco un token?
Apri Account, poi Credenziali, ed elimina il token. Lo strumento che lo usava perde l’accesso.
Può scansionare localhost?
No. SagBot scarica il tuo sito da internet, quindi serve un URL pubblico. Fai prima il deploy o usa un URL di anteprima pubblico.
SagBot modifica il mio codice?
No. SagBot scansiona e riporta soltanto. Il tuo agente modifica il codice dalle correzioni, e tu controlli e fai il deploy.
Le scansioni via MCP compaiono nella mia dashboard?
Sì. Compaiono nella tua Dashboard, segnate come avviate via MCP.