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 et découvre dynamiquement les outils Billnado disponibles.

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 à Copilot d’utiliser d’abord subscribers_list lorsque plusieurs administrations sont possibles. subscriber_connect ne peut être utilisé qu’après une demande explicite de connexion à l’administration sélectionnée. Comme un outil MCP ne peut pas modifier l’en-tête de transport de Copilot, l’administration par défaut reste le choix le plus fiable lorsque l’agent ne prend pas en charge un en-tête SubscriberId dynamique.

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. »

Après une mise à jour

Microsoft 365 Copilot peut enregistrer un instantané des outils MCP. Lorsqu’ils changent, mettez également à jour l’agent déclaratif et cette documentation, republiez l’agent et démarrez si nécessaire une nouvelle conversation.

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.