NBB Annual Accounts MCP

Guide d'installation

Claude Code

Une seule commande. Claude Code parle nativement le HTTP streamable et sait envoyer l'en-tête.

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.

Ajouter le serveur

Dans un terminal, avec votre clé à la place de nbb_live_… :

claude mcp add --transport http nbb https://test.nbb-mcp.be/mcp --header "Authorization: Bearer nbb_live_…"

Cela l'enregistre pour le projet courant. Ajoutez --scope user pour l'avoir dans tous les projets de cette machine :

claude mcp add --scope user --transport http nbb https://test.nbb-mcp.be/mcp --header "Authorization: Bearer nbb_live_…"

Vérifier l'enregistrement

claude mcp list

nbb doit apparaître avec un statut connecté. Lancez ensuite Claude Code et regardez /mcp dans la session : il liste les trois outils (search_company, get_annual_accounts, get_operation).

Votre clé se retrouve en clair dans le fichier de configuration de Claude Code, comme tout autre identifiant MCP. Traitez-la comme un secret dans un dotfile : ne validez pas dans un dépôt partagé un .mcp.json propre au projet qui la contient — utilisez plutôt --scope user.

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.

Le retirer

claude mcp remove nbb

Autres clients