Claude Code Zugriff auf deine Flows geben
Mit der AutoFlow-Flow-API arbeitet ein Coding-Agent wie Claude Code direkt in Business Central an deinen Flows: Er sucht einen Flow, exportiert ihn, ändert ihn und importiert das Ergebnis. Dateien musst du dafür nicht mehr selbst herunter- und wieder hochladen.
Claude arbeitet dabei als du. Er meldet sich mit deinem Business-Central-Konto an und darf genau das, was deine AutoFlow-Rolle erlaubt – mehr nicht. Jede Änderung taucht in der Versionshistorie des Flows unter deinem Namen auf.
Was Claude kann und was nicht
| Claude kann | Claude kann nicht |
|---|---|
| Die Flows eines Mandanten auflisten und nach Code, Name, Status oder Ordner filtern | Einen Flow veröffentlichen oder die Veröffentlichung zurücknehmen |
| Jede Version eines Flows exportieren – dieselbe Datei wie bei Aktuelle Version exportieren | Einen Flow oder eine Version löschen |
| Einen geänderten oder neuen Flow importieren | AutoFlow-Einrichtung, Anmeldedaten oder Lizenz ändern |
Ein Import kommt immer als Entwurf an, genau wie bei Aus Datei erstellen. Gehört der Code der Datei zu einem vorhandenen Flow, wird der Import zur nächsten Entwurfsversion dieses Flows. Ein offener Entwurf bleibt dabei in der Versionshistorie erhalten. Sonst entsteht ein neuer Flow. Die veröffentlichte Version läuft weiter, bis du dir den Entwurf im Flow-Editor angesehen und selbst Änderungen veröffentlichen gewählt hast.
Nach jedem Import führt AutoFlow dieselben Prüfungen aus wie Änderungen veröffentlichen und sagt Claude, was das Veröffentlichen aufhalten oder eine Warnung auslösen würde. So kann Claude diese Punkte beheben, bevor du den Flow überhaupt öffnest.
Was du brauchst
- Einen Business-Central-Benutzer mit dem AutoFlow-Berechtigungssatz mse365 AF ALL (AutoFlow-Benutzer) oder mse365 AF ADMIN in dem Mandanten, in dem du arbeiten willst. Siehe Installation.
- Den Namen deiner Business-Central-Umgebung (zum Beispiel
ProductionoderSandbox) und des Mandanten. - Python 3 auf deinem Rechner.
- Die AutoFlow-Agent-Docs. Darin steckt das Hilfsprogramm, mit dem Claude die API aufruft:
git clone https://github.com/mse365/autoflow-agent-docs.git
Eine App-Registrierung oder Hilfe von deiner IT brauchst du nicht.
Schritt 1 – Dem Hilfsprogramm sagen, wo es arbeiten soll
Setz zwei Umgebungsvariablen in dem Terminal, aus dem du Claude Code startest:
export AF_ENVIRONMENT="Production"
export AF_COMPANY="CRONUS AG"
In Windows PowerShell schreibst du $env:AF_ENVIRONMENT = "Production" und $env:AF_COMPANY = "CRONUS AG".
Beide Werte sind nicht geheim. Du kannst sie auch in die CLAUDE.md deines Projekts schreiben, dann kennt Claude sie in jeder Sitzung.
Schritt 2 – Anmelden
python3 autoflow-agent-docs/tools/af_api.py login
Das Hilfsprogramm zeigt einen Code und einen Link. Öffne den Link im Browser, gib den Code ein und melde dich mit dem Konto an, das du für Business Central verwendest – inklusive deiner üblichen Mehrfaktor-Anmeldung. Prüf dann, ob alles klappt:
python3 autoflow-agent-docs/tools/af_api.py list
Du siehst die Flows des Mandanten. Das Hilfsprogramm merkt sich deine Anmeldung auf diesem Rechner und erneuert sie im Hintergrund, sodass du dich meist nur einmal am Tag anmeldest. Mit af_api.py logout entfernst du die Anmeldung wieder.
Wenn du mit az login angemeldet bist, kannst du die Anmeldung des Hilfsprogramms überspringen und stattdessen ein Token übergeben:
export AF_TOKEN=$(az account get-access-token --resource https://api.businesscentral.dynamics.com --query accessToken -o tsv)
Schritt 3 – Claude beauftragen
Sag Claude, wo die Docs liegen und was du möchtest, zum Beispiel:
Lies autoflow-agent-docs/AGENTS.md. Exportiere dann mit
tools/af_api.pyden Flow ACME.INVOICE-MAIL, füge einen Schritt hinzu, der die Rechnung zusätzlich an den Verkäufer schickt, und importiere ihn wieder.
Claude exportiert den Flow, ändert ihn, prüft ihn mit dem Validator aus den Agent-Docs und importiert ihn. Das Hilfsprogramm zeigt, was der Import angelegt hat, zum Beispiel New draft of flow FL0012, draft version 1.4.3 (not published), und dazu eventuelle Probleme. Öffne den Flow in AutoFlow, sieh dir den Entwurf an und veröffentliche ihn, wenn er passt.
Gut zu wissen
- Probier es zuerst in einer Sandbox aus. Die API funktioniert in jeder Umgebung gleich – eine Sandbox-Kopie deines Mandanten ist der sicherste Ort, um sich damit vertraut zu machen.
- Importe sind Entwürfe, sonst nichts. Ein Fehler in einem Import erreicht nie einen laufenden Flow. Einen Entwurf, den du nicht willst, wirfst du mit Änderungen verwerfen auf der Flow-Karte weg – der Flow kehrt dann zu seiner veröffentlichten Version zurück.
- Claude kann jeden Flow des Mandanten lesen, auf den du ihn ansetzt, auch die Konfiguration der Schritte. Gespeicherte Geheimnisse von Anmeldedaten gehören nicht zum Flow und werden nie exportiert.
- Jemand anderes bearbeitet denselben Flow? Ein Import legt einen neuen Entwurf neben dessen Entwurf an, genau wie Aus Datei erstellen. Der andere Entwurf bleibt in der Versionshistorie erhalten.
Problembehandlung
| Meldung | Was du tun kannst |
|---|---|
HTTP 403 … needs the AutoFlow permission set | Deinem Benutzer fehlt mse365 AF ALL in diesem Mandanten. Bitte deinen AutoFlow-Administrator, ihn zuzuweisen. |
HTTP 401 | Die Anmeldung ist abgelaufen oder gehört zu einem anderen Tenant. Führ af_api.py login erneut aus. |
No company named … | Führ af_api.py companies aus und übernimm den Namen genau so in AF_COMPANY. |
HTTP 404 bei jedem Aufruf | Prüf AF_ENVIRONMENT. Den Umgebungsnamen siehst du in der Business-Central-URL hinter deinem Tenant. Prüf außerdem, ob dein AutoFlow aktuell ist: Die Flow-API braucht die aktuelle Version. |
| Die Anmeldeseite meldet, dass deine Organisation diese Anmeldemethode sperrt | Manche Organisationen sperren die Anmeldung mit Code. Bitte deine IT, sie für dich freizugeben, oder nutz das Azure-CLI-Token aus Schritt 2. |
Business Central On-Premises
On-Premises steht dieselbe API auf dem API-Endpunkt des Servers bereit. Mit AF_BASE_URL zeigst du dem Hilfsprogramm, wo, zum Beispiel https://bc.example.com:7048/BC/api. Nutzt dein Server die Anmeldung mit Benutzername und Passwort, setz zusätzlich AF_USERNAME und AF_PASSWORD. Nutzt er die Anmeldung über Microsoft Entra, übergib stattdessen ein Token in AF_TOKEN. Die Windows-Anmeldung unterstützt das Hilfsprogramm nicht.
Für Entwickler: die Endpunkte
Das Hilfsprogramm ist eine dünne Hülle um drei Business-Central-API-Endpunkte. Wenn du sie selbst aufrufen möchtest, liegen sie unter
https://api.businesscentral.dynamics.com/v2.0/<Umgebung>/api/mse365/autoflow/v1.0/companies(<Mandanten-ID>)/.
Ein Aufruf von …/api/mse365/autoflow/v1.0/companies liefert die Mandanten-IDs.
| Aufruf | Was er tut |
|---|---|
GET flows | Listet Flows auf. Jeder Flow hat publishedVersionId und draftVersionId (0, wenn es keine unveröffentlichten Änderungen gibt). Unterstützt $filter, zum Beispiel code eq 'ACME.INVOICE-MAIL'. |
GET flows(<id>)/flowVersions?$filter=versionId eq <n> | Eine Version. Ihr Feld definition enthält den exportierten Flow als JSON-String. |
POST flowImports mit {"definition": "<Flow-JSON als String>"} | Importiert einen Entwurf. Die Antwort enthält flowNumber, version, createdNewFlow und issues (ein JSON-Array als String). Eine Definition, die kein Flow ist, liefert HTTP 400 und ändert nichts. |
Zur Anmeldung dient ein delegiertes Token für https://api.businesscentral.dynamics.com – dieselbe Art Token, die das Hilfsprogramm bei deiner Anmeldung bekommt.