Collegare Crawlens a Claude e agli altri strumenti di AI
Crawlens include un server MCP. Una volta collegato, l’app di AI che usi già può leggere le tue scansioni e i tuoi audit, spiegare i problemi, dare priorità alle correzioni e scrivere i ticket. Il tutto con il tuo abbonamento AI, senza chiave API.
Per ora l’interfaccia di Crawlens è solo in inglese. Per questo i nomi di impostazioni, pulsanti, strumenti e prompt restano in inglese, così li ritrovi subito nell’app.
A cosa serve
MCP (Model Context Protocol) è il modo standard con cui le app di AI usano strumenti esterni. Quando l’app di AI ha bisogno dei dati di Crawlens, avvia il server MCP di Crawlens sul tuo computer. Il server legge le scansioni e gli audit salvati e restituisce risultati compatti e paginati.
- Sola lettura. Non può avviare scansioni, modificare le impostazioni né eliminare nulla.
- Locale. Gira sul tuo computer e non apre porte di rete. Crawlens stesso non carica nulla online.
- Crawlens non deve essere aperto. L’app di AI avvia il server quando serve, con il runtime incluso in Crawlens. Non devi installare Node.js.
1. Attivalo in Crawlens
La condivisione è disattivata per impostazione predefinita. Gli strumenti di AI non vedono nulla finché non la attivi.
- Apri Crawlens e vai in Settings → Integrations → AI tools (MCP).
- Attiva Share audits with AI tools.
- In Projects AI tools can read, mantieni All projects oppure scegli Only these projects.
- Facoltativo: attiva Hide Search Console and Analytics data per nascondere agli strumenti di AI clic, impressioni, sessioni e risultati del controllo URL.
Ti serve almeno un progetto con una scansione già sottoposta ad audit. Se non hai ancora scansionato nulla, comincia da lì: fino ad allora l’AI non ha niente da leggere.
2. Collega lo strumento di AI
Nella stessa scheda delle impostazioni, ogni app ha un pulsante Copy setup for. Usalo: inserisce i percorsi esatti della tua installazione. Gli esempi qui sotto mostrano come appare la configurazione, con percorsi di esempio.
Claude Desktop
- Fai clic su Add to Claude Desktop.
- Esci da Claude Desktop e riaprilo. Chiudere la finestra non basta: esci dall’app dall’area di notifica della barra delle applicazioni.
- In una nuova chat, apri il menu degli strumenti. Dovresti vedere
crawlens.
Crawlens si aggiunge a claude_desktop_config.json mantenendo gli altri server MCP. Se il file esiste già, Crawlens salva prima una copia di backup con data accanto. Sono supportate sia la versione classica di Claude Desktop sia quella del Microsoft Store.
Preferisci modificare la configurazione da solo?
Aggiungi questo a %APPDATA%\Claude\claude_desktop_config.json, unendolo agli eventuali mcpServers già presenti:
{
"mcpServers": {
"crawlens": {
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}Claude Code
- Fai clic su Copy setup for → Claude Code.
- Incolla il comando in un terminale ed eseguilo.
- Avvia
claudeed esegui/mcpper verificare checrawlenssia collegato.
Il comando registra Crawlens per il tuo account utente (--scope user), quindi è disponibile in tutti i tuoi progetti:
claude mcp add crawlens --scope user --env ELECTRON_RUN_AS_NODE=1 -- "C:\path\to\Crawlens.exe" "C:\path\to\resources\mcp\server.mjs" --user-data "C:\Users\you\AppData\Roaming\Crawlens"Codex
Una sola configurazione vale per la CLI di Codex, l’estensione per IDE e l’app.
- Fai clic su Copy setup for → Codex.
- Incollala alla fine di
~/.codex/config.toml(crea il file se non esiste). - Riavvia Codex.
[mcp_servers.crawlens]
command = 'C:\path\to\Crawlens.exe'
args = ['C:\path\to\resources\mcp\server.mjs', '--user-data', 'C:\Users\you\AppData\Roaming\Crawlens']
[mcp_servers.crawlens.env]
ELECTRON_RUN_AS_NODE = '1'La configurazione copiata contiene anche, come commento, il comando codex mcp add … equivalente, se preferisci eseguirlo.
Cursor
- Fai clic su Copy setup for → Cursor.
- Apri
~/.cursor/mcp.jsone incollala. Se il file contiene già dei server, aggiungi la vocecrawlensdentro imcpServersesistenti. - Controlla Cursor Settings → MCP:
crawlensdeve risultare attivo.
{
"mcpServers": {
"crawlens": {
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}VS Code
- Fai clic su Copy setup for → VS Code.
- Incollala in
.vscode/mcp.jsonnella tua area di lavoro. In alternativa esegui MCP: Add Server dal riquadro comandi. - Apri Copilot Chat in modalità Agent e cerca
crawlensnell’elenco degli strumenti.
{
"servers": {
"crawlens": {
"type": "stdio",
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}Altre app MCP: funziona qualsiasi app che supporti i server MCP stdio. Usa lo stesso comando, gli stessi argomenti e la stessa variabile d’ambiente ELECTRON_RUN_AS_NODE=1 mostrati sopra.
3. Prova la connessione
In Crawlens, fai clic su Test connection. Crawlens avvia il server esattamente come farà la tua app di AI e ti dice cosa ha trovato, per esempio:
Se la prova riesce ma l’app di AI non mostra Crawlens, il problema è nell’app. Riavviala e consulta la sezione risoluzione dei problemi.
Cosa chiedere
Indica il progetto per nome o per dominio. Puoi fare le domande in italiano. Alcuni prompt che funzionano bene:
Riassumi l’ultimo audit Crawlens di example.com e dammi un elenco di correzioni in ordine di priorità.
Scrivi nuovi title per le pagine che non ce l’hanno.
Spiega le catene di redirect al nostro sviluppatore.
Cosa è peggiorato dall’ultima scansione?
Quali pagine ricevono clic dalla ricerca ma restituiscono errori o sono in noindex?
Trova le pagine indicizzabili nelle posizioni 11–20 e suggerisci come portarle in prima pagina.
Strumenti e prompt
Ecco cosa vede la tua app di AI. I risultati sono paginati (50 righe per impostazione predefinita), così i siti grandi non intasano la conversazione.
| Strumento | Cosa restituisce |
|---|---|
list_projects | I progetti che Crawlens condivide, con la loro ultima scansione. |
list_crawls | Le scansioni di un progetto, dalla più recente, con punteggio di salute e numero di problemi. |
get_overview | Il riepilogo di una scansione sottoposta ad audit: punteggio di salute, problemi per gravità, problemi principali, codici di stato, indicizzabilità, Core Web Vitals e totali di Search Console, Analytics e log del server quando presenti. |
list_issues | Ogni controllo non superato: cosa significa, come risolverlo e quanti URL sono interessati (i più gravi per primi). |
get_issue_urls | Gli URL colpiti da un problema, con i dettagli per ciascuno. |
query_urls | Filtrare, ordinare e scorrere gli URL scansionati come nella tabella degli URL, comprese le colonne di Search Console, GA4 ed estrazione personalizzata. |
get_url_details | Tutto su un URL: campi SEO, problemi, link, redirect, header, dati strutturati, HTML originale o renderizzato, Core Web Vitals e dati di ricerca. |
compare_crawls | Cosa è cambiato tra due scansioni: punteggio di salute, problemi nuovi e risolti per controllo, e modifiche agli URL. |
Se l’app di AI lo supporta, nel menu dei prompt o dei comandi slash compaiono dei prompt pronti all’uso:
| Prompt | Cosa fa |
|---|---|
| Summarise the audit & prioritise fixes | Una sintesi dell’ultimo audit e un piano di correzioni ordinato per impatto e impegno, con un responsabile e URL di esempio per ogni voce. |
| Rewrite titles & meta descriptions | Nuovi title (30–60 caratteri) e description (70–160) per le pagine con problemi di title o description, ciascuno nella lingua della pagina. |
| Explain an issue for developers | Un problema spiegato con gli URL e i valori reali di questo sito: causa, verifica, correzione e una checklist. |
Privacy e sicurezza
- Disattivato finché non lo attivi, e puoi disattivarlo in qualsiasi momento. A quel punto il server rifiuta ogni richiesta.
- Sola lettura. Il server apre i tuoi dati in sola lettura. Non può scansionare, modificare le impostazioni né eliminare nulla.
- Nessuna porta di rete. Comunica con l’app di AI solo tramite standard input e output, sul tuo computer.
- Scegli tu cosa è visibile: tutti i progetti o solo alcuni, con o senza i dati di Search Console e Analytics.
Crawlens non carica nulla online, ma la tua app di AI invia ciò che legge al proprio servizio di AI, come parte della conversazione. Valgono quindi le regole sulla privacy dell’app di AI: controllale prima di condividere dati dei clienti.
Risoluzione dei problemi
- Crawlens non compare nella mia app di AI
- Riavvia completamente l’app dopo la configurazione. Claude Desktop resta attivo nell’area di notifica: esci da lì. Per Cursor e VS Code, verifica che il JSON sia ancora valido dopo averlo incollato: una virgola mancante rende inutilizzabile l’intero file.
- “Sharing audits with AI tools is turned off”
- Attiva Share audits with AI tools in Settings → Integrations → AI tools (MCP).
- “No shared project matches …”
- Il progetto non è nell’elenco che gli strumenti di AI possono leggere, oppure il nome non corrisponde. Il messaggio di errore elenca i progetti disponibili. Aggiungi il progetto in Projects AI tools can read, oppure rifai la domanda usando uno di quei nomi.
- “This project has no audited crawl yet”
- Prima scansiona il sito in Crawlens. L’AI legge gli audit, quindi serve almeno una scansione completata e sottoposta ad audit.
- “This data was saved by an older Crawlens”
- Apri una volta il progetto in Crawlens. I suoi dati vengono aggiornati e l’app di AI può di nuovo leggerli.
- Ha smesso di funzionare dopo che ho spostato o reinstallato Crawlens
- La configurazione contiene il percorso di
Crawlens.exe. Copia di nuovo la configurazione da Crawlens (o fai di nuovo clic su Add to Claude Desktop) per aggiornare i percorsi. Spostare la cartella dei dati da Crawlens invece non crea problemi: il server la segue in automatico. - “… is not valid JSON, so Crawlens left it untouched”
- Il tuo
claude_desktop_config.jsonconteneva già un errore di sintassi, quindi Crawlens non l’ha modificato. Correggi o elimina il file, poi fai di nuovo clic su Add to Claude Desktop.
Non hai ancora Crawlens?
Scaricalo, scansiona un sito e poi torna qui per collegare i tuoi strumenti di AI.