Hoe verbind ik Billnado met Microsoft 365 Copilot?

Microsoft 365 Copilot gebruikt een declarative agent om de Billnado MCP-tools beschikbaar te maken. Een beheerder of integratieontwikkelaar configureert en publiceert deze agent één keer. Gebruikers selecteren daarna de Billnado-agent in Microsoft 365 Copilot en melden zich aan met hun eigen Billnado-account.

Vereisten

• Een Microsoft 365-omgeving met Copilot-toegang en toestemming om aangepaste apps te uploaden.
• Visual Studio Code met Microsoft 365 Agents Toolkit 6.12.0 of nieuwer.
• Een account dat de agent in de Microsoft 365-tenant mag provisionen of sideloaden.

Laat een Microsoft 365-beheerder de tenantinstellingen controleren wanneer Custom App Upload Enabled of Copilot Access Enabled niet beschikbaar is.

Declarative agent maken

1. Open in Visual Studio Code de Microsoft 365 Agents Toolkit.
2. Kies Create a New Agent/App.
3. Kies Declarative Agent.
4. Kies Add an Action en daarna Start with an MCP Server.
5. Vul https://mcp.billnado.be/mcp in als MCP-server-URL.
6. Kies OAuth (with dynamic registration) als authenticatietype.
7. Kies een opslaglocatie en geef de agent een herkenbare naam, bijvoorbeeld Billnado.

Billnado ondersteunt OAuth Dynamic Client Registration. Je hoeft daarom geen afzonderlijke client-ID of client secret aan te maken. De toolkit genereert de pluginconfiguratie en ontdekt de beschikbare Billnado-tools dynamisch.

Agent provisionen en gebruiken

1. Meld je in de Agents Toolkit aan bij Microsoft 365.
2. Open Lifecycle en kies Provision.
3. Bevestig de provisioning en wacht tot de toolkit klaar is.
4. Open Microsoft 365 Copilot Chat.
5. Selecteer de nieuwe Billnado-agent in Agents. Tijdens ontwikkeling staat meestal dev achter de naam.
6. Stel een Billnado-vraag en kies Sign in to Billnado wanneer Copilot daarom vraagt.
7. Voltooi de OAuth-aanmelding met je Billnado-account.

Voor een organisatiebrede uitrol moet de beheerder de agent volgens het eigen Microsoft 365-beleid publiceren en aan de juiste gebruikers of groepen toewijzen.

Administraties en toegangscontrole

Elke gebruiker meldt zich individueel aan. Billnado past dezelfde toegangscontrole toe als in de gewone toepassing en gebruikt standaard de standaardadministratie van die gebruiker.

Laat Copilot eerst subscribers_list gebruiken wanneer meerdere administraties mogelijk zijn. subscriber_connect mag alleen worden gebruikt nadat de gebruiker expliciet heeft gevraagd om met de gekozen administratie te verbinden. Omdat een MCP-tool de transportheader van Copilot niet zelf kan wijzigen, blijft de standaardadministratie de betrouwbaarste keuze wanneer de agent geen dynamische SubscriberId-header ondersteunt.

Controleren of de koppeling werkt

Vraag de Billnado-agent bijvoorbeeld:

• “Welke administraties kan ik openen?”
• “Toon de actieve licentie en gebruikslimieten.”
• “Zoek leverancier Acme en toon de contactgegevens.”

Na een update

Microsoft 365 Copilot kan een snapshot van de MCP-tools opslaan. Werk bij wijzigingen ook de declarative agent en deze documentatie bij, publiceer de agent opnieuw en start zo nodig een nieuw gesprek.

Bekijk Billnado gebruiken via MCP voor alle tools en beveiligingsrichtlijnen. Raadpleeg de officiële Microsoft-handleiding voor een MCP-plugin in een declarative agent voor tenantvereisten, provisioning en publicatie.