NBB Annual Accounts MCP

Einrichtungsanleitung

Codex CLI

Codex liest seine MCP-Server aus ~/.codex/config.toml. Fügen Sie einen Block hinzu und starten Sie ihn neu.

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

Öffnen Sie ~/.codex/config.toml (erstellen Sie sie, wenn sie nicht existiert) und fügen Sie hinzu:

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

Legen Sie den Schlüssel dann in diese Umgebungsvariable statt in die Datei — dasselbe Geheimnis, ein Ort weniger, an dem es committet werden kann:

export NBB_MCP_KEY=nbb_live_…

Starten Sie Codex CLI neu, damit die Konfiguration neu gelesen wird.

Entfernte MCP-Server (streamable HTTP) sind eine neue Ergänzung in Codex. Weist Ihre Version url ab oder protokolliert sie, dass nur stdio-Server unterstützt werden, aktualisieren Sie Codex oder nehmen Sie die Brücke unten — ältere Builds brauchen zusätzlich experimental_use_rmcp_client = true auf oberster Ebene der Datei.

Rückfall: Brücke über stdio

mcp-remote macht aus einem entfernten MCP-Server einen stdio-Server, und den unterstützt jede Codex-Version:

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

Braucht Node.js auf Ihrem Rechner. Es ist eine Brücke, kein Proxy: der Verkehr geht weiterhin direkt an diesen Server.

Laden prüfen

Starten Sie Codex und fragen Sie, welche Tools er hat. search_company, get_annual_accounts und get_operation sollten darunter sein, im Namensraum nbb.

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.

Andere Clients