NBB Annual Accounts MCP

Einrichtungsanleitung

Jeder andere MCP-Client

Die Verbindungsdaten, die JSON-Form, die die meisten Clients annehmen, und ein curl-Aufruf, der beweist, dass der Server Ihnen antwortet.

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.

Verbindungsdaten

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

Ein Endpunkt bearbeitet POST (JSON-RPC-Anfragen) und SSE (gestreamte Antworten). Der Server ist zustandsbehaftet: er erwartet den üblichen initialize-Handshake vor Tool-Aufrufen.

JSON-Konfiguration

Die meisten Clients, die eine JSON-Konfigurationsdatei lesen, nehmen eine Form wie diese an — die Namen der Schlüssel unterscheiden sich je Client ein wenig (mcpServers oder servers, type oder transport), prüfen Sie also Ihren:

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

Spricht Ihr Client nur stdio?

Überbrücken Sie ihn; am Server ändert sich nichts:

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

Von Hand nachweisen

Listen Sie die Tools mit curl auf — ohne 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"}'

Ein fehlender oder falscher Schlüssel gibt 401 mit einem JSON-RPC-Fehlerkörper; zu viele Anfragen geben 429 mit Retry-After. Manche Clients brauchen zuerst den initialize-Handshake — genau das erledigt ein echter MCP-Client für Sie.

Der Accept-Header ist wichtig: der streamable-HTTP-Transport kann mit JSON oder mit einem SSE-Strom antworten und muss wissen, dass beides zulässig ist.

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