Connecteur IA (MCP)

Posez vos questions de gestion en français, depuis un assistant IA :

« Quel est mon chiffre d’affaires de septembre par famille ? » « Quels clients me doivent encore de l’argent sur 2026 ? » « Compare mes achats du premier et du deuxième trimestre »

L’assistant interroge votre dossier OMAG et répond, chiffres à l’appui.

Ce qu’il faut

L’option API & connecteurs IA active sur votre compte — visible dans Mes applications.
Une clé d’API, créée dans Configuration → Clés API (marche à suivre).
Node 18 ou plus sur le poste, et rien d’autre : aucune dépendance à installer.
Un assistant qui accepte les connecteurs locaux : Claude Desktop, Cursor, VS Code, Cline…

Installation

Récupérez le fichier omag-mcp.js auprès du support, puis déclarez-le dans votre assistant.

Claude Desktop — fichier de configuration :

Windows : %APPDATA%\Claude\claude_desktop_config.json
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "omag": {
      "command": "node",
      "args": ["C:\\omag\\omag-mcp.js"],
      "env": {
        "OMAG_CLE": "omk_live_…",
        "OMAG_API": "https://api.omag.ma:7979/api/v1"
      }
    }
  }
}

Redémarrez l’assistant. Demandez-lui « à quelle société OMAG as-tu accès ? » pour vérifier que tout fonctionne.

Ce qu’il sait faire

Outil	Répond à
`chiffre_affaires`	« mon CA de septembre par famille, par client, par commercial… »
`factures_impayees`	« qui me doit de l’argent, et depuis quand »
`rechercher_tiers`	retrouve un client ou un fournisseur par son nom
`rechercher_article`	retrouve un article par libellé, référence ou code-barre
`stock_par_depot`	« combien il me reste de X, et dans quel dépôt »
`documents_vente`	devis, commandes, BL, factures et avoirs d’un client
`achats_fournisseur`	commandes, réceptions, factures et avoirs fournisseur
`balance_comptable`	la balance d’un exercice
`ma_cle`	vérifie la connexion et ce que la clé ouvre

L’assistant ne voit que ce que votre clé ouvre : les portées que vous avez cochées, sur la société à laquelle elle est rattachée.

Les garde-fous

C’est la partie à lire, parce qu’un assistant IA peut se tromper — et un chiffre faux montré à un banquier coûte cher.

Les chiffres viennent de votre ERP, pas d’un calcul de l’assistant. chiffre_affaires appelle la même procédure que l’écran Analyse croisée. Le total affiché par l’assistant et celui de votre ERP ne peuvent pas diverger.

L’assistant ne compose aucune requête. Il choisit un outil dans la liste ci-dessus et remplit des paramètres contrôlés. Il n’a aucun accès direct à la base, et ne peut pas inventer un filtre.

Les résultats arrivent déjà totalisés. Une question sur le CA annuel rend douze lignes de totaux, pas les milliers de lignes de vente qui les composent. L’assistant n’additionne rien lui-même — donc il ne peut pas se tromper en additionnant.

Chaque réponse cite sa source — période, base du chiffre d’affaires, nombre de lignes agrégées — pour que vous puissiez retrouver le même chiffre dans vos écrans.

Lecture seule. Aucun outil ne crée, ne modifie ni ne supprime quoi que ce soit dans votre dossier. Même si vous le lui demandez.

Ce qu’il ne voit pas

Tout ce que votre clé n’ouvre pas. Si vous n’avez pas coché la portée Achats, l’assistant répondra qu’il n’y a pas accès — il n’inventera pas les chiffres.

Et comme toute l’API : seules les données validées sortent. Un devis en cours de saisie n’est pas visible.