NBB MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die NBB Central Balance Sheet Office-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden