NBB MCP mit Claude verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → NBB Central Balance Sheet Office klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

NBB Central Balance Sheet Office + Claude

Belgische Jahresabschlüsse aus der Bilanzzentrale der Belgischen Nationalbank (Webservice für authentische Daten): alle Jahresabschlüsse, die ein Unternehmen hinterlegt hat, anhand der Unternehmensnummer auflisten, die Referenzdaten einer Hinterlegung lesen und deren Abschlussdaten als JSON-XBRL oder XBRL oder das veröffentlichte PDF abrufen. Nur lesend.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

NBB_CBSO_SUBSCRIPTION_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert nur wenige Minuten, sobald die NBB deine Abonnements freigegeben hat. Du brauchst ein Abonnement der Webservices der NBB CBSO und ein Konto im CBSO-Entwicklerportal mit einem freigegebenen Abonnement des Produkts NBB CBSO Web Services - Authentic Data.

1. Abonniere die CBSO-Webservices über das Anmeldeformular auf nbb.be (Central Balance Sheet Office, Produkte). Die NBB schickt dir eine CLIENT_ID für deinen technischen Benutzer; der Connector selbst braucht nur den Subscription Key aus den nächsten Schritten.
2. Registriere dich im Entwicklerportal developer.cbso.nbb.be, öffne Products und abonniere NBB CBSO Web Services - Authentic Data. Die NBB gibt die Anfrage frei.
3. Öffne im Portal dein Profile und kopiere den Primary Key des Authentic-Data-Abonnements in NBB_CBSO_SUBSCRIPTION_KEY (der Secondary Key geht auch; nur Buchstaben und Ziffern). Der Connector sendet ihn im Header NBB-CBSO-Subscription-Key.
4. Installiere den Connector und prüfe die Verbindung mit nbb_cbso_list_annual_accounts für die Unternehmensnummer 0203201340, die NBB selbst.

Cloud und Self-Hosting funktionieren gleich: Der Connector braucht nur den Subscription Key, sonst ist nichts einzurichten.

Unternehmens- und Referenznummern: Die Unternehmensnummer ist die 10-stellige Nummer in der Zentralen Datenbank der Unternehmen (KBO/BCE), ohne Punkte und ohne das Präfix BE: 0203201340 für BE 0203.201.340. Jede Hinterlegung hat eine eigene Referenznummer wie 2023-00123456, im Feld ReferenceNumber der Liste. year ist das Jahr, in dem das Geschäftsjahr endet, und darf nicht nach dem laufenden Jahr liegen.

Berichtigungen ersetzen die erste Hinterlegung: Zu einem Geschäftsjahr kann es eine erste Hinterlegung und eine Berichtigung geben (DepositType). Nimm die neueste Hinterlegung eines Geschäftsjahres und prüfe, welchen Zeitraum die Zahlen abdecken.

Zahlen nur für standardisierte Abschlüsse: nbb_cbso_get_annual_account_data liefert standardmäßig JSON-XBRL, alternativ XBRL, mit den Rubrikcodes des belgischen Schemas: etwa 10/15 Eigenkapital, 70 Umsatz, 9904 Gewinn oder Verlust des Geschäftsjahres und 9087 durchschnittliche Zahl der Arbeitnehmer in Vollzeitäquivalenten. Nicht standardisierte Abschlüsse gibt es nur als PDF; nbb_cbso_get_annual_account_pdf funktioniert für beide.

Angehängte Dateien: JSON-XBRL und XBRL können als angehängte Datei statt als Text kommen, das PDF kommt immer so. Große Hinterlegungen können das Anhangslimit von 10 MB überschreiten.

Request-IDs: Jeder Aufruf trägt eine X-Request-Id, eine UUID der Version 4 zur Nachverfolgung. Die Tools setzen eine ein; mit request_id gibst du eine eigene mit.

Häufige Fehler: Die NBB antwortet mit Problem-JSON (title, status, violations). 400 heißt, dass die Unternehmens- oder Referenznummer falsch aufgebaut ist oder das Jahr in der Zukunft liegt, 401 ein fehlender oder falscher Subscription Key, 403 ein Key, dessen Abonnement das Produkt Authentic Data nicht abdeckt oder noch nicht freigegeben ist, 404, dass nichts gefunden wurde, und 429 zu viele Aufrufe.

Nicht enthalten: Archiv, Extrakte (tägliche Pakete als ZIP) und die Produkte mit aufbereiteten Daten (improved data) der NBB brauchen eigene Abonnements und sind hier nicht verfügbar. Von der Veröffentlichung befreite Unternehmen haben keine öffentlichen Dokumente.

Was der Connector liest: die Jahresabschlüsse, die belgische Unternehmen und Vereinigungen bei der Bilanzzentrale hinterlegt haben und die die NBB angenommen hat. Pro Hinterlegung: Hinterlegungsdatum, Beginn und Ende des Geschäftsjahres, Modell (vollständig, verkürzt, Mikro oder ein Modell für Vereinigungen), Art der Hinterlegung, Sprache und Währung sowie Name, Adresse, Rechtsform, Rechtslage, Tätigkeitscode und Datum der Generalversammlung des Unternehmens. Dazu die Abschlussdaten selbst (Bilanz, Gewinn- und Verlustrechnung, Anhang und Sozialbilanz) als JSON-XBRL oder XBRL und den veröffentlichten Jahresabschluss als PDF.

Nur lesend: Alle vier Tools lesen nur. Bei der NBB wird nichts hinterlegt, berichtigt oder geändert.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Claude hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Empfohlener Weg: funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.

1. Öffne in Claude Customize → Connectors.
2. Klicke auf + und dann auf Add custom connector.
3. Gib einen Namen ein, z. B. NBB Central Balance Sheet Office, und die Remote-MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Add.
4. Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.

Alle unten gelisteten Tools erscheinen in deinem Chat: Leg los mit Prompts.

Verfügbare Tools

Beispiel-Prompts

• „Liste alle Jahresabschlüsse auf, die das Unternehmen 0203.201.340 hinterlegt hat, mit Geschäftsjahr, Hinterlegungsdatum und Modell.“
• „Wie hoch waren Eigenkapital, Umsatz und Gewinn oder Verlust im neuesten Jahresabschluss des Unternehmens 0203201340, und welches Geschäftsjahr deckt er ab?“
• „Welche Rechtsform, Adresse und welchen Tätigkeitscode zeigt die neueste Hinterlegung, und wann war die Generalversammlung?“
• „Wie hat sich die durchschnittliche Zahl der Arbeitnehmer in Vollzeitäquivalenten in den letzten drei Jahresabschlüssen dieses Unternehmens entwickelt?“
• „Hol mir das veröffentlichte PDF des neuesten Jahresabschlusses des Unternehmens.“

FAQ

Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja, beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.

Nächste Schritte

• Connector-Startseite
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden