Come collegare Destatis GENESIS a MCP per agenti AI

Statistiche Destatis GENESIS con Agenti AI

Il Destatis (Statistisches Bundesamt) offre accesso a dati ufficiali su popolazione, economia, commercio e mercato del lavoro tedesco tramite l'API GENESIS.

Configurazione Rapida

Passo 1: Distribuisci AnythingMCP

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Passo 2: Ottieni le Credenziali GENESIS

Registrati gratuitamente su genesis.destatis.de.

Destatis raccomanda di identificarsi con un token API personale anziché con la password: dopo il login, copia la stringa di 32 caratteri dal modale "Webservice-Schnittstelle (API)". Il token può essere rigenerato indipendentemente dalle credenziali. Attenzione: con il token è possibile solo l'accesso in lettura; le query su tabelle molto grandi che Destatis accoda (job=true) richiedono ancora username e password.

Passo 3: Importa l'Adattatore Destatis

Apri http://localhost:3000/connectors/store e clicca Import. Inserisci il token API oppure la tua Nutzerkennung nel campo Username or Token. Il campo Password è opzionale — lascialo vuoto se usi un token.

Nota sull'autenticazione: Destatis ha disattivato definitivamente le richieste GET con credenziali nell'URL il 30 giugno 2025. L'API è ora raggiungibile solo via POST con le credenziali nell'header HTTP, e l'adattatore è configurato di conseguenza. find/find è un servizio pubblico: risponde Code: 0 con gli stessi risultati con o senza credenziali, quindi una ricerca di tabelle vuota significa che non è stato trovato nulla e non indica mai un problema di credenziali. I servizi dati, metadati e catalogo sono invece protetti: Code: 15 significa che le credenziali non sono arrivate, Code: 2 che sono arrivate ma sono errate. Per sapere quale utenza sta rispondendo usa destatis_login_check: riporta isGuest: true quando la richiesta gira come account anonimo GAST.

Aggiornare un'installazione esistente: rimuovi il connettore e reinstallalo dallo store invece di sincronizzarlo. La sincronizzazione del catalogo aggiorna le definizioni dei tool ma non il tipo di autenticazione né la base URL del connettore: un connettore vecchio sincronizzato continuerebbe a inviare le credenziali come parametri URL verso l'host dismesso.

Passo 4: Collega al Tuo Agente AI

{
  "mcpServers": {
    "destatis": { "url": "http://localhost:4000/mcp" }
  }
}

Casi d'Uso

• "Qual è la popolazione attuale della Germania?"
• "Mostra la crescita del PIL degli ultimi 10 anni"
• "Cerca dati sull'indice dei prezzi al consumo"