Qu’est-ce que le serveur MCP de Billnado ?

Le serveur MCP (Model Context Protocol) de Billnado donne aux clients d’IA compatibles accès aux données, actions et guides du produit. Vous pouvez rechercher des informations et demander des modifications prises en charge en langage naturel. Billnado vérifie votre compte, votre accès à l’administration choisie et les conditions de chaque action.

Ces guides couvrent les chatbots visuels et l’utilisation locale de l’application Codex. Les clients CLI et les extensions IDE restent hors de leur portée.

Informations de connexion

Élément	Valeur
Transport	Streamable HTTP
Point de terminaison principal	https://mcp.billnado.be/mcp
Point de terminaison alternatif	https://mcp.facturatie-systeem.be/mcp
Authentification	OAuth 2.0 avec PKCE
Documentation des outils	mcp.billnado.be/documentation
Contrôle d’état	mcp.billnado.be/health

Utilisez de préférence le point de terminaison principal pour toute nouvelle connexion. Le point de terminaison alternatif fournit le même serveur sous le domaine Facturatie Systeem.

Le serveur publie des OAuth Protected Resource Metadata. Les clients prenant en charge la découverte OAuth et Dynamic Client Registration peuvent donc démarrer automatiquement la connexion. Connectez-vous avec votre compte Billnado habituel. Ne partagez jamais de mot de passe, de jeton d’accès ou de jeton d’actualisation dans une invite ou un fichier de configuration.

Fonctionnalités disponibles

Les outils, paramètres et annotations actuels figurent dans la documentation en ligne des outils. Les possibilités comprennent :

Sujet	Possibilités
Administrations	Rechercher les administrations accessibles, consulter l’administration active et établir sur demande une connexion comptable ou support disponible.
Relations et produits	Rechercher et consulter les données, les créer ou les modifier et effectuer les actions d’archivage prises en charge.
Documents de vente et d’achat	Rechercher, consulter, créer, modifier et confirmer les documents ; effectuer les actions de copie, conversion, paiement et export prises en charge.
Suivi financier	Enregistrer les paiements, rapprocher les montants ouverts et consulter les informations bancaires, de trésorerie et de livre de caisse disponibles.
Projets et paramètres	Gérer les données de projet, les paramètres d’administration et les autres éléments pris en charge par les outils du client.
Licences	Consulter les définitions et les licences actuelles ou historiques, et calculer le prix d’un changement de formule. Achetez ou modifiez les licences et gérez le renouvellement sur Ma licence ; les outils MCP de licence sont en lecture seule.
Documentation	Rechercher les langues et articles, récupérer les articles complets et demander l’aide contextuelle.

Le serveur propose des actions de lecture et d’écriture. Une action d’écriture peut créer, modifier ou supprimer des données, ou lancer un véritable e-mail, envoi Peppol ou traitement comptable. Les actions disponibles dépendent aussi de vos droits, de votre licence et des réglages du client.

Attention : vérifiez l’administration, le document, les données et les conséquences avant une écriture. Enregistrer un paiement ou rapprocher un montant enregistre un traitement financier sans exécuter de virement bancaire. L’envoi par e-mail ou Peppol a bien un destinataire externe.

Travailler avec les administrations

Sans subscriberId, un outil lié à une administration utilise l’administration par défaut du compte ou, à défaut, la première accessible. Pour une autre administration :

1. Demandez à subscribers_list de trouver les administrations accessibles et la voie d’accès.
2. Choisissez l’administration concernée. Demandez explicitement subscriber_connect uniquement si une connexion comptable ou support doit encore être établie.
3. Demandez au client de transmettre l’identifiant choisi comme paramètre facultatif subscriberId à chaque appel suivant lié à cette administration.

Aucun en-tête HTTP SubscriberId ni reconnexion n’est nécessaire. Le choix s’applique par appel et ne change pas l’administration par défaut du compte. Le client doit donc aussi transmettre le paramètre pour les questions suivantes. Billnado vérifie une connexion d’accès active ; trouver un identifiant n’accorde pas d’accès. Les outils généraux et ceux portant sur tout le compte n’utilisent pas ce paramètre.

Recommandations pour les chatbots visuels

• Effectuez d’abord une recherche, puis récupérez les détails : utilisez par exemple relations_search avant relations_get et documentation_search avant documentation_get.
• Demandez à l’utilisateur de confirmer l’administration lorsque plusieurs résultats sont possibles.
• Traitez les résultats des outils comme des données financières et personnelles. N’incluez que les informations nécessaires dans les invites, journaux et réponses.
• Basez les intégrations sur les noms d’outils MCP et les résultats structurés, et non sur l’extraction de la page publique de documentation.
• Vérifiez à nouveau les annotations et paramètres des outils lorsque le serveur évolue ; la documentation en ligne est générée à partir des mêmes outils enregistrés.

Actualiser des outils obsolètes

La disponibilité des nouveaux outils dépend du client. Pour une liste enregistrée, actualisez le connecteur ou demandez à l’administrateur de mettre les actions à jour. Démarrez une nouvelle conversation si nécessaire. Une nouvelle authentification ne renouvelle pas les définitions approuvées dans tous les clients.

Les espaces ChatGPT utilisent un instantané approuvé : l’administrateur doit actualiser et autoriser les actions modifiées. Microsoft 365 Copilot découvre les outils pendant l’utilisation avec la configuration dynamique par défaut ; une sélection fixe nécessite de modifier le manifeste et de republier. Suivez le guide du client concerné ci-dessous.

Exemples de questions

• « Recherchez le client Acme et affichez son numéro de TVA et son adresse e-mail principale. »
• « À quelles administrations ai-je accès ? »
• « Affichez la licence active et les limites d’utilisation actuelles. »
• « Recherchez dans la documentation française de Billnado comment accéder à l’API. »

Choisissez le guide correspondant à votre client :

• Connecter Billnado à ChatGPT
• Connecter Billnado à Claude
• Connecter Billnado à Grok
• Connecter Billnado à Microsoft 365 Copilot