Outils MCP

Les outils utilisent votre rôle d'espace de travail actuel sur chaque appel. Les connexions en lecture seule fonctionnent toujours. Pour effectuer des modifications, il faut l'étendue supplémentaire tradecatalog:write. Les actions conséquentes affichent une carte de confirmation/annulation dans les clients compatibles, avec un lien de consultation signé en tant que sauvegarde, et ne s'exécutent qu'après votre approbation. Les résultats sont du texte JSON ; les outils de recherche formatent les prix, tandis que les outils de gestion utilisent des unités mineures entières de devise et des points de base (100 = 1%).

La plupart des outils prennent un workspace : l'adresse de l'espace de travail provenant de list_workspaces, comme northgate. L'application IA appelle normalement list_workspaces en premier par elle-même.

Lorsqu'un outil ne peut pas faire quelque chose, par exemple si vous n'êtes pas membre du personnel à cet espace de travail ou si le client n'existe pas, il renvoie un message d'erreur que l'application IA peut lire et agir, comme « Aucun client « OAK99 ». Utilisez list_customers pour les codes de compte. »

Lorsqu'un catalogue de fournisseur n'a que des prix pour le client sélectionné, set_basket_quantity, send_order et reorder renvoient cette erreur. get_basket, list_buyer_orders et get_buyer_order fonctionnent toujours, donc les commandes existantes restent lisibles. Le fournisseur définit cela dans les paramètres, et peut le surcharger par client (ordering : follow, prices_only ou can_order sur update_customer).

Lorsque le fournisseur a désactivé le téléchargement des listes de prix, download_my_price_list renvoie une erreur et le lien CSV connecté répond 403.

quote_configured_product lit le prix de ligne du compte acheteur sélectionné pour productId, qty et configuration optionnels, sans modifier un panier. set_configured_basket_line crée une ligne séparée ou met à jour/supprime sa valeur exacte lineId (qty: 0 supprime). Fournissez la spécification complète pour les modifications. Relisez get_basket après les changements et vérifiez toutes les sélections, mesures et prix actuels avant send_order. Un changement de spécification ou de version de prix invalide la revue précédente même si le total reste inchangé.

Le personnel peut utiliser save_product_family pour les métadonnées partagées des variantes et save_ordering_draft pour un brouillon de tarification avancée révisé. Le dernier nécessite le plan Pro et les autorisations de tarification mondiale ; la publication utilise la revue existante des changements de prix. Les importations de produits acceptent les définitions optionnelles de famille, d'incrément de commande et d'ordre. Voir configuration du catalogue de commerce.

Configurer un espace de travail fournisseurLien vers cette section#

create_workspace crée un espace de travail fournisseur gratuit pour la personne connectée, vérifiée, après qu'elle ait confirmé une carte. Demandez le nom de l'entreprise, la devise des produits, le fuseau horaire et le pays. La personne devient son propriétaire. Aucune abonnement ou paiement n'est créé. Ensuite, appelez à nouveau list_workspaces et utilisez l'adresse renvoyée pour la configuration des produits et des clients. Les connexions de réviseur et d'invité ne peuvent pas créer d'espaces de travail.

Free inclut jusqu'à 100 produits et applications IA connectées. Chaque SKU compte, y compris les produits cachés et inactifs. À la limite, les produits existants, les modifications et les commandes fonctionnent toujours ; la création de plus de produits est impossible. Expliquez ce droit sans promouvoir les mises à niveau ou sans lancer le checkout d'abonnement dans le plugin.

list_workspacesLien vers cette section#

Les espaces de travail fournisseurs dans lesquels vous travaillez, et les portails de commerce où vous achetez. Commencez ici.

Qui : quiconque connecté. Entrées : aucune.

{
  "supplierWorkspaces": [
    { "workspace": "northgate", "name": "Northgate Fixings", "role": "owner" }
  ],
  "tradePortals": [
    {
      "workspace": "hartley-timber",
      "supplier": "Hartley Timber",
      "yourAccount": "Northgate Fixings",
      "accountId": "example-account-id"
    }
  ]
}

search_productsLien vers cette section#

Rechercher un catalogue par SKU, référence du fabricant, nom, marque ou catégorie. Retourne jusqu'à 25 produits.

Qui : personnel et acheteurs.

• Les acheteurs voient toujours les prix de leur propre compte et uniquement les produits actifs qu'ils peuvent voir.
• Le personnel voit les prix de liste et tous les produits, ou la vue d'un client nommé.

