Aller au contenu principal

🔌 Intégration MCP : GitHub Copilot & Claude Desktop

Qu'est-ce que l'intégration MCP ?​

MCP (Model Context Protocol) est un protocole ouvert qui permet aux assistants IA comme GitHub Copilot ou Claude Desktop de se connecter à des sources de connaissances externes.

Avec l'intégration MCP, vous pouvez :

  • ✅ Utiliser Alex directement dans VS Code (via GitHub Copilot)
  • ✅ Utiliser Alex directement dans Claude Desktop
  • ✅ Accéder aux connaissances Business Central AL sans quitter votre éditeur
  • ✅ Comparer des versions de Business Central (BC 26 vs 27, etc.)
Pourquoi utiliser MCP ?

Au lieu de basculer entre VS Code et l'interface web Alex, vous posez vos questions directement dans votre éditeur de code ou dans Claude Desktop. Alex répond instantanément avec des informations précises sur Business Central AL.

Assistants compatibles​

GitHub Copilot (VS Code)​

GitHub Copilot est l'assistant IA intégré à Visual Studio Code. Avec l'intégration MCP :

  • Ouvrez Copilot Chat dans VS Code
  • Utilisez les outils Alex : #mcp_alex_alex_al_query ou #mcp_alex_alex_al_comparison
  • Posez vos questions sur Business Central AL
  • Alex répond directement dans le chat

Exemple :

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

Claude Desktop​

Claude Desktop est l'application desktop de Claude AI. Avec l'intégration MCP :

  • Ouvrez Claude Desktop
  • Autorisez les outils Alex (voir section "Utilisation" ci-dessous)
  • Posez vos questions normalement dans la conversation
  • Claude utilise automatiquement Alex pour répondre aux questions Business Central

Exemple :

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

Installation​

Prérequis​

  • Node.js 18 ou supérieur installé sur votre ordinateur
  • Un compte Alex actif avec des crédits disponibles
  • GitHub Copilot (VS Code) ou Claude Desktop installé

Installation automatique (recommandée)​

