MCP tools

Tools gebruiken uw huidige werkruimte-rol bij elke aanroep. Lees-only verbindingen werken nog steeds. Het maken van wijzigingen vereist de extra tradecatalog:write-bereik. Consequente acties tonen een Bevestig/Aannemen-kaart in compatibele clients, met een ingelogd review-link als fallback, en worden pas uitgevoerd nadat u het hebt goedgekeurd. Resultaten zijn JSON-tekst; het oorspronkelijke zoektools-formaat geeft prijzen weer, terwijl beheertools gehele getallen van munteenheden en basispunten (100 = 1%) gebruiken.

De meeste tools nemen een workspace: de werkruimte-adres van list_workspaces, zoals northgate. De AI-app roept meestal list_workspaces eerst zelf aan.

Wanneer een tool iets niet kan doen, bijvoorbeeld u niet persoon bent bij die werkruimte of de klant niet bestaat, geeft het een foutmelding die de AI-app kan lezen en actie ondernemen, zoals "Geen klant "OAK99". Gebruik list_customers voor accountcodes."

Wanneer een leverancierscatalogus alleen prijzen heeft voor de geselecteerde klant, set_basket_quantity, send_order en reorder geven die foutmelding terug. get_basket, list_buyer_orders en get_buyer_order werken nog steeds, zodat bestaande bestellingen leesbaar blijven. De leverancier stelt dit in Instellingen en kan het per klant overschrijven (ordering: follow, prices_only of can_order op update_customer).

Wanneer de leverancier de prijslijstdownloaden heeft uitgeschakeld, geeft download_my_price_list een foutmelding en antwoordt de ingelogde CSV-link met 403.

quote_configured_product leest de lijnprijs van het geselecteerde klantaccount voor productId, qty en optionele configuration, zonder een winkelwagen te veranderen. set_configured_basket_line maakt een aparte lijn aan of werkt de exacte lineId (qty: 0 verwijdert) bij. Geef de volledige specificatie op bij bewerkingen. Lees get_basket opnieuw na wijzigingen en beoordeel alle selecties, maten en huidige prijzen voordat u send_order uitvoert. Een wijziging in specificatie of prijsversie maakt de oude beoordeling ongeldig, zelfs als het totaal hetzelfde is.

Medewerkers kunnen save_product_family gebruiken voor gedeelde variant metadata en save_ordering_draft voor een beoordeelde geavanceerde prijsontwerp. Het laatste vereist Pro en globale prijsrechten; publicatie gebruikt de bestaande prijsveranderingen beoordeling. Productimporten accepteren optionele familie, bestelincrement en besteldefinities. Zie trade catalogue setup.

Stel een leverancierswerkruimte inLink naar deze sectie#

create_workspace maakt een Free leverancierswerkplek voor de ingelogde, geverifieerde persoon, nadat zij een kaart hebben bevestigd. Vraag om de bedrijfsnaam, productvaluta, tijdzone en land. De persoon wordt de eigenaar. Er wordt geen abonnement of betaling aangemaakt. Roep daarna list_workspaces opnieuw aan en gebruik de geretourneerde adres voor product- en klantinstellingen. Beoordelaars en gastlogins kunnen geen werkplekken aanmaken.

Free omvat maximaal 100 producten en verbonden AI-apps. Elk SKU telt, inclusief verborgen en inactieve producten. Bij het toegestane aantal blijven bestaande producten, bewerkingen en bestellingen werken; het aanmaken van meer producten is niet beschikbaar. Leg deze bevoegdheid uit zonder upgrades te promoten of de abonnementscheckout te starten in de plugin.

list_workspacesLink naar deze sectie#

Leverancierswerkruimtes waarin u werkt, en handelsportalen waar u koopt. Begin hier.

Wie: iedereen die is ingelogd. Invoer: geen enkele.

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

search_productsLink naar deze sectie#

Zoek een catalogus op SKU, fabrikantreferentie, naam, merk of categorie. Geeft maximaal 25 producten terug.

