NBB Annual Accounts MCP

Installatiehandleiding

Codex CLI

Codex leest zijn MCP-servers uit ~/.codex/config.toml. Voeg één blok toe en herstart hem.

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

Open ~/.codex/config.toml (maak het aan als het niet bestaat) en voeg toe:

[mcp_servers.nbb]
url = "https://test.nbb-mcp.be/mcp"
bearer_token_env_var = "NBB_MCP_KEY"

Zet de sleutel daarna in die omgevingsvariabele in plaats van in het bestand — hetzelfde geheim, één plaats minder waar het gecommit kan worden:

export NBB_MCP_KEY=nbb_live_…

Herstart Codex CLI zodat hij de configuratie opnieuw leest.

MCP-servers op afstand (streamable HTTP) zijn recent aan Codex toegevoegd. Weigert uw versie url, of logt ze dat alleen stdio-servers worden ondersteund, werk Codex dan bij of gebruik de brug hieronder — oudere builds hebben bovendien experimental_use_rmcp_client = true nodig op het hoogste niveau van het bestand.

Terugval: overbruggen via stdio

mcp-remote maakt van een MCP-server op afstand een stdio-server, en die ondersteunt elke versie van Codex:

[mcp_servers.nbb]
command = "npx"
args = ["-y", "mcp-remote", "https://test.nbb-mcp.be/mcp", "--header", "Authorization: Bearer nbb_live_…"]

Vereist Node.js op uw machine. Het is een brug, geen proxy: het verkeer gaat nog altijd rechtstreeks naar deze server.

Nagaan of hij geladen is

Start Codex en vraag welke tools hij heeft. search_company, get_annual_accounts en get_operation horen erbij te staan, onder de naamruimte nbb.

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