NBB Annual Accounts MCP

Guide d'installation

Claude (claude.ai)

Ajoutez ce serveur comme connecteur personnalisé dans les réglages de Claude, et il est disponible dans chaque conversation.

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.

Étapes

  1. Ouvrez Settings dans claude.ai (menu de votre profil, en bas à gauche).
  2. Allez dans Connectors.
  3. Choisissez Add custom connector au bas de la liste.
  4. Collez l'URL du serveur : 
    https://test.nbb-mcp.be/mcp
  5. Ouvrez les options avancées ou d'authentification et ajoutez l'en-tête : 
    Authorization: Bearer nbb_live_…
  6. Add, puis activez le connecteur dans le menu des outils d'une nouvelle conversation.

Claude affiche alors trois outils sous ce connecteur : search_company, get_annual_accounts et get_operation.

Si la boîte de dialogue n'a pas de champ pour un en-tête

La boîte de dialogue des connecteurs de Claude a changé de forme plus d'une fois, et certaines versions ne proposent qu'OAuth. Quand il n'y a nulle part où mettre un jeton bearer, deux voies fonctionnent :

Accessibilité

claude.ai se connecte depuis les serveurs d'Anthropic, pas depuis votre navigateur. L'URL ci-dessus doit donc être joignable depuis l'Internet public en HTTPS avec un certificat valide — une adresse en localhost ou purement interne ne peut pas fonctionner ici, aussi bien qu'elle marche dans Claude Code.

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