Comment connecter Billnado à Microsoft 365 Copilot ?

Microsoft 365 Copilot utilise un agent déclaratif pour rendre les outils MCP de Billnado disponibles. Un administrateur ou un développeur d’intégration configure et publie cet agent une seule fois. Les utilisateurs sélectionnent ensuite l’agent Billnado dans Microsoft 365 Copilot et se connectent avec leur propre compte Billnado.

Prérequis

• Un environnement Microsoft 365 avec un accès à Copilot et l’autorisation de charger des applications personnalisées.
• Visual Studio Code avec Microsoft 365 Agents Toolkit 6.12.0 ou une version ultérieure.
• Un compte autorisé à provisionner ou charger l’agent dans le tenant Microsoft 365.

Demandez à un administrateur Microsoft 365 de vérifier les paramètres du tenant si Custom App Upload Enabled ou Copilot Access Enabled n’est pas disponible.

Créer l’agent déclaratif

1. Ouvrez Microsoft 365 Agents Toolkit dans Visual Studio Code.
2. Sélectionnez Create a New Agent/App.
3. Sélectionnez Declarative Agent.
4. Sélectionnez Add an Action, puis Start with an MCP Server.
5. Saisissez https://mcp.billnado.be/mcp comme URL du serveur MCP.
6. Sélectionnez OAuth (with dynamic registration) comme type d’authentification.
7. Choisissez un emplacement et donnez à l’agent un nom reconnaissable, par exemple Billnado.

Billnado prend en charge OAuth Dynamic Client Registration. Il n’est donc pas nécessaire de créer un client ID ou un client secret distinct. La boîte à outils génère la configuration du plugin avec la découverte dynamique des outils activée par défaut : Copilot récupère les outils Billnado disponibles auprès du serveur MCP pendant l’utilisation. Vous n’avez pas à sélectionner les outils manuellement. Cette découverte est distincte de l’enregistrement dynamique pour OAuth.

Provisionner et utiliser l’agent

1. Connectez-vous à Microsoft 365 dans Agents Toolkit.
2. Ouvrez Lifecycle et sélectionnez Provision.
3. Confirmez le provisioning et attendez que la boîte à outils termine.
4. Ouvrez Microsoft 365 Copilot Chat.
5. Sélectionnez le nouvel agent Billnado sous Agents. Pendant le développement, son nom se termine généralement par dev.
6. Posez une question sur Billnado et sélectionnez Sign in to Billnado lorsque Copilot vous le demande.
7. Connectez-vous via OAuth avec votre compte Billnado.

Pour un déploiement à l’échelle de l’organisation, l’administrateur doit publier l’agent conformément aux politiques Microsoft 365 de l’organisation et l’attribuer aux utilisateurs ou groupes concernés.

Administrations et contrôle d’accès

Chaque utilisateur se connecte individuellement. Billnado applique le même contrôle d’accès que l’application habituelle et utilise l’administration par défaut de cet utilisateur.

Demandez à l’IA d’utiliser subscribers_list pour trouver l’administration concernée. Transmettez son identifiant comme subscriberId à chaque appel suivant lié à cette administration. Ce paramètre remplace la configuration d’un en-tête de transport. Demandez explicitement subscriber_connect uniquement si une connexion comptable ou support reste nécessaire ; vos droits existants continuent de s’appliquer.

Billnado propose des actions de lecture et d’écriture. Vérifiez l’administration, le document et les conséquences proposées avant une modification ou un envoi. Pour modifier une licence, utilisez Ma licence dans Billnado ; MCP prend uniquement en charge les informations de licence et les calculs de prix.

Vérifier la connexion

Demandez par exemple à l’agent Billnado :

• « À quelles administrations ai-je accès ? »
• « Affichez la licence active et les limites d’utilisation. »
• « Recherchez le fournisseur Acme et affichez ses coordonnées. »

Lorsque les outils ne sont plus à jour

Avec la découverte dynamique activée par défaut, Copilot prend en compte les outils ajoutés, modifiés et supprimés pendant l’utilisation. Microsoft valide les outils nouveaux et modifiés avant de les rendre disponibles. Une modification des seuls outils Billnado ne nécessite donc pas de republier l’agent.

Si un outil attendu manque, demandez à l’administrateur de l’intégration de vérifier le mode de découverte du plugin. Avec la découverte dynamique, le tableau functions dans ai-plugin.json est vide et run_for_functions contient ["*"]. Vérifiez aussi si le serveur MCP rend l’outil disponible pour le compte Billnado connecté.

Si l’administrateur a délibérément configuré une sélection fixe (pinned tools), le plugin contient une liste d’outils fixe. Pour modifier cette liste ou les définitions d’outils incluses, l’administrateur doit mettre à jour le manifeste et soumettre à nouveau l’agent pour validation et publication.

Consultez Microsoft : découverte dynamique et pinned tools pour les différences et la configuration.

Consultez Utiliser Billnado via MCP pour tous les outils et les recommandations de sécurité. Consultez le guide officiel de Microsoft pour créer un plugin MCP dans un agent déclaratif pour les exigences du tenant, le provisioning et la publication.