NBB Annual Accounts MCP

Guide d'installation

Tout autre client MCP

Les détails de connexion, la forme JSON que la plupart des clients acceptent, et un appel curl qui prouve que le serveur vous répond.

Il vous faut d'abord une clé. Votre page de compte en délivre une — elle commence par nbb_live_ et n'est affichée qu'une fois. Si vous ne vous êtes pas encore inscrit, connectez-vous avec votre adresse e-mail ; le plan gratuit ne demande pas de carte.

Détails de connexion

URL du serveur https://test.nbb-mcp.be/mcp
En-tête Authorization: Bearer nbb_live_…
Transport MCP streamable HTTP

Un seul point d'entrée gère POST (requêtes JSON-RPC) et SSE (réponses en flux). Le serveur est à état : il attend la poignée de main initialize habituelle avant tout appel d'outil.

Configuration JSON

La plupart des clients qui lisent un fichier de configuration JSON acceptent une forme comme celle-ci — les noms des clés diffèrent un peu d'un client à l'autre (mcpServers ou servers, type ou transport), vérifiez donc le vôtre :

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

Votre client ne parle que stdio ?

Faites un pont ; rien ne change du côté du serveur :

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

Le prouver à la main

Listez les outils avec curl — sans aucun client MCP :

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"}'

Une clé absente ou erronée donne 401 avec un corps d'erreur JSON-RPC ; trop de requêtes donnent 429 avec Retry-After. Certains clients ont d'abord besoin de la poignée de main initialize — c'est ce qu'un vrai client MCP fait pour vous.

L'en-tête Accept compte : le transport HTTP streamable peut répondre en JSON ou par un flux SSE, et il doit savoir que les deux sont acceptables.

Vérifier que ça marche

Ouvrez une nouvelle conversation et demandez :

Trouve les comptes annuels de Colruyt

L'assistant devrait appeler search_company, trouver le numéro d'entreprise 0400.378.485 (Etn. Fr. Colruyt NV), puis appeler get_annual_accounts, interroger get_operation une ou deux fois, et vous restituer un bilan avec ses codes de rubrique.

Il dit qu'il n'a pas cet outil

Le connecteur n'est pas chargé. La plupart des clients ne détectent les serveurs MCP qu'au démarrage : redémarrez-le et vérifiez que le serveur est activé dans sa liste d'outils.

Il signale 401 ou « invalid API key »

L'en-tête manque ou la clé est erronée. La valeur doit être la clé entière, préfixe nbb_live_ compris, après le mot Bearer et une seule espace. Les clés ne sont affichées qu'une fois — si vous ne l'avez pas copiée, régénérez-la sur votre page de compte.

Il abandonne après un appel et dit que c'est encore en cours

get_annual_accounts est asynchrone : il renvoie un identifiant d'opération et un poll_after_seconds. Dites à l'assistant d'interroger get_operation jusqu'à ce que le statut soit completed. Les descriptions d'outil le disent, mais un modèle plus petit a parfois besoin d'un coup de pouce.

Autres clients