NBB Annual Accounts MCP

Installatiehandleiding

Claude Code

Eén commando. Claude Code spreekt streamable HTTP van zichzelf en kan de header meesturen.

U hebt eerst een sleutel nodig. Uw accountpagina geeft er een — hij begint met nbb_live_ en wordt één keer getoond. Hebt u zich nog niet aangemeld, meld u dan aan met uw e-mailadres; het gratis plan vraagt geen kaart.

De server toevoegen

In een terminal, met uw sleutel in de plaats van nbb_live_…:

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

Dat registreert hem voor het huidige project. Voeg --scope user toe om hem in elk project op deze machine te hebben:

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

Nagaan of hij geregistreerd is

claude mcp list

nbb hoort te verschijnen met status verbonden. Start daarna Claude Code en bekijk /mcp in de sessie: die toont de drie tools (search_company, get_annual_accounts, get_operation).

Uw sleutel komt in leesbare tekst in het configuratiebestand van Claude Code terecht, zoals elke andere MCP-credential. Behandel hem als een geheim in een dotfile: commit geen projectgebonden .mcp.json met die sleutel naar een gedeelde repository — gebruik --scope user.

Controleren of het werkt

Begin een nieuw gesprek en vraag:

Zoek de jaarrekening van Colruyt

De assistent hoort search_company aan te roepen, ondernemingsnummer 0400.378.485 (Etn. Fr. Colruyt NV) te vinden, dan get_annual_accounts aan te roepen, een of twee keer get_operation te pollen en een balans met rubriekcodes voor te lezen.

Hij zegt dat hij die tool niet heeft

De connector is niet geladen. De meeste clients pikken MCP-servers alleen bij het opstarten op: herstart de client en kijk of de server in zijn toolslijst aanstaat.

Hij meldt 401 of "invalid API key"

De header ontbreekt of de sleutel is verkeerd. De waarde moet de volledige sleutel zijn, inclusief het voorvoegsel nbb_live_, na het woord Bearer en één spatie. Sleutels worden één keer getoond — hebt u ze niet gekopieerd, maak dan een nieuwe aan op uw accountpagina.

Hij geeft na één aanroep op en zegt dat het nog bezig is

get_annual_accounts is asynchroon: hij geeft een operation-id terug en een poll_after_seconds. Zeg de assistent get_operation te pollen tot de status completed is. De toolbeschrijvingen zeggen dat, maar een kleiner model heeft soms een duwtje nodig.

Hem verwijderen

claude mcp remove nbb

Andere clients