Référence

Outils MCP du connecteur Sage 100

La liste complète des 44 outils exposés par Maillon pour Sage 100, les droits (scopes) qui les ouvrent et la syntaxe des filtres.

8 min de lectureMis à jour le 30 septembre 2026

Un assistant ne voit que les outils autorisés par la clé qu'il utilise. Commencez toujours une conversation par sage_context : il indique les dossiers accessibles, les droits de la clé et les conventions du connecteur.

Droits (scopes)

Chaque clé reçoit un ou plusieurs droits, et une liste de dossiers (--dossiers BIJOU,ACME ou * pour tous).

Scope	Autorise
`read`	Lecture de toutes les entités exposées, recherches et synthèses (par défaut).
`write`	Création et modification des fiches (tiers, contacts, articles, comptes).
`documents`	Création, modification et transformation des documents commerciaux.
`accounting`	Saisie de pièces comptables, lettrage, règlement d'échéances.
`stock`	Transferts, lots et séries, inventaire.
`delete`	Suppressions (en plus du scope du domaine concerné).
`settings`	Paramètres société (catégories tarifaires, gammes, unités, modes de règlement, paramètres du bon à payer...).

Donnez le minimum nécessaire

Une clé de consultation n'a besoin que de read. Ajoutez documents, accounting ou stock uniquement pour les agents qui doivent écrire dans ces domaines, et réservez delete et settings aux usages encadrés.

Liste des outils

Tous les outils sont annotés (readOnlyHint, destructiveHint) : les assistants compatibles, comme Claude, peuvent ainsi demander une validation avant chaque écriture.

Outil	Scope	Rôle
`sage_context`	aucun	Dossiers accessibles, scopes de la clé, outils disponibles, conventions. À appeler en premier.
`sage_schema`	`read`	Entités, colonnes réelles du dossier (infos libres comprises), énumérations, relations.
`sage_search`	`read`	Recherche filtrée, triée et paginée (`total_count`, `has_more`, `next_offset`).
`sage_get`	`read`	Un enregistrement complet avec ses enregistrements liés (lignes, échéances, contacts, stocks...).
`sage_finance`	`read`	`tiers_balance`, `aged_balance`, `open_items`, `account_balance`, `stock_status`, `sales_summary`.
`sage_tiers`	`write`	Création, modification, suppression (`delete`) d'un tiers, conversion d'un prospect en client.
`sage_contact`	`write`	Contacts d'un tiers.
`sage_depot`	`write`	Dépôts.
`sage_emplacement`	`write`	Emplacements d'un dépôt (gestion multi-emplacements).
`sage_collaborateur`	`write`	Collaborateurs, désignés par nom et prénom, avec leurs rôles (vendeur, acheteur, financier...).
`sage_livraison`	`write`	Adresses de livraison d'un client (mode d'expédition, condition de livraison, adresse principale).
`sage_rib`	`write`	Comptes bancaires d'un tiers : RIB local (clé contrôlée par Sage) ou IBAN (contrôlé par le connecteur), banque principale.
`sage_article`	`write`	Articles (famille obligatoire à la création, valeurs par défaut de la famille appliquées).
`sage_nomenclature`	`write`	Nomenclature d'un article : type et liste des composants (remplacée en bloc).
`sage_article_conditionnement`	`write`	Conditionnements d'un article : référence, code-barres, code EDI de chacun.
`sage_article_gamme`	`write`	Gammes d'un article : valeurs, référence, code-barres, prix d'achat et mise en sommeil de chaque combinaison.
`sage_famille`	`write`	Familles d'articles.
`sage_bareme`	`write`	Barèmes (rabais, soldes, commissions) avec leurs tranches ; `appliquer` ajoute à un document les remises des barèmes qui s'appliquent (scope `documents`).
`sage_tarif`	`write`	Prix et remises d'un article ou d'une famille pour un client, une catégorie tarifaire ou un fournisseur, paliers de quantité, fournisseur principal.
`sage_compte`	`write`	Comptes généraux.
`sage_ressource`	`write`	Ressources de production et centres de charge : création, modification, suppression, rattachement d'une ressource à un article ou à un centre.
`sage_controle_qualite`	`documents`	Contrôle qualité des quantités placées sur des emplacements de contrôle : lignes à contrôler, validation (transfert), retour (bon ou facture de retour), mise au rebut.
`sage_agenda`	`write`	Événements d'agenda (visites, appels...) d'un client, d'un fournisseur ou d'un collaborateur : liste (dont à venir), création, déplacement, modification, suppression.
`sage_dossier`	`settings`	Paramètres du dossier : identité de la société (raison sociale, SIRET, APE, TVA, adresse, contact), exercices, devise de tenue, options d'emplacements (multi-emplacements, emplacements de contrôle).
`sage_numerotation`	`settings`	Prochains numéros de pièce d'une souche par type de document : lecture et modification (refusée si le numéro existe déjà).
`sage_modele`	`settings`	Modèles de saisie (avec analytique et fonctions Sage), modèles de règlement et modèles de grille : liste, création, modification, suppression.
`sage_tiers_reglement`	`write`	Conditions de règlement d'un client ou d'un fournisseur : liste avec échéances calculées par Sage, remplacement par des lignes ou par un modèle de règlement.
`sage_glossaire`	`write`	Glossaires (textes réutilisables d'article ou de document) : création, modification, suppression, rattachement d'un glossaire article à un article.
`sage_media`	`write`	Pièces jointes (médias) d'un tiers, d'un article, d'un document (scope `documents`) ou d'une écriture (scope `accounting`) : liste, ajout d'un fichier du serveur ou envoyé en base64, suppression.
`sage_parametre`	`settings`	Paramètres société : catégories tarifaires, gammes (produit et de remise), unités, modes de règlement, modes d'expédition, conditions de livraison, conditionnements, agendas, périodes de rappel, souches, catégories comptables, périodicités, devises, pays, taxes.
`sage_document`	`documents`	Création, modification (entête, ajout, modification et suppression de lignes) et suppression de devis, commandes, livraisons, factures, avoirs, documents d'achat, de stock et internes. Prix, remises, taxes et totaux calculés par Sage.
`sage_document_transform`	`documents`	Transformation comme dans Sage : devis en commande, commande en livraison, livraison en facture, commande fournisseur en réception, etc.
`sage_document_traitement`	`documents`	Traitements Sage sur un document : insertion d'un sous-total, colisage des lignes d'une préparation de livraison, recalcul du prix de revient d'un document de fabrication.
`sage_acompte`	`documents`	Acomptes d'un document : liste, ajout, modification, suppression.
`sage_reglement`	`documents`	Règlement d'une ou plusieurs factures d'un même payeur, total ou partiel, affecté aux échéances.
`sage_ecriture`	`accounting`	Saisie d'une pièce comptable équilibrée (processus de saisie de Sage), suppression d'une pièce entière.
`sage_lettrage`	`accounting`	Lettrage, prélettrage ou pointage d'écritures.
`sage_journal`	`accounting`	Journaux comptables.
`sage_bon_a_payer`	`accounting`	Circuit du bon à payer d'une facture fournisseur (valider, attendre, payer, conformer, rejeter), historique et paramètres société.
`sage_compte_analytique`	`accounting`	Sections analytiques d'un plan.
`sage_stock_transfert`	`stock`	Virement de dépôt à dépôt, valorisé par Sage.
`sage_stock_article`	`stock`	Stock mini, maxi et emplacement d'un article dans un dépôt où il est stocké (seuls les emplacements existants sont acceptés : Sage créerait sinon l'emplacement à la volée).
`sage_inventaire`	`stock`	Inventaire d'un dépôt à une date : quantité comptée et valeur par article (et par lot), écarts calculés, mouvements de régularisation générés par Sage.
`sage_lot`	`stock`	Lots et numéros de série : prélèvement des lots d'une préparation de livraison (processus Sage), dates de péremption et de fabrication d'un lot, numéros suivants libres.

