Collegare NBB MCP a ChatGPT

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → NBB Central Balance Sheet Office, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

NBB Central Balance Sheet Office + ChatGPT

Conti annuali belgi dalla Centrale dei bilanci della Banca Nazionale del Belgio (web service dei dati autentici): elenca tutti i conti annuali depositati da un'impresa in base al numero d'impresa, legge i dati di riferimento di un deposito e ne recupera i dati contabili in JSON-XBRL o XBRL o il PDF pubblicato. Sola lettura.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

NBB_CBSO_SUBSCRIPTION_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede pochi minuti, una volta che la NBB ha approvato le tue sottoscrizioni. Ti servono una sottoscrizione ai web service della NBB CBSO e un account sul portale per sviluppatori della CBSO con una sottoscrizione approvata al prodotto NBB CBSO Web Services - Authentic Data.

1. Sottoscrivi i web service della CBSO con il modulo di sottoscrizione su nbb.be (Central Balance Sheet Office, prodotti). La NBB ti invia un CLIENT_ID per il tuo utente tecnico; al connettore serve solo la subscription key dei passi successivi.
2. Registrati sul portale per sviluppatori developer.cbso.nbb.be, apri Products e sottoscrivi NBB CBSO Web Services - Authentic Data. La NBB approva la richiesta.
3. Apri il tuo Profile sul portale e copia la primary key della sottoscrizione Authentic Data in NBB_CBSO_SUBSCRIPTION_KEY (va bene anche la secondary key; solo lettere e cifre). Il connettore la invia nell'header NBB-CBSO-Subscription-Key.
4. Installa il connettore e verifica la connessione con nbb_cbso_list_annual_accounts per il numero d'impresa 0203201340, che è la NBB stessa.

Cloud e self-hosting funzionano allo stesso modo: il connettore ha bisogno solo della subscription key, non c'è altro da configurare.

Numeri d'impresa e di riferimento: il numero d'impresa è il numero a 10 cifre della Banca-Carrefour delle Imprese (KBO/BCE), senza punti né prefisso BE: 0203201340 per BE 0203.201.340. Ogni deposito ha un proprio numero di riferimento, come 2023-00123456, nel campo ReferenceNumber dell'elenco. year è l'anno in cui si chiude l'esercizio e non può essere successivo all'anno in corso.

Le rettifiche sostituiscono il deposito iniziale: per un esercizio possono esserci un deposito iniziale e una rettifica (DepositType). Usa il deposito più recente di un esercizio e controlla a quali date dell'esercizio si riferiscono i numeri.

Dati contabili solo per i conti standardizzati: nbb_cbso_get_annual_account_data restituisce JSON-XBRL per default, oppure XBRL, con i codici delle rubriche dello schema belga: ad esempio 10/15 patrimonio netto, 70 fatturato, 9904 utile o perdita dell'esercizio e 9087 numero medio di lavoratori in equivalenti a tempo pieno. I conti non standardizzati esistono solo in PDF; nbb_cbso_get_annual_account_pdf funziona per entrambi.

File allegati: JSON-XBRL e XBRL possono arrivare come file allegato invece che come testo; il PDF arriva sempre così. I depositi grandi possono superare il limite di 10 MB per gli allegati.

Id della richiesta: ogni chiamata porta un X-Request-Id, un UUID versione 4 per il tracciamento. I tool ne inseriscono uno; con request_id puoi passarne uno tuo.

Errori frequenti: la NBB risponde con un problem JSON (title, status, violations). 400 vuol dire un numero d'impresa o di riferimento malformato o un anno nel futuro, 401 una subscription key mancante o sbagliata, 403 una key la cui sottoscrizione non copre il prodotto Authentic Data o non è ancora approvata, 404 che non è stato trovato nulla e 429 troppe chiamate.

Non incluso: l'archivio, gli estratti (lotti giornalieri in zip) e i prodotti di dati migliorati (improved data) della NBB richiedono sottoscrizioni separate e qui non sono disponibili. Le imprese esonerate dalla pubblicazione non hanno documenti pubblici.

Cosa legge: i conti annuali che le imprese e le associazioni belghe hanno depositato presso la Centrale dei bilanci e che la NBB ha accettato. Per ogni deposito: data di deposito, date di inizio e fine dell'esercizio, modello (completo, abbreviato, micro o un modello per associazioni), tipo di deposito, lingua e valuta, e poi nome, indirizzo, forma giuridica, situazione giuridica, codice di attività e data dell'assemblea generale dell'impresa. Inoltre i dati contabili (stato patrimoniale, conto economico, note e bilancio sociale) in JSON-XBRL o XBRL e il conto annuale pubblicato in PDF.

Sola lettura: tutti e quattro i tool leggono soltanto. Presso la NBB non viene depositato, rettificato o modificato nulla.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in ChatGPT

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

1. Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
2. Inserisci un nome, ad esempio Name: NBB Central Balance Sheet Office.
3. In Connection inserisci come Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Tool disponibili

Esempi di prompt

• "Elenca tutti i conti annuali depositati dall'impresa 0203.201.340, con date dell'esercizio, data di deposito e modello."
• "Quanto valevano patrimonio netto, fatturato e utile o perdita dell'esercizio nell'ultimo conto annuale dell'impresa 0203201340, e a quale esercizio si riferiscono?"
• "Quali forma giuridica, indirizzo e codice di attività riporta l'ultimo deposito, e quando si è tenuta l'assemblea generale?"
• "Com'è cambiato il numero medio di lavoratori in equivalenti a tempo pieno negli ultimi tre conti annuali di questa impresa?"
• "Scaricami il PDF pubblicato dell'ultimo conto annuale dell'impresa."

FAQ

Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Prossimi passi

• Landing del connettore
• Collegare a Claude