alrm-mcp

MCP-Server für AL ID Range Manager.

Ermöglicht einem KI-Codierungsagenten, AL-Objekt-IDs auf die gleiche Weise zu reservieren wie die ALRM VS Code-Erweiterung. Wenn der Agent ein neues AL-Objekt erstellen möchte, ruft er new_object auf, und die gemeinsame ALRM-Datenbank in Business Central validiert den Namen und gibt die nächste freie Objekt-ID zurück – so bleiben IDs über alle hinweg eindeutig, die an derselben Erweiterung arbeiten.

Werkzeuge

new_object

Registriert ein neues AL-Objekt und gibt die zugewiesene ID zurück.

Gibt die Objekt-ID als Text zurück, z. B. 50061. Ein erneuter Aufruf mit demselben Namen gibt dieselbe ID zurück, anstatt eine neue zu vergeben.

Related MCP server: Dynamics 365 Business Central Admin MCP Server

Voraussetzungen

• Node.js 20 oder neuer

• Eine Business Central-Umgebung mit installierter ALRM-Erweiterung

• Berechtigung zur Anmeldung in dieser Umgebung (siehe Authentifizierung)

Konfiguration

{
  "mcpServers": {
    "alrm-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "alrm-mcp@latest"],
      "env": {
        "BC_TENANT": "{tenant}",
        "BC_ENVIRONMENT": "{environment}",
        "BC_COMPANY": "{company}"
      }
    }
  }
}

Für Claude Code können Sie es mit einem Befehl hinzufügen:

claude mcp add alrm-mcp \
  --env BC_TENANT=contoso.com \
  --env BC_ENVIRONMENT=Production \
  --env BC_COMPANY=00000000-0000-0000-0000-000000000000 \
  -- npx -y alrm-mcp@latest

Umgebungsvariablen

Alle drei sind erforderlich – der Server beendet sich sofort mit einer Meldung, die angibt, welche fehlt.

Diese werden nur aus dem env-Block des MCP-Clients gelesen – es gibt keine Unterstützung für .env-Dateien, da der Server normalerweise vom Client und nicht aus einer Shell gestartet wird.

Zwei optionale Variablen ermöglichen es Ihnen, den Server auf Ihre eigene Entra-App-Registrierung zu verweisen, anstatt auf den standardmäßigen öffentlichen Client:

Authentifizierung

Der erste Tool-Aufruf meldet Sie über den OAuth 2.0-Gerätecode-Flow an:

1. Ein Browser-Tab öffnet sich unter https://microsoft.com/devicelogin.

2. Der Gerätecode wird in Ihre Zwischenablage kopiert und auch auf stderr des Servers ausgegeben, falls die Zwischenablage oder der Browser nicht verfügbar ist.

3. Fügen Sie den Code ein, schließen Sie die Anmeldung ab, und der Tool-Aufruf wird fortgesetzt.

Danach wird der Token-Cache im Anmeldeinformationsspeicher Ihres Betriebssystems gespeichert – Keychain unter macOS, DPAPI unter Windows, Secret Service/libsecret unter Linux – mit einer kleinen Indexdatei unter .alrm-cache.json in Ihrem Home-Verzeichnis. Spätere Sitzungen verwenden ihn stillschweigend wieder, auch über Neustarts des Servers und Ihres Editors hinweg, sodass Sie den Browser erst wieder sehen sollten, wenn das Aktualisierungstoken abläuft (etwa 90 Tage Inaktivität).

Zum Abmelden löschen Sie .alrm-cache.json und entfernen den Eintrag alrm-mcp aus Ihrem Anmeldeinformationsspeicher. Unter macOS:

rm ~/.alrm-cache.json
security delete-generic-password -s alrm-mcp -a alrm-mcp

Es gibt noch keinen logout-Befehl.

Hinweise zu Plattformen

Unter Linux weigert sich der Server, Token im Klartext zu speichern. Auf einem headless Rechner ohne verfügbaren Secret Service schlägt die Anmeldung fehl, anstatt stillschweigend einen unverschlüsselten Token-Cache zu schreiben.

Fehlerbehebung

Der Server startet nicht / der Client meldet CONNECTION_CLOSED. Fast immer eine fehlende oder falsch geschriebene Umgebungsvariable. Führen Sie ihn direkt aus, um den tatsächlichen Fehler zu sehen, den der MCP-Client verschluckt:

BC_TENANT=contoso.com BC_ENVIRONMENT=Production BC_COMPANY=... npx -y alrm-mcp@latest

Ein gesunder Server gibt MCP server running on stdio aus und wartet.

Extension {id} not found! Die appId aus Ihrer app.json wurde nicht in der ALRM-Datenbank für dieses Unternehmen registriert. Registrieren Sie die Erweiterung zuerst, entweder mit der VS Code-Erweiterung oder direkt in Business Central.

Ein Browser hat sich unerwartet geöffnet. Das ist die oben beschriebene Anmeldung. Sie sollte einmal passieren, nicht bei jedem Aufruf – wenn sie sich wiederholt, wird der Token-Cache nicht gespeichert; überprüfen Sie die stderr-Ausgabe auf eine Meldung über die Wiederverwendung der gespeicherten Anmeldung.

Entwicklung

git clone https://github.com/hiimnit/alrm-mcp.git
cd alrm-mcp
npm install
npm run build

Richten Sie dann Ihren MCP-Client auf den lokalen Build anstelle des veröffentlichten Pakets aus:

{
  "mcpServers": {
    "alrm-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/alrm-mcp/dist/index.js"],
      "env": {
        "BC_TENANT": "...",
        "BC_ENVIRONMENT": "...",
        "BC_COMPANY": "..."
      }
    }
  }
}

npm run typecheck prüft Typen ohne Ausgabe. npm run build bereinigt zuerst dist/ und läuft auch automatisch bei npm pack und npm publish.