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

Le serveur MCP (Model Context Protocol) de Billnado offre aux clients d’IA compatibles un accès contrôlé aux outils et à la documentation produit de Billnado. Les utilisateurs peuvent demander en langage naturel des informations sur les administrations, les relations et les licences. Le client d’IA choisit l’outil adapté à la question, tandis que le serveur reste responsable de l’authentification et du contrôle d’accès.

Cette documentation concerne uniquement les chatbots visuels. Les outils de programmation IA, les clients CLI et les extensions IDE n’en font pas partie.

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 actuels ainsi que leurs champs d’entrée et de sortie figurent toujours dans la documentation en ligne des outils. Le serveur permet notamment de :

• Administrations : rechercher les administrations accessibles, consulter l’administration active et se connecter explicitement via un accès direct, comptable ou support.
• Relations : rechercher des clients, fournisseurs et prospects et consulter les informations complètes d’une relation.
• Licences : consulter la licence active et rechercher les licences passées, actuelles ou futures.
• Documentation : afficher les langues disponibles, rechercher dans la documentation Billnado, récupérer un article Markdown complet et résoudre l’aide contextuelle à partir d’une route d’application.

Presque tous les outils sont en lecture seule. subscriber_connect constitue l’exception : après une demande explicite de l’utilisateur, cet outil idempotent peut créer la connexion comptable ou support existante nécessaire pour utiliser une administration.

Travailler avec les administrations

Sans en-tête supplémentaire, Billnado utilise l’administration par défaut du compte connecté ou, à défaut, la première administration accessible.

Pour utiliser une autre administration, un client d’IA suit normalement ces étapes :

1. Appeler subscribers_list pour trouver l’administration et la voie d’accès disponible.
2. Appeler subscriber_connect uniquement si l’utilisateur demande explicitement de se connecter à cette administration.
3. Envoyer la valeur obtenue dans l’en-tête HTTP SubscriberId des requêtes MCP suivantes.

Un outil MCP ne peut pas modifier la configuration de transport du client. Si le client ne peut pas changer les en-têtes pendant une session, ajoutez SubscriberId à sa configuration puis reconnectez-vous. Utilisez uniquement un identifiant renvoyé par subscribers_list pour le compte connecté ; une administration inaccessible provoque une erreur.

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

Si un chatbot ne reconnaît pas une fonctionnalité Billnado nouvelle ou modifiée, actualisez ou reconnectez le connecteur et démarrez si nécessaire une nouvelle conversation. Le chatbot charge ainsi les outils actuels au lieu de l’instantané enregistré lors de la connexion.

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