← Tous les articles

Connectez des clients d’IA à Sage 50

Le serveur MCP est une application enfant IIS optionnelle sous l’API REST. Il expose les mêmes opérations Sage 50 comme outils que Claude, Cursor ou Codex peuvent appeler. Vous configurez le client avec l’URL MCP et la clé API dans l’en-tête x-api-key.

Écran de fin d'installation montrant l'URL de l'API REST, l'URL MCP et un champ de clé API flouté avec un bouton Copier.
Après l'installation, copiez trois valeurs : l'URL de l'API REST, l'URL MCP et la clé API.

Installation optionnelle

Pendant l’installation, vous pouvez installer le MCP comme application enfant sous votre chemin REST sur le même serveur Sage 50. Si vous sautez le MCP, seule l’application REST est créée. Vous pouvez ajouter le MCP plus tard avec une mise à jour.

Quand le MCP est inclus, l’écran de fin affiche :

Valeur Exemple Utilisation
API REST http://localhost/Sage50RestApi/ Intégrations, Swagger, vos applications
MCP http://localhost/Sage50RestApi/ai/mcp Claude, Cursor, Codex et autres clients MCP
Clé API Copiée depuis le champ Envoyée en x-api-key pour REST et MCP

L’API REST et le MCP partagent la même liaison hôte sur IIS à côté de Sage 50, le MCP étant l’application enfant ai. Ils partagent la même clé API. Votre fichier compagnie reste sur le serveur.

L’URL MCP se termine par /mcp. Le chemin complet est {votre chemin REST}/ai/mcp (par exemple /Sage50RestApi/ai/mcp). C’est le point d’accès HTTP Streamable. Collez ce chemin complet dans le client AI, pas seulement la racine du site REST.

Ce que le serveur MCP peut faire

Les outils MCP encapsulent l’API REST. Un client d’IA peut lister et mettre à jour clients et fournisseurs, créer des ventes et achats, enregistrer paiements et encaissements, travailler avec les employés, les devises, le grand livre et les journaux, les stocks, les taxes et les paramètres de la compagnie. Les mêmes outils peuvent vérifier quand Sage a modifié pour la dernière fois chaque partie du fichier de compagnie (sage50_sync_get_table_status) et lister les factures de ventes ou d’achats changées depuis un moment donné. Voir détecter les changements pour une synchronisation incrémentale.

Une fois le client connecté, demandez au modèle en langage naturel, par exemple « liste les clients avec un solde » ou « crée une facture de vente pour le client 42 ».

Configurer le client MCP

Vous avez besoin de :

  1. L’URL MCP de l’installateur
  2. La clé API (utilisez Copier)
  3. Un client qui gère le MCP distant en HTTP : Cursor, Claude ou Codex

Chaque client envoie la clé à chaque requête :

x-api-key: YOUR_API_KEY

Remplacez l’URL d’exemple ci-dessous par la vôtre. L’installateur fournit des URL HTTP. Utilisez-les telles quelles si le client d’IA s’exécute sur le serveur Sage 50, ou votre URL HTTPS si vous avez ajouté des liaisons HTTPS.

Cursor

Ajoutez un serveur distant dans .cursor/mcp.json (projet) ou ~/.cursor/mcp.json (utilisateur). Réglages Cursor → Outils et MCP accepte le même JSON.

{
  "mcpServers": {
    "sage50": {
      "url": "https://sage50.company.local/Sage50RestApi/ai/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Redémarrez Cursor ou rechargez les serveurs MCP après l’enregistrement.

Claude

Claude Code (CLI) :

claude mcp add --transport http sage50 https://sage50.company.local/Sage50RestApi/ai/mcp --header "x-api-key: YOUR_API_KEY"

Ou un .mcp.json dans le projet (ou ~/.claude.json) :

{
  "mcpServers": {
    "sage50": {
      "type": "http",
      "url": "https://sage50.company.local/Sage50RestApi/ai/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop : ajoutez un connecteur personnalisé avec cette URL MCP. Si votre version Desktop n’envoie pas encore d’en-têtes HTTP personnalisés, utilisez Claude Code ou Cursor, ou un pont stdio mcp-remote qui transmet x-api-key.

Codex

Ajoutez une table dans ~/.codex/config.toml (ou .codex/config.toml du projet). Une clé url sélectionne le HTTP Streamable. Les en-têtes statiques vont dans http_headers :

[mcp_servers.sage50]
url = "https://sage50.company.local/Sage50RestApi/ai/mcp"
http_headers = { "x-api-key" = "YOUR_API_KEY" }

HTTP et HTTPS

L’installateur crée des points d’accès HTTP sur IIS, par exemple http://localhost/Sage50RestApi/ et http://localhost/Sage50RestApi/ai/mcp. Ces URL fonctionnent telles quelles sur le serveur Sage 50.

Lorsque des clients se connectent depuis une autre machine, utilisez l’URL HTTPS affichée par l’installateur avec un certificat de confiance pour vos postes.

Notes de sécurité