Couverture fonctionnelle

Domaine	Lecture	Écriture
Tiers (clients, fournisseurs, prospects, salariés, autres), contacts, conversion prospect en client	disponible	disponible
Adresses de livraison des clients, RIB des tiers	disponible	disponible
Collaborateurs (vendeurs, acheteurs, responsables financiers)	disponible	disponible
Bons à payer des factures fournisseurs (circuit et paramètres)	disponible	disponible
Articles, familles	disponible	disponible
Nomenclatures (fabrication, composé et composant commerciaux, articles liés) et leurs composants	disponible	disponible
Fabrication : préparations, ordres et bons de fabrication (composants consommés et valorisés par Sage), recalcul du prix de revient des composés	disponible	disponible
Articles conditionnés (cartons, palettes...) : conditionnements, références et codes-barres par conditionnement, vente par conditionnement	disponible	disponible
Articles à gammes (tailles, couleurs...) : gammes, valeurs, références et codes-barres par combinaison, documents et inventaire par combinaison	disponible	disponible
Stocks : entrées, sorties, virements de dépôt à dépôt	disponible	disponible
Dépôts, emplacements, stock mini / maxi et emplacement d'un article par dépôt	disponible	disponible
Lots et numéros de série (entrées, sorties automatiques ou choisies, transformations, prélèvement des préparations)	disponible	disponible
Tarifs des articles et des familles (clients, catégories tarifaires, fournisseurs, paliers de quantité, fournisseur principal)	disponible	disponible
Barèmes : rabais, remises et ristournes, soldes et promotions (clients et fournisseurs), commissions, application sur un document	disponible	disponible (sauf la restriction à des articles ou des tiers)
Inventaire (quantités et valeurs comptées, lots, régularisation par Sage)	disponible	disponible (hors articles à gammes)
Documents de vente, d'achat, de stock et internes, lignes	disponible	disponible (création, modification des lignes, transformation, suppression)
Règlements clients et fournisseurs (affectés aux échéances, paiement partiel)	disponible	disponible
Acomptes des documents de vente et d'achat	disponible	disponible (Sage exige un article d'acompte dans les paramètres société)
Comptabilité : plan comptable	disponible	disponible
Comptabilité : journaux, pièces comptables, lettrage	disponible	disponible
Comptabilité : analytique (sections, ventilation des écritures à la saisie ou après coup, analytique automatique)	disponible	disponible
Synthèses : soldes, balance âgée, échéancier, soldes de comptes, stock à terme, chiffre d'affaires	disponible

Filtres de recherche

sage_search accepte un tableau JSON de conditions [colonne, opérateur, valeur], combinées par ET. Un bloc or permet d'exprimer une alternative :

[["DO_Type", "in", [6, 7]], ["DO_Date", ">=", "2026-01-01"], {"or": [["DO_Tiers", "=", "CARAT"], ["DO_Tiers", "=", "BILLOT"]]}]

Opérateurs disponibles : =, !=, <, <=, >, >=, in, not in, between, like, not like, contains, not contains, starts_with, ends_with, is null, is not null.

L'assistant n'envoie jamais de SQL

Les colonnes sont vérifiées contre le schéma réel du dossier et toutes les valeurs passent en paramètres SQL. Les écritures passent exclusivement par les Objets Métiers de Sage.