{
  "supplier": "Northgate Fixings",
  "pricesFor": "Oakfield Joinery",
  "taxNote": "ex VAT",
  "products": [
    {
      "sku": "HX-8510",
      "name": "Hex bolt M10 x 50 zinc",
      "unit": "Box of 100",
      "availability": "in_stock",
      "price": "£15.73",
      "listPrice": "£18.50",
      "why": "Brand discount −15%"
    }
  ]
}

Lorsque le fournisseur a désactivé Afficher le prix standard aux clients à côté de leur propre prix, les résultats des acheteurs excluent listPrice et why, et get_buyer_product, get_basket et get_buyer_order ne comportent pas non plus de prix de liste ou de raison de prix.

Essayez : « Rechercher Northgate pour des boulons hexagonaux M10 aux prix d'Oakfield. »

download_products_csv et download_my_price_listLien vers cette section#

Ces outils renvoient un lien vers un téléchargement CSV existant dans TradeCatalog. Ouvrez-le en étant connecté ; renvoyer un lien ne télécharge pas ou ne transmet pas le fichier dans le chat.

• download_products_csv : le personnel choisit workspace pour télécharger la liste de produits de ce fournisseur.
• download_my_price_list : les acheteurs choisissent workspace et la valeur exacte accountId de list_workspaces pour télécharger uniquement les prix approuvés de ce compte.
• download_my_price_list_pdf : le même compte, sous forme de PDF personnalisé (Pro). Les deux outils sont bloqués lorsque le fournisseur a désactivé le téléchargement des listes de prix.

check_priceLien vers cette section#

Ce que le client paie pour un SKU à une quantité, et quel ensemble de règles a fixé le prix.

Qui : personnel uniquement.

{
  "customer": "Oakfield Joinery",
  "sku": "HX-8510",
  "name": "Hex bolt M10 x 50 zinc",
  "qty": 20,
  "unitPrice": "£15.73",
  "lineTotal": "£314.60",
  "listPrice": "£18.50",
  "why": "Brand discount −15%",
  "taxNote": "ex VAT"
}

Essayez : « Combien paie OAK01 pour 20 unités de HX-8510, et pourquoi ? »

list_customersLien vers cette section#

Clients commerciaux avec codes de compte, emails de contact, statut actif et remise sur compte.

Qui : personnel uniquement. Entrées : workspace.

[
  {
    "accountCode": "OAK01",
    "name": "Oakfield Joinery",
    "email": "accounts@oakfieldjoinery.co.uk",
    "active": true,
    "discount": "5%"
  }
]

Essayez : « Quels clients n’ont pas de remise définie ? »

list_ordersLien vers cette section#

Commandes récentes, du plus récent au plus ancien, jusqu’à 50.

Qui : le personnel peut voir les commandes de tous les clients ; les acheteurs ne voient que celles de leur compte.

[
  {
    "reference": "SO-000142",
    "customer": "Oakfield Joinery",
    "status": "new",
    "total": "£314.60",
    "poNumber": "PO-88231",
    "placed": "2026-09-27T07:48:12.000Z"
  }
]

Essayez : « Y a-t-il de nouvelles commandes depuis hier ? Faites le total par client. »

recent_activityLien vers cette section#

Le journal d’activité des modifications apportées aux clients, aux remises et aux prix, du plus récent au plus ancien, jusqu’à 50 entrées. Historique optionnel d’un client.

Qui : personnel uniquement. Les propriétaires et administrateurs voient l’intégralité du journal ; le personnel restant ne voit que les modifications concernant les clients qu’il peut voir.

[
  {
    "when": "2026-09-26T14:21:03.000Z",
    "who": "Jo Hartley",
    "customer": "Oakfield Joinery",
    "what": "Set Northgate brand discount to 15% (was 12.5%)"
  }
]

Essayez : « Qui a modifié les prix d’Oakfield ce mois-ci ? »

NotesLien vers cette section#

• Les noms des clients et les codes de compte sont correspondus sans tenir compte de la casse. Un code de compte exact est le plus sûr.
• list_workspaces retourne les valeurs accountId des acheteurs. Fournissez-en une intention pour search_products et toutes les actions des acheteurs. Ne jamais deviner entre les comptes.
• Recherches de produits par page avec offset et la valeur nextOffset renvoyée. Utilisez list_buyer_orders pour un compte acheteur sélectionné explicitement.