Wie: medewerkers en aankopers.

• Aankopers zien altijd de prijzen van hun eigen account en alleen actieve producten die zij kunnen zien.
• Medewerkers zien lijstprijzen en elk product, of de weergave van een genoemde klant.

{
  "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%"
    }
  ]
}

Wanneer de leverancier Klanten de standaardprijs naast hun eigen prijs tonen heeft uitgeschakeld, laten de zoekresultaten van een koper listPrice en why weg, en dragen get_buyer_product, get_basket en get_buyer_order ook geen lijstprijs of prijsreden meer.

Probeer: "Zoek Northgate naar M10 hex bouten tegen de prijzen van Oakfield."

download_products_csv en download_my_price_listLink naar deze sectie#

Deze tools geven een link naar een bestaande CSV-download in TradeCatalog. Open het terwijl u ingelogd bent; het retourneren van een link downloadt of stuurt het bestand niet naar de chat.

• download_products_csv: medewerkers kiezen workspace om de productlijst van die leverancier te downloaden.
• download_my_price_list: kopers kiezen workspace en het exacte accountId uit list_workspaces om alleen de overeengekomen prijzen van dat account te downloaden.
• download_my_price_list_pdf: hetzelfde account, als een gemarkeerde PDF (Pro). Beide tools zijn geblokkeerd wanneer de leverancier prijslijstdownloads heeft uitgeschakeld.

check_priceLink naar deze sectie#

Wat een klant betaalt voor een SKU op een hoeveelheid, en welk regelset de prijs bepaald.

Wie: alleen medewerkers.

{
  "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"
}

Probeer: “Wat betaalt OAK01 voor 20 van HX-8510, en waarom?”

list_customersLink naar deze sectie#

Handelsklanten met accountcodes, contactmails, actieve status en accountkorting.

Wie: alleen medewerkers. Invoer: workspace.

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

Probeer: “Welke klanten hebben geen korting ingesteld?”

list_ordersLink naar deze sectie#

Recente bestellingen, nieuwste eerst, maximaal 50.

Wie: medewerkers zien elke klantens bestellingen; kopers zien alleen hun eigen account.

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

Probeer: “Heeft iemand sinds gisteren nieuwe bestellingen? Tel ze op per klant.”

recent_activityLink naar deze sectie#

De activiteitenlog van wijzigingen aan klanten, kortingen en prijzen, nieuwste eerst, maximaal 50 items. Optioneel de geschiedenis van één klant.

Wie: alleen medewerkers. Eigenaars en beheerders zien de volledige log; andere medewerkers zien alleen wijzigingen over klanten die zij kunnen zien.

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

Probeer: “Wie heeft de prijzen van Oakfield deze maand gewijzigd?”

NotitiesLink naar deze sectie#

• Klantnamen en accountcodes worden zonder rekening te houden met hoofdletters overeengesteld. Een exacte accountcode is veiligst.
• list_workspaces retourneert koper accountId waarden. Geef het bedoelde op naar search_products en elke koperactie. Gok nooit tussen accounts.
• Pagina productzoekopdrachten met offset en het geretourneerde nextOffset. Gebruik list_buyer_orders voor een expliciet geselecteerde koperaccount.

Veranderingen en bevestigingenLink naar deze sectie#

Koperwagentje bewerkingen, markeren updates als gelezen en het maken van ongepubliceerde prijsontwerpen lopen direct wanneer geautoriseerd. Andere schrijfbewerkingen retourneren awaiting_confirmation, een actionId en een reviewUrl. ChatGPT en compatibele clients tonen een kaart met het exacte werkplek en voorgestelde wijziging: kies Bevestigen of Annuleren zonder de conversatie te verlaten. Clients zonder kaarten gebruiken de ingelogde beoordelingslink. Beoordelingen verlopen na 15 minuten en worden maximaal één keer uitgevoerd. Het loskoppelen van de app of het verwijderen van de vereiste werkplektoegang maakt onafgewerkte beoordelingen ongeldig. Gewijzigde bestelwagentjes en prijsveranderingen voorbeelden vereisen een nieuwe beoordeling. Gebruik get_action_status om het resultaat te lezen; een wachtende aanvraag is geen voltooide actie.

