NBB Annual Accounts MCP

Installatiehandleiding

Elke andere MCP-client

De verbindingsgegevens, de JSON-vorm die de meeste clients aanvaarden, en een curl-aanroep die bewijst dat de server u antwoordt.

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.

Verbindingsgegevens

Server-URL https://test.nbb-mcp.be/mcp
Header Authorization: Bearer nbb_live_…
Transport MCP streamable HTTP

Eén endpoint behandelt POST (JSON-RPC-aanvragen) en SSE (gestreamde antwoorden). De server is stateful: hij verwacht de gebruikelijke initialize-handshake voor tool-aanroepen.

JSON-configuratie

De meeste clients die een JSON-configuratiebestand lezen, aanvaarden een vorm als deze — de namen van de sleutels verschillen een beetje per client (mcpServers versus servers, type versus transport), dus kijk de uwe na:

{
  "mcpServers": {
    "nbb": {
      "type": "http",
      "url": "https://test.nbb-mcp.be/mcp",
      "headers": {
        "Authorization": "Bearer nbb_live_…"
      }
    }
  }
}

Spreekt uw client alleen stdio?

Overbrug hem; aan de server verandert niets:

npx -y mcp-remote https://test.nbb-mcp.be/mcp --header "Authorization: Bearer nbb_live_…"

Met de hand bewijzen

Vraag de tools op met curl — zonder MCP-client:

curl -sS https://test.nbb-mcp.be/mcp \
  -H "Authorization: Bearer nbb_live_…" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Een ontbrekende of verkeerde sleutel geeft 401 met een JSON-RPC-foutbody; te veel aanvragen geeft 429 met Retry-After. Sommige clients hebben eerst de initialize-handshake nodig — dat is wat een echte MCP-client voor u doet.

De Accept-header is van belang: het streamable-HTTP-transport kan antwoorden met JSON of met een SSE-stroom, en moet weten dat beide aanvaardbaar zijn.

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.

Andere clients