Modifications et confirmationsLien vers cette section#

Les modifications du panier d'acheteur, la marquage des mises à jour comme lues et la création de brouillons de prix non publiés s'exécutent immédiatement lorsqu'elles sont autorisées. Les autres écritures renvoient awaiting_confirmation, un actionId et un reviewUrl. Les clients ChatGPT et compatibles affichent une carte avec l'espace de travail exact et le changement proposé : choisissez Confirmer ou Annuler sans quitter la conversation. Les clients sans carte utilisent le lien de revue connecté. Les revues expirent après 15 minutes et s'exécutent au maximum une fois. La déconnexion de l'application ou la suppression de l'accès à l'espace de travail requis invalide les revues en attente. Les paniers de commande modifiés et les aperçus de changement de prix nécessitent une nouvelle revue. Utilisez get_action_status pour lire le résultat ; une demande en attente n'est pas une action terminée.

L'aide decide_action est disponible uniquement pour l'interface utilisateur de carte. Sa capacité de confirmation à courte durée est cachée de la sortie du modèle et liée à la personne demandante, à la connexion OAuth et à la proposition. Un message de modèle ou un identifiant d'action ne peut pas approuver un changement. Les mêmes vérifications de rôle, de capture d'écran, d'expiration et d'utilisation unique s'appliquent aux approbations de carte et de navigateur.

Chaque action d'acheteur nécessite votre identifiant exact accountId. Pour send_order, copiez le panier fingerprint dans expectedBasket, en plus de expectedTotal. Les prix, les quantités et le compte sont à nouveau vérifiés avant envoi.

Utilisez les outils de transfert séparés pour le travail qui se termine dans l'application connectée : les propriétaires utilisent open_api_key_settings, download_workspace_export et open_logo_settings ; le personnel utilise open_import_page, open_product_image_upload et open_product_file_manager. Les deux transferts de produits nécessitent un productId vérifié par le locataire. Les liens de fichiers provenant de get_product et get_buyer_product nécessitent votre navigateur connecté ; retourner un lien n'indique pas que le document a été lu ou qu'un téléchargement, une suppression, une exportation ou une création de droit d'accès a été effectué. L'administration de la plateforme n'est jamais déléguée via OAuth.

Listes de clients approuvésLien vers cette section#

Le personnel utilise get_customer pour lire la portée du catalogue du client et les produits approuvés. set_catalogue_scope passe entre all et approved. approve_products ajoute des produits explicites ou une catégorie ; unapprove_product supprime un produit. Ces modifications nécessitent une vérification du client exact, de la liste actuelle et des produits affectés. La appartenance aux catégories est à nouveau vérifiée lors de la confirmation. Les acheteurs restent limités à leur compte sélectionné et aux produits visibles pour ce compte.

Outils fournisseur et acheteurLien vers cette section#

create_workspace est disponible même lorsque list_workspaces est vide. Il crée un espace de travail fournisseur gratuit et une adhésion de propriétaire uniquement après confirmation. La connexion optionnelle /mcp/account offre également open_billing : les propriétaires peuvent ouvrir la facturation sécurisée d'abonnement et confirmer le paiement dans Stripe, puis vérifier get_settings pour l'état résultant. Les liens de facturation ne finalisent pas les paiements. La connexion standard /mcp utilisée par le plugin ChatGPT ne révèle pas open_billing. Voir inscription et facturation.

MCP 3.0.0 expose chaque opération callable via un modèle avec son propre nom, sa description, son schéma d'entrée et ses annotations. Les outils bulk_products et open_workspace_action précédents sont remplacés par les opérations individuelles ci-dessous ; mettez à jour les définitions d'outil de votre client après la mise à jour. La réponse MCP tools/list est le schéma d'entrée autoritatif. Les outils suivants complètent les outils de recherche ci-dessus :

La saisie des commandes par le personnel utilise preview_customer_order puis create_customer_order est révisé avec des prix exacts et un UUID de nouvelle tentative. Le traitement utilise set_order_status avec note public, internalNote/correctionReason privé et expectedRevision. set_order_delivery révisé enregistre un mode de livraison visible par le client et un transporteur, une référence et un lien HTTPS facultatifs. Ces outils suivent les autorisations et la portée client actuelles du membre. Voir Commandes pour les champs et le comportement.