Zum Hauptinhalt springen

🔌 MCP-Integration: GitHub Copilot & Claude Desktop

Was ist MCP-Integration?​

MCP (Model Context Protocol) ist ein offenes Protokoll, das KI-Assistenten wie GitHub Copilot oder Claude Desktop ermöglicht, sich mit externen Wissensquellen zu verbinden.

Mit der MCP-Integration können Sie:

  • ✅ Alex direkt in VS Code verwenden (über GitHub Copilot)
  • ✅ Alex direkt in Claude Desktop verwenden
  • ✅ Auf Business Central AL-Wissen zugreifen, ohne Ihren Editor zu verlassen
  • ✅ Business Central-Versionen vergleichen (BC 26 vs 27, usw.)
Warum MCP verwenden?

Anstatt zwischen VS Code und der Alex-Web-Oberfläche zu wechseln, stellen Sie Ihre Fragen direkt in Ihrem Code-Editor oder in Claude Desktop. Alex antwortet sofort mit präzisen Informationen zu Business Central AL.

Kompatible Assistenten​

GitHub Copilot (VS Code)​

GitHub Copilot ist der in Visual Studio Code integrierte KI-Assistent. Mit MCP-Integration:

  • Öffnen Sie Copilot Chat in VS Code
  • Verwenden Sie Alex-Tools: #mcp_alex_alex_al_query oder #mcp_alex_alex_al_comparison
  • Stellen Sie Ihre Fragen zu Business Central AL
  • Alex antwortet direkt im Chat

Beispiel:

Use #mcp_alex_alex_al_query to ask: How do I create a table extension in AL?

Claude Desktop​

Claude Desktop ist die Desktop-Anwendung von Claude AI. Mit MCP-Integration:

  • Öffnen Sie Claude Desktop
  • Autorisieren Sie Alex-Tools (siehe Abschnitt "Verwendung" unten)
  • Stellen Sie Ihre Fragen normal in der Konversation
  • Claude verwendet automatisch Alex, um Business Central-Fragen zu beantworten

Beispiel:

Explain the differences in table Customer between BC versions 26 and 27

Installation​

Voraussetzungen​

  • Node.js 18 oder höher auf Ihrem Computer installiert
  • Ein aktives Alex-Konto mit verfügbaren Credits
  • GitHub Copilot (VS Code) oder Claude Desktop installiert

Automatische Installation (Empfohlen)​

