ERP
Business Central
Kunden, Artikel, Aufträge und Rechnungen aus Microsoft Dynamics 365 Business Central (nur lesend).
- Zugang mit Verbinden (OAuth)
- Nur Lesen
Tools für den Agenten
Der Agent wählt selbst das passende Tool für die Frage. Im Tab MCP und Datenbanken des Agenten können Sie nicht benötigte Tools deaktivieren.
| Tool | Funktion | Typ |
|---|---|---|
list_companies | Unternehmen der Business-Central-Umgebung. | Lesen |
query | Liest eine Entität einer Gesellschaft mit OData-Filter; gibt eine Tabelle zurück (Diagramme und Export). | Lesen |
Einrichtung Schritt für Schritt
Öffnen Sie in Kaiross Integrationen, wählen Sie Business Central und klicken Sie auf Neue Verbindung. Das Formular zeigt denselben Leitfaden unter Leitfaden und empfohlene Berechtigungen.
- entra.microsoft.com → App registrations → New registration (Single-Tenant), Redirect URI Web = der unten angezeigte.
- API permissions → Dynamics 365 Business Central → Delegated → user_impersonation (plus openid, email, offline_access).
- Certificates & secrets → New client secret; geben Sie Tenant, Umgebung (z. B. production), Client ID und secret ein, dann Verbinden.
Felder des Formulars: Directory (tenant) ID oder Domain, Umgebung, Application (client) ID.
Einzufügen (im Vault verschlüsselt, danach nicht mehr sichtbar): Client secret.
Zugang mit «Verbinden» (OAuth)
- Kopieren Sie im Formular der Verbindung den Wert Rücksprungadresse (Redirect URI), die in der OAuth-App registriert werden muss (Symbol Rücksprungadresse kopieren).
- Registrieren Sie die OAuth-App beim Anbieter (Schritte oben) und fügen Sie diese Redirect URI ein.
- Geben Sie in Kaiross Client ID und Client secret ein und klicken Sie auf Speichern und verbinden: Das Fenster des Anbieters öffnet sich, melden Sie sich mit dem gewünschten Konto an und erteilen Sie die Berechtigung.
- Meldet der Test später «Zugang abgelaufen», klicken Sie in der Verbindung auf Neu verbinden.
Erforderliche Berechtigungen (Scopes)
Kaiross verlangt beim Anbieter nur diese Berechtigungen; Schreibaktionen bleiben deaktiviert, bis Sie sie einschalten.
https://api.businesscentral.dynamics.com/user_impersonation
Mit einem Agenten verbinden
- Öffnen Sie Agenten, wählen Sie den Agenten und gehen Sie zum Tab MCP und Datenbanken.
- Wählen Sie unter Hinzufügen die Option Bestehende Integration verbinden und die Verbindung, oder Aus dem Katalog für eine neue (die Schaltfläche heisst dann Speichern und verknüpfen).
- Prüfen Sie unter Aktivierte Tools die aktiven Tools und unter Aktionsbestätigung, welche Aktionen eine Bestätigung verlangen.
- Klicken Sie auf Im Chat testen und stellen Sie eine Frage, die Daten aus dem Dienst braucht.
Häufige Fehler
- Konto nicht verbunden oder Zugang abgelaufen
- Die OAuth-Verbindung wurde nie abgeschlossen oder ist nicht mehr gültig: Klicken Sie in der Verbindung auf Verbinden oder Neu verbinden.
- Unzureichende Berechtigungen
- Dem Konto fehlen Scopes: Vergleichen Sie sie mit der Liste oben. Prüfen Sie bei Microsoft 365 auch die Administratorzustimmung.
- Zu viele Anfragen
- Der Dienst begrenzt die Anzahl der Aufrufe: Versuchen Sie es in ein paar Minuten erneut.
Nützliche Links
In den Schritten genannte Konsolen des Anbieters: