NBB Annual Accounts MCP

Guide d'installation

Codex CLI

Codex lit ses serveurs MCP dans ~/.codex/config.toml. Ajoutez un bloc et redémarrez-le.

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

Ouvrez ~/.codex/config.toml (créez-le s'il n'existe pas) et ajoutez :

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

Mettez ensuite la clé dans cette variable d'environnement plutôt que dans le fichier — même secret, un endroit de moins où elle peut être validée :

export NBB_MCP_KEY=nbb_live_…

Redémarrez Codex CLI pour qu'il relise la configuration.

Les serveurs MCP distants (HTTP streamable) sont un ajout récent à Codex. Si votre version refuse url, ou consigne que seuls les serveurs stdio sont pris en charge, mettez Codex à jour ou utilisez le pont ci-dessous — les anciennes versions ont aussi besoin de experimental_use_rmcp_client = true au niveau supérieur du fichier.

Repli : passer par un pont stdio

mcp-remote transforme un serveur MCP distant en serveur stdio, ce que toutes les versions de Codex prennent en charge :

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

Nécessite Node.js sur votre machine. C'est un pont, pas un proxy : le trafic va toujours directement à ce serveur.

Vérifier le chargement

Lancez Codex et demandez-lui quels outils il a. search_company, get_annual_accounts et get_operation doivent en faire partie, dans l'espace de noms nbb.

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