Connecteur IA (MCP)

Nécessite l’option API & connecteurs IA — voir Mes applications.

Et si vous pouviez demander vos chiffres comme vous le demanderiez à un collaborateur ?

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

Le connecteur relie votre dossier OMAG à un assistant IA — Claude ou ChatGPT. Vous posez la question en français, l’assistant va chercher la réponse dans OMAG et vous la présente, chiffres à l’appui. Sans export, sans tableau croisé, sans attendre quelqu’un.

Bêta

Le connecteur fonctionne et les chiffres sont justes, mais il évolue encore. Dites-nous ce qui vous manque : c’est maintenant que vos retours comptent le plus.

Ce que vous pouvez lui demander

Quelques exemples, à reformuler librement : l’assistant comprend le langage courant.

Pour piloter

• « Quel est mon chiffre d’affaires de septembre, par famille ? »
• « Qui sont mes 5 meilleurs clients cette année ? »
• « Compare le CA de chaque commercial sur le premier semestre. »

Pour la comptabilité et le recouvrement

• « Quels clients me doivent encore de l’argent, et depuis quand ? »
• « Sors-moi la balance de l’exercice 2026. »
• « Compare mes achats du premier et du deuxième trimestre. »

Pour le quotidien commercial

• « Combien me reste-t-il de cartouches HP 305, et dans quel dépôt ? »
• « Montre-moi les devis envoyés à Atlas Distribution ce mois-ci. »
• « Retrouve le fournisseur dont le nom contient “Maroc Info”. »

Enchaînez les questions

L’assistant garde le fil de la conversation. Après une première réponse, demandez simplement « et le mois dernier ? », « classe-les du plus ancien au plus récent » ou « fais-en un tableau que je puisse coller dans Excel ».

Ce qu’il faut

1. L’option API & connecteurs IA active sur votre compte — visible dans Mes applications.
2. Une clé d’accès, créée dans Configuration → Clés API (marche à suivre). C’est en créant cette clé que vous choisissez ce que l’assistant pourra lire : cochez uniquement ce dont vous avez besoin.
3. Un compte Claude (claude.ai) ou ChatGPT — pour ChatGPT, une formule payante Plus, Pro, Team ou Enterprise.

Une clé, une société

Une clé n’ouvre qu’un seul dossier. Si vous suivez plusieurs sociétés, créez une clé — et un connecteur — par société.

Le brancher — 5 minutes, une seule fois

Deux informations suffisent, quel que soit l’assistant :

Adresse du connecteur	https://api.omag.ma/api/mcp
Votre clé	celle créée dans Clés API, qui commence par omk_live_

Sur Claude (claude.ai) — recommandé

1. Ouvrez Réglages → Connecteurs, puis Ajouter un connecteur personnalisé.

2. Nom : OMAG. URL : https://api.omag.ma/api/mcp.

3. Laissez coché « Aucune connexion ».

4. Cliquez sur « Ajouter un en-tête » :

   • dans le premier champ, écrivez exactement x-api-key ;
   • dans le second, collez votre clé, telle quelle.

5. Enregistrez. C’est terminé.

N'écrivez pas « authorization » comme nom d'en-tête

C’est le piège le plus fréquent. Sur claude.ai, ce nom est réservé : votre clé ne serait jamais transmise, et l’assistant répondrait qu’il n’a « aucune clé d’API » alors que tout semble bien réglé. Écrivez x-api-key.

Sur ChatGPT

1. Activez d’abord le mode développeur : Paramètres → Connecteurs → tout en bas, Paramètres avancés → Mode développeur. Un bouton Créer apparaît alors dans Connecteurs.

2. Cliquez sur Créer. Nom : OMAG. URL : https://api.omag.ma/api/mcp.

3. Authentification : choisissez Clé d’API et collez votre clé.

4. Enregistrez.

Sur ChatGPT, allumez le connecteur dans chaque conversation

Un connecteur enregistré n’est actif dans aucune conversation tant que vous ne l’allumez pas : bouton + → Plus → Mode développeur → OMAG. Sans cette étape, ChatGPT répond qu’il n’a accès à rien — et on croit à tort que le branchement est raté.

Vérifier que tout fonctionne

Ouvrez une nouvelle conversation et demandez :

« À quelle société OMAG as-tu accès ? »

L’assistant doit vous répondre avec le nom de votre dossier et la liste de ce que votre clé lui ouvre. Si c’est le cas, vous pouvez poser vos vraies questions.

Ce que l’assistant voit — et ce qu’il ne voit pas

L’assistant ne voit que ce que vous avez coché sur la clé :

Portée cochée	Ce que l’assistant peut vous dire
Articles	retrouver un article, ses prix — y compris les prix de revient
Stock et disponibilités	les quantités par dépôt
Clients et fournisseurs	retrouver un client ou un fournisseur
Devis, commandes, BL, factures	vos documents de vente, votre chiffre d’affaires, vos impayés
Achats	commandes, réceptions et factures fournisseurs
Règlements	les encaissements clients
Écritures comptables	la balance d’un exercice

Si vous lui demandez une information que la clé n’ouvre pas, il vous le dit — il n’invente pas de chiffre :

« Quels règlements ai-je reçus cette semaine ? » 🔒 « Votre clé ne m’ouvre pas les règlements. »

Et certaines données ne sont jamais accessibles, quelle que soit la clé :