Windows (PowerShell)​

  1. Clonez le dépôt (https://github.com/pmoisontech/Alex-MCP-Proxy) ou téléchargez le code :

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

  2. Lancez l'installateur :

    .\install-mcp.ps1

  3. Suivez les instructions :

    • Entrez l'URL du backend Alex (par défaut : https://alex.app.pmats.ai/api)
    • Entrez votre nom d'utilisateur Alex
    • Entrez votre mot de passe Alex
    • Choisissez VS Code et/ou Claude Desktop

  4. Redémarrez votre assistant :

    • VS Code : Fermez et relancez VS Code complètement
    • Claude Desktop : Fermez toutes les fenêtres et relancez Claude

Linux / macOS / WSL​

  1. Clonez le dépôt (https://github.com/pmoisontech/Alex-MCP-Proxy) ou téléchargez le code :

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

  2. Lancez l'installateur :

    ./install-mcp.sh

  3. Suivez les instructions :

    • Entrez l'URL du backend Alex (par défaut : https://alex.app.pmats.ai/api)
    • Entrez votre nom d'utilisateur Alex
    • Entrez votre mot de passe Alex
    • Choisissez VS Code et/ou Claude Desktop

  4. Redémarrez votre assistant :

    • VS Code : Fermez et relancez VS Code complètement
    • Claude Desktop : Fermez toutes les fenêtres et relancez Claude
Génération de clé API

L'installateur créera automatiquement une clé API pour votre compte Alex. Cette clé est valide 3 mois par défaut et permet au proxy MCP de s'authentifier auprès d'Alex.

Installation manuelle​

Si vous préférez configurer manuellement, consultez le README du proxy MCP pour les instructions détaillées.

Utilisation​

Avec GitHub Copilot (VS Code)​

  1. Ouvrez VS Code et démarrez un projet AL
  2. Ouvrez Copilot Chat (icône chat dans la barre latérale)
  3. Utilisez les outils Alex :

Pour des questions générales sur AL :

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

Pour comparer des versions :

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

Tapez #mcp pour voir tous les outils MCP disponibles. Sélectionnez #mcp_alex_alex_al_query ou #mcp_alex_alex_al_comparison dans la liste.

Avec Claude Desktop​

  1. Ouvrez Claude Desktop
  2. Ouvrez Settings → All connectors
  3. Trouvez "alex" avec 2 outils (alex_al_query, alex_al_comparison)
  4. Autorisez les outils :
    • Cliquez sur le dropdown "Blocked"
    • Sélectionnez "Always allow"
    • Les deux outils doivent afficher ✅ (autorisé)
  5. Posez vos questions normalement dans la conversation

Claude détectera automatiquement quand utiliser Alex pour répondre aux questions Business Central.

Exemples de questions :

  • "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"

Outils disponibles​

alex_al_query​

✅ Outil par défaut pour toutes les questions sur Business Central AL (sauf comparaisons de versions).

Utilisations :

  • Informations sur la syntaxe AL, objets, patterns
  • Dépannage de code AL
  • Meilleures pratiques Business Central
  • Exemples de code pour des fonctionnalités spécifiques
  • Structure des tables, pages, codeunits

Exemples :

  • "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​

⚠️ Utiliser UNIQUEMENT pour comparer des versions de Business Central (BC 26 vs 27, etc.).

Utilisations :

  • Comparer le code AL entre deux versions BC
  • Identifier les changements majeurs (breaking changes)
  • Découvrir les nouvelles fonctionnalités d'une version
  • Suivre les objets AL dépréciés ou obsolètes
  • Analyser les changements d'API entre versions

Exemples :

  • "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?"

Versions supportées : BC 14 à 28 et versions ultérieures. Format :

  • Version majeure : "BC 26" (utilise la dernière version mineure disponible)
  • Version complète : "BC 26.5" ou "BC 26.5.0.0"

Mise à jour du proxy​

Si le proxy MCP a été mis à jour (nouvelles fonctionnalités, corrections de bugs) :

  1. Mettez à jour le code :

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

  2. Redémarrez votre assistant :

    • VS Code : Fermez et relancez complètement
    • Claude Desktop : Fermez toutes les fenêtres et relancez
Changements majeurs

En cas de mise à jour majeure avec changements de configuration, relancez l'installateur (./install-mcp.sh ou .\install-mcp.ps1). Vos paramètres existants (clé API, etc.) seront préservés.

Dépannage​

Alex n'apparaît pas dans GitHub Copilot​

Solutions :

  1. Vérifiez que le fichier mcp.json est au bon emplacement :
    • Windows : %APPDATA%\Code\User\mcp.json
    • Linux/macOS : ~/.config/Code/User/mcp.json
  2. Vérifiez que le chemin vers mcp-proxy-client.js est absolu (pas relatif)
  3. Redémarrez VS Code complètement
  4. Vérifiez que votre clé API est correcte dans le fichier

Alex n'apparaît pas dans Claude Desktop​

Solutions :

  1. Vérifiez le fichier de configuration :
    • Windows : %APPDATA%\Claude\claude_desktop_config.json
    • Linux/macOS : ~/.config/Claude/claude_desktop_config.json
  2. Fermez toutes les fenêtres Claude Desktop et relancez
  3. Vérifiez l'icône connecteurs en bas à droite de Claude
  4. Consultez les logs : %APPDATA%\Claude\logs\ (Windows)

Outils bloqués dans Claude Desktop​

Les outils Alex apparaissent mais sont marqués "Blocked" (🚫) :

Solution :

  1. Ouvrez Settings → All connectors
  2. Trouvez "alex" dans la liste
  3. Cliquez sur le dropdown "Blocked"
  4. Sélectionnez "Always allow"
  5. Les outils doivent maintenant afficher ✅

Erreur "401 Unauthorized"​

Votre clé API est invalide ou expirée.

Solution :

  1. Connectez-vous à l'interface web Alex
  2. Allez dans Paramètres → Clés API
  3. Créez une nouvelle clé API
  4. Remplacez la clé dans votre fichier de configuration (variable ALEX_API_KEY)

Alex ne répond pas​

Solutions :

  1. Vérifiez votre connexion internet
  2. Vérifiez que l'URL du backend est https://alex.app.pmats.ai/api
  3. Vérifiez que vous avez des crédits disponibles sur votre compte Alex
  4. Attendez quelques secondes (la première réponse peut prendre un moment)

Sécurité et confidentialité​

  • Votre clé API est personnelle et confidentielle - ne la partagez jamais
  • La connexion au backend Alex utilise HTTPS (chiffré)
  • Vos questions et le code ne sont pas stockés de façon permanente
  • Chaque utilisateur a un compte isolé
Partage de clé API

Ne partagez JAMAIS votre clé API. Si vous pensez qu'elle a été compromise, révoquez-la immédiatement dans vos paramètres et créez-en une nouvelle.

Support​

Si vous rencontrez un problème non couvert dans cette documentation :

  1. Vérifiez que Node.js est installé (node --version doit afficher ≥18)
  2. Vérifiez que vos fichiers de configuration sont du JSON valide
  3. Essayez l'installateur automatique si vous avez configuré manuellement
  4. Consultez les issues GitHub
  5. Contactez le support avec une description précise de l'erreur

En savoir plus​