Wie verbinde ich Billnado mit Microsoft 365 Copilot?

Microsoft 365 Copilot verwendet einen deklarativen Agenten, um die Billnado MCP-Tools bereitzustellen. Ein Administrator oder Integrationsentwickler konfiguriert und veröffentlicht diesen Agenten einmalig. Benutzer wählen anschließend den Billnado-Agenten in Microsoft 365 Copilot aus und melden sich mit ihrem eigenen Billnado-Konto an.

Voraussetzungen

• Eine Microsoft 365-Umgebung mit Copilot-Zugriff und der Berechtigung zum Hochladen benutzerdefinierter Apps.
• Visual Studio Code mit Microsoft 365 Agents Toolkit 6.12.0 oder neuer.
• Ein Konto, das den Agenten im Microsoft 365-Tenant bereitstellen oder per Sideloading laden darf.

Bitten Sie einen Microsoft 365-Administrator, die Tenant-Einstellungen zu prüfen, wenn Custom App Upload Enabled oder Copilot Access Enabled nicht verfügbar ist.

Deklarativen Agenten erstellen

1. Öffnen Sie Microsoft 365 Agents Toolkit in Visual Studio Code.
2. Wählen Sie Create a New Agent/App.
3. Wählen Sie Declarative Agent.
4. Wählen Sie Add an Action und anschließend Start with an MCP Server.
5. Geben Sie https://mcp.billnado.be/mcp als MCP-Server-URL ein.
6. Wählen Sie OAuth (with dynamic registration) als Authentifizierungstyp.
7. Wählen Sie einen Speicherort und geben Sie dem Agenten einen eindeutigen Namen, zum Beispiel Billnado.

Billnado unterstützt OAuth Dynamic Client Registration. Sie müssen daher keine separate Client-ID und kein Client Secret erstellen. Das Toolkit erzeugt die Plugin-Konfiguration und erkennt die verfügbaren Billnado-Tools dynamisch.

Agenten bereitstellen und verwenden

1. Melden Sie sich im Agents Toolkit bei Microsoft 365 an.
2. Öffnen Sie Lifecycle und wählen Sie Provision.
3. Bestätigen Sie die Bereitstellung und warten Sie, bis das Toolkit fertig ist.
4. Öffnen Sie Microsoft 365 Copilot Chat.
5. Wählen Sie unter Agents den neuen Billnado-Agenten aus. Während der Entwicklung endet sein Name üblicherweise mit dev.
6. Stellen Sie eine Frage zu Billnado und wählen Sie bei der entsprechenden Aufforderung Sign in to Billnado.
7. Schließen Sie die OAuth-Anmeldung mit Ihrem Billnado-Konto ab.

Für eine organisationsweite Einführung muss der Administrator den Agenten gemäß den Microsoft 365-Richtlinien der Organisation veröffentlichen und den entsprechenden Benutzern oder Gruppen zuweisen.

Verwaltungen und Zugriffskontrolle

Jeder Benutzer meldet sich einzeln an. Billnado wendet dieselbe Zugriffskontrolle wie in der normalen Anwendung an und verwendet die Standardverwaltung des jeweiligen Benutzers.

Lassen Sie Copilot zuerst subscribers_list verwenden, wenn mehrere Verwaltungen möglich sind. subscriber_connect darf nur verwendet werden, nachdem der Benutzer ausdrücklich die Verbindung zur ausgewählten Verwaltung verlangt hat. Da ein MCP-Tool den Transportheader von Copilot nicht ändern kann, bleibt die Standardverwaltung die zuverlässigste Wahl, wenn der Agent keinen dynamischen SubscriberId-Header unterstützt.

Verbindung prüfen

Fragen Sie den Billnado-Agenten beispielsweise:

• „Auf welche Verwaltungen kann ich zugreifen?“
• „Zeigen Sie die aktive Lizenz und die Nutzungslimits.“
• „Suchen Sie den Lieferanten Acme und zeigen Sie die Kontaktdaten.“

Nach einer Aktualisierung

Microsoft 365 Copilot kann einen Snapshot der MCP-Tools speichern. Aktualisieren Sie bei Änderungen auch den deklarativen Agenten und diese Dokumentation, veröffentlichen Sie den Agenten erneut und starten Sie bei Bedarf ein neues Gespräch.

Lesen Sie Billnado über MCP verwenden für alle Tools und Sicherheitsrichtlinien. Weitere Informationen zu Tenant-Anforderungen, Bereitstellung und Veröffentlichung finden Sie in der offiziellen Microsoft-Anleitung zum Erstellen eines MCP-Plugins für einen deklarativen Agenten.