• la paie et les salaires : le connecteur n’y a pas accès ;
• les documents non validés : un devis en cours de saisie reste invisible.

La portée « Articles » montre vos marges

Elle inclut les prix d’achat. Si la conversation doit être partagée avec quelqu’un qui n’a pas à connaître vos marges, utilisez une clé sans cette portée.

Pourquoi vous pouvez faire confiance aux chiffres

Un assistant IA peut se tromper — et un chiffre faux montré à un banquier coûte cher. C’est pourquoi le connecteur est conçu pour que l’assistant ne calcule rien lui-même :

• Les chiffres viennent d’OMAG. Le chiffre d’affaires est calculé par la même procédure que l’écran Analyse croisée : le total de l’assistant et celui de votre écran ne peuvent pas différer.
• Ils arrivent déjà totalisés. Pour un CA annuel, l’assistant reçoit douze totaux mensuels, pas des milliers de lignes à additionner. Il ne peut donc pas se tromper en additionnant.
• Il ne fouille pas votre base. Il dispose d’une liste fermée de questions types et n’a aucun accès direct à vos données.
• Il cite sa source. Chaque réponse indique la période et la base de calcul retenues : vous retrouvez le même chiffre dans OMAG en trente secondes.
• Il ne peut rien modifier. Lecture seule : aucune création, modification ni suppression, même si vous le lui demandez.

Le bon réflexe

Un chiffre vous surprend ? Demandez à l’assistant « d’où vient ce chiffre ? ». Il vous donnera la période et la base utilisées, que vous pourrez vérifier dans l’écran correspondant.

Ça ne marche pas ?

Ce que vous voyez	Ce qu’il faut faire
Sur Claude : « aucune clé d’API »	Le nom de l’en-tête doit être exactement x-api-key, pas authorization.
Sur ChatGPT : « je n’ai accès à rien »	Allumez le connecteur dans la conversation : + → Plus → Mode développeur → OMAG.
« Votre clé ne m’ouvre pas… »	Ajoutez la portée concernée dans Configuration → Clés API.
« Clé inconnue ou révoquée »	La clé a été supprimée ou mal copiée : vérifiez le copier-coller, ou créez-en une nouvelle et remplacez-la dans le connecteur.
ChatGPT refuse le connecteur (« not safe »)	Le refus vient de ChatGPT, pas de votre clé. Signalez-le-nous, nous suivons le sujet.

Questions fréquentes

L'assistant peut-il modifier ou supprimer des données dans OMAG ?

Non. Le connecteur est en lecture seule : aucune action ne permet de créer, modifier ou supprimer quoi que ce soit, même si vous le demandez à l'assistant.

Mes données sont-elles envoyées à Claude ou à ChatGPT ?

Seules les réponses à vos questions le sont, et uniquement dans les limites de votre clé. Elles transitent par le service IA que vous utilisez, comme tout ce que vous lui écrivez. D'où l'intérêt de ne cocher sur la clé que ce dont vous avez besoin.

Les chiffres de l'assistant peuvent-ils être faux ?

Les chiffres eux-mêmes viennent d'OMAG, déjà calculés : l'assistant ne fait aucune addition. Il peut en revanche mal comprendre une question ambiguë. Chaque réponse cite la période et la base retenues, pour que vous puissiez vérifier.

Puis-je lui demander la masse salariale ou un bulletin de paie ?

Non. Les données de paie ne sont pas accessibles par le connecteur, quelle que soit la clé.

Je suis expert-comptable et je suis plusieurs dossiers. Comment faire ?

Une clé n'ouvre qu'une seule société. Créez une clé par dossier, puis un connecteur par dossier dans votre assistant, en les nommant clairement (par exemple OMAG - Société A).

Comment couper l'accès de l'assistant ?

Supprimez la clé dans Configuration → Clés API. L'accès s'arrête immédiatement, sans toucher aux autres clés.

Pour votre informaticien

Ce qui suit ne concerne que les postes équipés d’assistants installés localement — Claude Desktop, Cursor, VS Code, Cline. Sur claude.ai et ChatGPT, rien de tout cela n’est nécessaire.

Le serveur utilise le protocole MCP (Model Context Protocol), transport Streamable HTTP, à l’adresse https://api.omag.ma/api/mcp. Pour les clients qui ne parlent que le mode local, un petit relais, omag-mcp.js, est fourni sur demande au support :

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

• Fichier de configuration de Claude Desktop : %APPDATA%\Claude\claude_desktop_config.json (Windows) ou ~/Library/Application Support/Claude/claude_desktop_config.json (macOS).
• Il faut Node 18 ou plus, sans autre dépendance. Le relais ne contient aucun outil : une correction côté serveur profite immédiatement à tous les postes.
• En plus de x-api-key, le serveur accepte Authorization: Bearer omk_live_… et la plupart des noms d’en-tête courants (api-key, x-auth-token…). En cas de refus, le message d’erreur liste les en-têtes effectivement reçus.
• Outils exposés : chiffre_affaires, factures_impayees, rechercher_tiers, rechercher_article, stock_par_depot, documents_vente, achats_fournisseur, balance_comptable, ma_cle. Quota et journal d’activité : ceux de la clé.

Articles liés

• Connecter un autre logiciel (clés d’accès)
• Analyse croisée (tableau croisé dynamique)