Zum Hauptinhalt springen

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 kannClaude kann nicht
Die Flows eines Mandanten auflisten und nach Code, Name, Status oder Ordner filternEinen Flow veröffentlichen oder die Veröffentlichung zurücknehmen
Jede Version eines Flows exportieren – dieselbe Datei wie bei Aktuelle Version exportierenEinen Flow oder eine Version löschen
Einen geänderten oder neuen Flow importierenAutoFlow-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 Production oder Sandbox) 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.

Du nutzt schon die Azure CLI?

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.py den 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​

MeldungWas du tun kannst
HTTP 403 … needs the AutoFlow permission setDeinem Benutzer fehlt mse365 AF ALL in diesem Mandanten. Bitte deinen AutoFlow-Administrator, ihn zuzuweisen.
HTTP 401Die 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 AufrufPrü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 sperrtManche 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.

AufrufWas er tut
GET flowsListet 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.