Windows (PowerShell)​

  1. Repository klonen (https://github.com/pmoisontech/Alex-MCP-Proxy) oder Code herunterladen:

    git clone https://github.com/pmoisontech/Alex-MCP-Proxy.git
    cd Alex-MCP-Proxy/mcp-server-proxy

  2. Installer ausführen:

    .\install-mcp.ps1

  3. Anweisungen folgen:

    • Alex-Backend-URL eingeben (Standard: https://alex.app.pmats.ai/api)
    • Alex-Benutzername eingeben
    • Alex-Passwort eingeben
    • VS Code und/oder Claude Desktop wählen

  4. Assistent neu starten:

    • VS Code: VS Code vollständig schließen und neu starten
    • Claude Desktop: Alle Fenster schließen und Claude neu starten

Linux / macOS / WSL​

  1. Repository klonen (https://github.com/pmoisontech/Alex-MCP-Proxy) oder Code herunterladen:

    git clone https://github.com/pmoisontech/Alex-MCP-Proxy.git
    cd Alex-MCP-Proxy/mcp-server-proxy

  2. Installer ausführen:

    ./install-mcp.sh

  3. Anweisungen folgen:

    • Alex-Backend-URL eingeben (Standard: https://alex.app.pmats.ai/api)
    • Alex-Benutzername eingeben
    • Alex-Passwort eingeben
    • VS Code und/oder Claude Desktop wählen

  4. Assistent neu starten:

    • VS Code: VS Code vollständig schließen und neu starten
    • Claude Desktop: Alle Fenster schließen und Claude neu starten
API-Schlüssel-Generierung

Der Installer erstellt automatisch einen API-Schlüssel für Ihr Alex-Konto. Dieser Schlüssel ist standardmäßig 3 Monate gültig und ermöglicht dem MCP-Proxy die Authentifizierung bei Alex.

Manuelle Installation​

Wenn Sie manuell konfigurieren möchten, konsultieren Sie die MCP-Proxy-README für detaillierte Anweisungen.

Verwendung​

Mit GitHub Copilot (VS Code)​

  1. VS Code öffnen und ein AL-Projekt starten
  2. Copilot Chat öffnen (Chat-Symbol in der Seitenleiste)
  3. Alex-Tools verwenden:

Für allgemeine AL-Fragen:

Use #mcp_alex_alex_al_query to ask: How does the Customer table work in Business Central?

Zum Vergleichen von Versionen:

Use #mcp_alex_alex_al_comparison to ask: What changed in table Sales Header between BC 26 and BC 27?
Tastenkombination

Geben Sie #mcp ein, um alle verfügbaren MCP-Tools zu sehen. Wählen Sie #mcp_alex_alex_al_query oder #mcp_alex_alex_al_comparison aus der Liste.

Mit Claude Desktop​

  1. Claude Desktop öffnen
  2. Settings → All connectors öffnen
  3. "alex" finden mit 2 Tools (alex_al_query, alex_al_comparison)
  4. Tools autorisieren:
    • Auf das "Blocked"-Dropdown klicken
    • "Always allow" auswählen
    • Beide Tools sollten ✅ anzeigen (autorisiert)
  5. Fragen stellen normal in der Konversation

Claude erkennt automatisch, wann Alex verwendet werden soll, um Business Central-Fragen zu beantworten.

Beispielfragen:

  • "How do I create a table extension in AL?"
  • "Show me an example of a codeunit that posts a sales order"
  • "What's new in the Sales Order page in BC 27?"
  • "Compare the Item table between versions 26 and 27"

Verfügbare Tools​

alex_al_query​

✅ Standard-Tool für alle Business Central AL-Fragen (außer Versionsvergleiche).

Verwendungszwecke:

  • Informationen zu AL-Syntax, Objekten, Mustern
  • AL-Code-Fehlerbehebung
  • Business Central Best Practices
  • Codebeispiele für spezifische Funktionen
  • Struktur von Tabellen, Seiten, Codeunits

Beispiele:

  • "How do I create a table extension in AL?"
  • "What's the syntax for posting a sales order in AL?"
  • "Show me examples of using RecordRef in Business Central"
  • "How to implement OnValidate trigger in AL?"

alex_al_comparison​

⚠️ NUR verwenden zum Vergleichen von Business Central-Versionen (BC 26 vs 27, usw.).

Verwendungszwecke:

  • AL-Code zwischen zwei BC-Versionen vergleichen
  • Breaking Changes identifizieren
  • Neue Funktionen in einer Version entdecken
  • Veraltete oder obsolete AL-Objekte verfolgen
  • API-Änderungen zwischen Versionen analysieren

Beispiele:

  • "What changed in the Sales Header table between BC 26 and BC 27?"
  • "Compare the Item table between version 25 and 26"
  • "Show me breaking changes in Codeunit 80 from BC 24 to BC 25"
  • "What's new in the Sales Invoice page between version 26 and 27?"

Unterstützte Versionen: BC 14 bis 28 und später. Format:

  • Hauptversion: "BC 26" (verwendet die neueste verfügbare Nebenversion)
  • Vollständige Version: "BC 26.5" oder "BC 26.5.0.0"

Proxy aktualisieren​

Wenn der MCP-Proxy aktualisiert wurde (neue Funktionen, Bugfixes):

  1. Code aktualisieren:

    cd Alex-MCP-Proxy/mcp-server-proxy
    git pull origin main
    npm install

  2. Assistent neu starten:

    • VS Code: Vollständig schließen und neu starten
    • Claude Desktop: Alle Fenster schließen und neu starten
Größere Änderungen

Bei größeren Updates mit Konfigurationsänderungen führen Sie den Installer erneut aus (./install-mcp.sh oder .\install-mcp.ps1). Ihre vorhandenen Einstellungen (API-Schlüssel usw.) bleiben erhalten.

Fehlerbehebung​

Alex erscheint nicht in GitHub Copilot​

Lösungen:

  1. Überprüfen Sie, ob die mcp.json-Datei am richtigen Ort ist:
    • Windows: %APPDATA%\Code\User\mcp.json
    • Linux/macOS: ~/.config/Code/User/mcp.json
  2. Überprüfen Sie, ob der Pfad zu mcp-proxy-client.js absolut ist (nicht relativ)
  3. VS Code vollständig neu starten
  4. Überprüfen Sie, ob Ihr API-Schlüssel in der Datei korrekt ist

Alex erscheint nicht in Claude Desktop​

Lösungen:

  1. Überprüfen Sie die Konfigurationsdatei:
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux/macOS: ~/.config/Claude/claude_desktop_config.json
  2. Alle Fenster von Claude Desktop schließen und neu starten
  3. Überprüfen Sie das Connectors-Symbol unten rechts in Claude
  4. Logs konsultieren: %APPDATA%\Claude\logs\ (Windows)

Tools in Claude Desktop blockiert​

Alex-Tools erscheinen, sind aber als "Blocked" markiert (🚫):

Lösung:

  1. Settings → All connectors öffnen
  2. "alex" in der Liste finden
  3. Auf das "Blocked"-Dropdown klicken
  4. "Always allow" auswählen
  5. Tools sollten jetzt ✅ anzeigen

Fehler "401 Unauthorized"​

Ihr API-Schlüssel ist ungültig oder abgelaufen.

Lösung:

  1. Bei der Alex-Web-Oberfläche anmelden
  2. Zu Einstellungen → API-Schlüssel gehen
  3. Neuen API-Schlüssel erstellen
  4. Schlüssel in Ihrer Konfigurationsdatei ersetzen (ALEX_API_KEY-Variable)

Alex antwortet nicht​

Lösungen:

  1. Internetverbindung überprüfen
  2. Überprüfen Sie, ob die Backend-URL https://alex.app.pmats.ai/api ist
  3. Überprüfen Sie, ob Sie verfügbare Credits auf Ihrem Alex-Konto haben
  4. Warten Sie einige Sekunden (die erste Antwort kann etwas dauern)

Sicherheit und Datenschutz​

  • Ihr API-Schlüssel ist persönlich und vertraulich - teilen Sie ihn niemals
  • Die Verbindung zum Alex-Backend verwendet HTTPS (verschlüsselt)
  • Ihre Fragen und Ihr Code werden nicht dauerhaft gespeichert
  • Jeder Benutzer hat ein isoliertes Konto
API-Schlüssel-Weitergabe

NIEMALS Ihren API-Schlüssel weitergeben. Wenn Sie denken, dass er kompromittiert wurde, widerrufen Sie ihn sofort in Ihren Einstellungen und erstellen Sie einen neuen.

Support​

Wenn Sie auf ein Problem stoßen, das in dieser Dokumentation nicht behandelt wird:

  1. Überprüfen Sie, ob Node.js installiert ist (node --version sollte ≥18 anzeigen)
  2. Überprüfen Sie, ob Ihre Konfigurationsdateien gültiges JSON sind
  3. Versuchen Sie den automatischen Installer, wenn Sie manuell konfiguriert haben
  4. Konsultieren Sie GitHub Issues
  5. Kontaktieren Sie den Support mit einer genauen Fehlerbeschreibung

Weitere Informationen​