NBB Annual Accounts MCP

Einrichtungsanleitung

Claude Code

Ein Befehl. Claude Code spricht streamable HTTP von sich aus und kann den Header senden.

Sie brauchen zuerst einen Schlüssel. Ihre Kontoseite stellt einen aus — er beginnt mit nbb_live_ und wird einmal gezeigt. Haben Sie sich noch nicht angemeldet, melden Sie sich mit Ihrer E-Mail-Adresse an; der kostenlose Tarif verlangt keine Karte.

Den Server hinzufügen

In einem Terminal, mit Ihrem Schlüssel anstelle von nbb_live_…:

claude mcp add --transport http nbb https://test.nbb-mcp.be/mcp --header "Authorization: Bearer nbb_live_…"

Das registriert ihn für das aktuelle Projekt. Fügen Sie --scope user hinzu, um ihn in jedem Projekt auf diesem Rechner zu haben:

claude mcp add --scope user --transport http nbb https://test.nbb-mcp.be/mcp --header "Authorization: Bearer nbb_live_…"

Registrierung prüfen

claude mcp list

nbb sollte mit dem Status „verbunden" erscheinen. Starten Sie dann Claude Code und sehen Sie sich /mcp in der Sitzung an: dort stehen die drei Tools (search_company, get_annual_accounts, get_operation).

Ihr Schlüssel landet im Klartext in der Konfigurationsdatei von Claude Code, wie jede andere MCP-Zugangsdaten auch. Behandeln Sie ihn als Geheimnis in einer Dotfile: committen Sie keine projektbezogene .mcp.json mit dem Schlüssel in ein gemeinsames Repository — nehmen Sie --scope user.

Prüfen, ob es funktioniert

Beginnen Sie ein neues Gespräch und fragen Sie:

Finde den Jahresabschluss von Colruyt

Der Assistent sollte search_company aufrufen, die Unternehmensnummer 0400.378.485 (Etn. Fr. Colruyt NV) finden, dann get_annual_accounts aufrufen, ein- oder zweimal get_operation abfragen und eine Bilanz mit Rubrikcodes vorlesen.

Er sagt, er habe dieses Tool nicht

Der Connector ist nicht geladen. Die meisten Clients erkennen MCP-Server nur beim Start: starten Sie den Client neu und prüfen Sie, ob der Server in seiner Tool-Liste aktiviert ist.

Er meldet 401 oder "invalid API key"

Der Header fehlt, oder der Schlüssel ist falsch. Der Wert muss der ganze Schlüssel sein, einschließlich des Präfixes nbb_live_, nach dem Wort Bearer und einem Leerzeichen. Schlüssel werden einmal gezeigt — haben Sie ihn nicht kopiert, erzeugen Sie auf Ihrer Kontoseite einen neuen.

Er gibt nach einem Aufruf auf und sagt, es laufe noch

get_annual_accounts ist asynchron: er gibt eine Operations-ID und ein poll_after_seconds zurück. Sagen Sie dem Assistenten, get_operation abzufragen, bis der Status completed ist. Die Tool-Beschreibungen sagen das, aber ein kleineres Modell braucht manchmal den Hinweis.

Wieder entfernen

claude mcp remove nbb

Andere Clients