De decide_action helper is alleen beschikbaar voor de kaart UI. Zijn tijdelijke bevestigingsmogelijkheid is verborgen van modeluitvoer en gebonden aan de aanvragende persoon, OAuth-verbinding en voorstel. Een modelbericht of actie-ID kan geen wijziging goedkeuren. Dezelfde rol, momentopname, verloop en enkelvoudige controle gelden voor zowel kaart- als browser-goedkeuringen.

Elke aankoperactie vereist uw exacte accountId. Voor send_order, kopieer de winkelwagen fingerprint naar expectedBasket, samen met expectedTotal. Prijzen, hoeveelheden en account worden opnieuw gecontroleerd voordat ze worden verzonden.

Gebruik de aparte overdrachtstools voor werk dat eindigt in de ingelogde app: eigenaren gebruiken open_api_key_settings, download_workspace_export en open_logo_settings; medewerkers gebruiken open_import_page, open_product_image_upload en open_product_file_manager. De twee productoverdrachten vereisen een door de huurder gecontroleerde productId. Bestandskoppelingen van get_product en get_buyer_product vereisen uw ingelogde browser; het retourneren van een koppeling betekent niet dat het document is gelezen of dat een upload, verwijdering, export of certificaat is voltooid. Platformbeheer wordt nooit doorgegeven via OAuth.

Goedgekeurde klantenlijstenLink naar deze sectie#

Medewerkers gebruiken get_customer om de catalogusomvang en goedgekeurde producten van de klant te lezen. set_catalogue_scope verandert tussen all en approved. approve_products voegt expliciete producten of een categorie toe; unapprove_product verwijdert één product. Deze wijzigingen vereisen een beoordeling van het exacte klantaccount, de huidige lijst en de betrokkene producten. Categorielidmaatschap wordt opnieuw gecontroleerd bij bevestiging. Aankopers blijven beperkt tot hun geselecteerde account en de producten die zichtbaar zijn voor dat account.

Leverancier- en koperhulpmiddelenLink naar deze sectie#

create_workspace is beschikbaar zelfs wanneer list_workspaces leeg is. Het maakt een Free leverancierswerkplek en eigenaarslidmaatschap pas na bevestiging. De optionele /mcp/account-verbinding biedt ook open_billing: eigenaren kunnen beveiligde abonnementsfacturatie openen en betaling bevestigen in Stripe, en vervolgens kijken naar get_settings voor de resulterende staat. Factuurkoppelingen voltooien geen betalingen. De standaard /mcp-verbinding die wordt gebruikt door de ChatGPT-plugin exposeert geen open_billing. Zie aanmelden en betalen.

MCP 3.0.0 toont elke model-aanroepbare operatie direct met zijn eigen naam, beschrijving, invoerschema en annotaties. De vorige tools bulk_products en open_workspace_action worden vervangen door de individuele operaties hieronder; vernieuw de tooldefinities van uw client na het bijwerken. Het MCP tools/list-antwoord is het autoritatieve invoerschema. De volgende tools vullen de zoektools hierboven aan:

Medewerker bestellingen invoeren gebruikt preview_customer_order en wordt vervolgens gecontroleerd create_customer_order met exacte prijzen en een herprobeer UUID. Verwerking gebruikt set_order_status met openbare note, particulier internalNote/correctionReason, en expectedRevision. Gecontroleerde set_order_delivery registreert een klantzichtbare leveringsmethode en optionele koerier, referentie en HTTPS-link. Deze tools volgen de huidige rechten en klantbereik van de lidmaatschap. Zie Bestellingen voor de velden en gedrag.