Cruscotto Italia MCP.

Server Model Context Protocol che federa dataset pubblici sui comuni italiani (ANAC, BDAP-MOP, SIOPE, PNRR, ISPRA Suolo/IdroGEO/Rifiuti, ISPRA SNPA qualità aria, Protezione Civile classificazione sismica comunale, ISTAT POSAS/Censimento/Veicoli/Incidenti, MIUR scuole, ACI nuove iscrizioni, MEF Federalismo Fiscale, MEF Patrimonio Immobiliare, Agenzia delle Entrate ANNCSU civici e strade, Ministero della Salute farmacie/parafarmacie/posti letto ospedalieri, GSE/MASE Piattaforma Unica Nazionale punti di ricarica veicoli elettrici, AGCOM Broadband Map copertura banda larga, MIMIT Osservatorio Prezzi Carburanti, Ministero del Lavoro Registro Unico Nazionale Terzo Settore RUNTS, ISTAT Archivio Statistico Imprese Attive ASIA UL, ISTAT Matrice Pendolarismo 2021 Censimento permanente, ISTAT Basi Territoriali 2021 e Variabili censuarie del Censimento permanente con 119 variabili per sezione di censimento, MiC ArCo + Cultural-ON beni culturali immobili tutelati e Luoghi della Cultura visitabili, ItaliaMeteo ICON-2I previsioni meteorologiche per tutti i comuni, CNR-IRPI HR-DTM 5m morfologia del territorio). Connettilo al tuo client LLM per interrogare i dati ufficiali con linguaggio naturale.

Come connetterlo

Claude.ai (web e mobile)

Disponibile sui piani Free (limite 1 connettore custom), Pro, Max, Team ed Enterprise.

1. Apri claude.ai/settings/connectors (oppure Settings → Connectors).
2. Click sul pulsante + accanto a "Connectors" → Add custom connector.
3. Compila il form:
   • Name: Cruscotto Italia
   • Remote MCP server URL: https://cruscotto-italia-mcp.agid.workers.dev/mcp
4. Lascia Advanced settings vuoto (nessuna autenticazione richiesta).
5. Click Add e poi Connect.

Per attivare il connettore in una chat: pulsante + in basso a sinistra → Connectors → toggle Cruscotto Italia.

Claude Desktop

Aggiungi al file claude_desktop_config.json:

{
  "mcpServers": {
    "cruscotto-italia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cruscotto-italia-mcp.agid.workers.dev/mcp"
      ]
    }
  }
}

Riavvia Claude Desktop. Il file di configurazione si trova in ~/Library/Application Support/Claude/ (macOS) o %APPDATA%\Claude\ (Windows).

Skill opzionale per Claude

Per ottenere risposte più mirate quando l'utente chiede dati su uno o più comuni italiani, è disponibile una skill Claude che documenta l'uso del connettore: inventario dei tool, schema completo di comune_kpi (~55 KPI sintetici, ~620 token) e comune_dashboard (vista completa con sezioni immobili_pa, anncsu, sanita_mds per farmacie/ospedali, pun per ricarica EV, agcom_bbmap per banda larga FTTH/FTTC, carburanti per prezzi MIMIT, runts per Terzo Settore, asia per imprese e addetti, pendolarismo per matrice flussi casa-lavoro, censimento per Basi Territoriali ISTAT 2021 con 119 variabili per sezione, beni_culturali per beni immobili tutelati MiC ArCo + Luoghi della Cultura visitabili Cultural-ON come chiese/palazzi/castelli/archeologia/musei/biblioteche/archivi, meteo_italiameteo per previsioni ItaliaMeteo ICON-2I temperatura/precipitazioni/vento/neve, morfologia per analisi DTM 5m CNR-IRPI: elevazione/pendenze/esposizione/geomorfologia/irraggiamento solare, omi per le quotazioni immobiliari per zona omogenea sub-comunale), endpoint REST /data/anncsu_full/<istat>.json, /data/censimento_full/<istat>.geojson e /data/beni_culturali_full/<istat>.json e cartografia catastale Agenzia delle Entrate /data/catasto_full/<istat>_map.geojson.gz (fogli) + /data/catasto_full/<istat>_ple.geojson.gz (particelle), pattern operativi e caveat per sezione.

Scarica il pacchetto e caricalo nelle Skills di Claude (UI o API):

cruscotto-italia-workflow-v2.12.0.zip — skill versione 2.12.0 del 06/10/2026

Per analisi ripetute e ranking fra comuni e disponibile anche una skill CLI: uno script Python 3 senza dipendenze che legge direttamente i file JSON pubblici, filtrandoli prima di caricarli in contesto. Non passa dall'endpoint MCP.

cruscotto-cli-v0.3.0.zip — skill CLI versione 0.3.0 del 04/10/2026

ChatGPT (Custom GPT)

Nei custom GPT con supporto MCP, aggiungi un nuovo server con URL https://cruscotto-italia-mcp.agid.workers.dev/mcp e tipo JSON-RPC 2.0. Nessuna autenticazione richiesta.

Client generico / curl

curl -X POST https://cruscotto-italia-mcp.agid.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tool disponibili

Strumenti MCP. search_comune va sempre chiamato per primo quando l'utente fornisce un nome di comune, per ottenere il codice ISTAT. Per query puntuali e confronti tra comuni (es. "popolazione di Bari", "Verona vs Bari su PNRR") usa comune_kpi (~620 token, 55 KPI sintetici). Per vista dettagliata di un singolo comune con tutte le sezioni complete (mappe, top liste, time series) usa comune_dashboard (vista completa di tutte le sezioni).

Sezioni di comune_dashboard

Tutte le fonti integrate sono esposte come sezioni dentro la risposta di comune_dashboard. Per interrogarle, chiama comune_dashboard(istat_code) e leggi la chiave corrispondente:

Esempi di prompt

Note tecniche

Endpoint MCP: POST /mcp · Health check: GET /health · Rate limit: 60 richieste al minuto · Cache: 1 ora · Trasporto: JSON-RPC 2.0 over HTTP.

Tutti i dati provengono da open data ufficiali con licenza CC-BY 4.0, IODL 2.0 o, in assenza di licenza espressa da parte di soggetti art. 2 c.2 CAD, CC BY 4.0 ai sensi del principio "open by default" di cui all'art. 52 c.2 D.Lgs 82/2005 (Codice dell'Amministrazione Digitale) e delle Linee Guida Open Data AgID (Det. 183/2023). L'aggregazione per codice ISTAT è eseguita da pipeline Python che pubblicano su Cloudflare R2; il worker fa solo lookup e composizione.