Installatiehandleiding

Claude (claude.ai)

Voeg deze server toe als eigen connector in de instellingen van Claude, en hij is in elk gesprek beschikbaar.

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.

Stappen

Open Settings in claude.ai (uw profielmenu, links onderaan).
Ga naar Connectors.
Kies onderaan de lijst Add custom connector.
Plak de server-URL:
```
https://test.nbb-mcp.be/mcp
```
Open de geavanceerde opties of de authenticatie-opties en voeg de header toe:
```
Authorization: Bearer nbb_live_…
```
Add, en zet de connector daarna aan in het toolsmenu van een nieuw gesprek.

Claude toont dan drie tools onder deze connector: search_company, get_annual_accounts en get_operation.

Als het dialoogvenster geen veld voor een header heeft

Het connectordialoogvenster van Claude is meer dan eens van vorm veranderd, en sommige versies bieden alleen OAuth. Is er nergens plaats voor een bearertoken, dan werken twee wegen:

Gebruik Claude Code voor hetzelfde account — één commando, en dat verstuurt eigen headers.
Overbrug lokaal met mcp-remote, dat deze server aanbiedt aan een client die alleen stdio spreekt:
```
npx -y mcp-remote https://test.nbb-mcp.be/mcp --header "Authorization: Bearer nbb_live_…"
```

Bereikbaarheid

claude.ai verbindt vanaf de servers van Anthropic, niet vanuit uw browser. De URL hierboven moet dus vanaf het publieke internet bereikbaar zijn over HTTPS met een geldig certificaat — een adres op localhost of een louter intern adres kan hier niet werken, hoe goed het in Claude Code ook werkt.

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

Claude Code — Eén <code>claude mcp add</code>-commando in uw terminal.
ChatGPT — Een MCP-connector in developer mode, met de sleutel als bearertoken.
Codex CLI — Een <code>mcp_servers</code>-blok in ~/.codex/config.toml.
Elke andere MCP-client — De ruwe verbindingsgegevens, plus een JSON-configuratie die de meeste clients aanvaarden.