Strumenti MCP

Gli strumenti utilizzano il ruolo del tuo workspace corrente in ogni chiamata. Le connessioni in sola lettura continuano a funzionare. Per effettuare modifiche è necessario lo scope aggiuntivo tradecatalog:write. Le azioni conseguenti mostrano una scheda Conferma/Annulla nei client compatibili, con un collegamento di revisione accesso effettuato come fallback, e vengono eseguite solo dopo la tua approvazione. I risultati sono testo JSON; il formato originale degli strumenti di ricerca prevede prezzi, mentre gli strumenti di gestione utilizzano unità minori di valuta intere e punti base (100 = 1%).

La maggior parte degli strumenti richiede un workspace: l'indirizzo del workspace da list_workspaces, ad esempio northgate. L'app AI chiama normalmente list_workspaces per prima da sola.

Quando uno strumento non può fare qualcosa, ad esempio non sei personale in quel workspace o il cliente non esiste, restituisce un messaggio di errore che l'app AI può leggere e agire, come "Nessun cliente "OAK99". Utilizza list_customers per i codici account."

Quando il catalogo di un fornitore è prezzo solo per il cliente selezionato, set_basket_quantity, send_order e reorder restituiscono questo errore. get_basket, list_buyer_orders e get_buyer_order funzionano ancora, quindi gli ordini esistenti rimangono leggibili. Il fornitore lo imposta nelle Impostazioni e può sovrascriverlo per ogni cliente (ordering: follow, prices_only o can_order su update_customer).

Quando il fornitore ha disattivato il download degli elenchi prezzi, download_my_price_list restituisce un errore e il collegamento CSV accesso effettuato risponde 403.

quote_configured_product legge il prezzo di riga del conto acquirente selezionato per productId, qty e opzionale configuration, senza modificare un carrello. set_configured_basket_line crea una riga separata o aggiorna/rimuove la sua esatta lineId (qty: 0 rimuove). Fornisci la specifica completa sulle modifiche. Rileggi get_basket dopo le modifiche e verifica tutte le selezioni, le misure e i prezzi correnti prima di send_order. Una modifica alla specifica o alla versione dei prezzi invalida la vecchia revisione anche se il totale non è cambiato.

Il personale può utilizzare save_product_family per i metadati condivisi delle varianti e save_ordering_draft per un bozza avanzata di prezzo revisionata. Quest'ultimo richiede il piano Pro e l'autorizzazione al prezzo globale; la pubblicazione utilizza la revisione dei cambiamenti dei prezzi esistente. Gli import di prodotti accettano opzionalmente famiglia, incremento d'ordine e definizioni di ordinamento. Consulta setup del catalogo commerciale.

Configura un workspace del fornitoreCollegamento a questa sezione#

create_workspace crea un'area di lavoro gratuita per fornitori per la persona autenticata e verificata, dopo che ha confermato una carta. Chiedi il nome dell'azienda, la valuta dei prodotti, il fuso orario e il paese. La persona ne diventa il proprietario. Non viene creato alcun abbonamento o pagamento. Poi richiama list_workspaces nuovamente e utilizza l'indirizzo restituito per la configurazione dei prodotti e dei clienti. Accessi di revisore e ospite non possono creare aree di lavoro.

Free include fino a 100 prodotti e app AI collegate. Ogni SKU è contato, incluso prodotti nascosti e inattivi. Al raggiungimento del limite, i prodotti esistenti, modifiche e ordini continuano a funzionare; la creazione di ulteriori prodotti non è disponibile. Spiega questo diritto senza promuovere gli aggiornamenti o avviare il checkout dell'abbonamento nel plugin.

list_workspacesCollegamento a questa sezione#

Workspace dei fornitori in cui lavori, e portali di scambio dove acquisti. Inizia qui.

Chi: chiunque sia connesso. Input: nessuno.

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

search_productsCollegamento a questa sezione#

Cerca un catalogo per SKU, riferimento del produttore, nome, marca o categoria. Restituisce fino a 25 prodotti.

Chi: personale e acquirenti.

• Acquirenti vedono sempre i prezzi del loro account e solo i prodotti attivi che possono vedere.
• Personale vede i prezzi di listino e tutti i prodotti, o la visualizzazione di un cliente specifico.

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

Quando il fornitore ha disattivato Mostra ai clienti il prezzo standard accanto al loro prezzo, i risultati dell'acquirente escludono listPrice e why, e get_buyer_product, get_basket e get_buyer_order non hanno né un prezzo di listino né una ragione del prezzo.

Prova: "Cerca Northgate per viti M10 a sfera a prezzi di Oakfield."

download_products_csv e download_my_price_listCollegamento a questa sezione#

Questi strumenti restituiscono un collegamento a un download CSV esistente in TradeCatalog. Apri il file mentre sei connesso; restituire un collegamento non scarica o invia il file in chat.

• download_products_csv: il personale sceglie workspace per scaricare l'elenco dei prodotti di quel fornitore.
• download_my_price_list: gli acquirenti scelgono workspace e l'esatto accountId da list_workspaces per scaricare solo i prezzi concordati di quel account.
• download_my_price_list_pdf: lo stesso account, in formato PDF marchiato (Pro). Entrambi gli strumenti sono bloccati quando il fornitore ha disattivato il download degli elenchi prezzi.

check_priceCollegamento a questa sezione#

Quanto paga un cliente per un SKU in una quantità, e quale set di regole ha impostato il prezzo.

Chi: solo personale.

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

Prova: "Quanto paga OAK01 per 20 di HX-8510, e perché?"

list_customersCollegamento a questa sezione#

Clienti commerciali con codici account, email di contatto, stato attivo e sconto account.

Chi: solo personale. Input: workspace.

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

Prova: "Quali clienti non hanno uno sconto impostato?"

list_ordersCollegamento a questa sezione#

Ordini recenti, dal più recente al più vecchio, fino a 50.

Chi: il personale può vedere gli ordini di ogni cliente; i compratori possono vedere solo quelli del loro account.

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

Prova: "C'è qualche ordine nuovo da ieri? Totale per cliente."

recent_activityCollegamento a questa sezione#

Il registro delle attività delle modifiche ai clienti, agli sconti e ai prezzi, dal più recente al più vecchio, fino a 50 voci. Opzionalmente, la storia di un solo cliente.

Chi: solo personale. I proprietari e gli amministratori vedono l'intero registro; altri dipendenti vedono solo le modifiche relative ai clienti che possono vedere.

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

Prova: "Chi ha modificato i prezzi di Oakfield questo mese?"

NoteCollegamento a questa sezione#

• I nomi dei clienti e i codici di account vengono abbinati senza tenere conto del caso. Un codice di account esatto è più sicuro.
• list_workspaces restituisce i valori dell'acquirente accountId. Fornisci quello intenzionato a search_products e a ogni azione dell'acquirente. Non indovinare mai tra gli account.
• Esegui ricerche di prodotti nella pagina con offset e il nextOffset restituito. Usa list_buyer_orders per un account acquirente selezionato esplicitamente.

Modifiche e confermeCollegamento a questa sezione#

Le modifiche al carrello dell'acquirente, le notifiche di aggiornamento e la creazione di bozze di prezzi non pubblicati vengono eseguite immediatamente quando autorizzate. Altri scritture restituiscono awaiting_confirmation, un actionId e un reviewUrl. I client ChatGPT e compatibili visualizzano una scheda con il workspace esatto e la modifica proposta: scegliere Conferma o Annulla senza uscire dalla conversazione. I client senza schede utilizzano il link di revisione autenticato. Le revisioni scadono dopo 15 minuti e vengono eseguite al massimo una volta. Disconnettere l'app o rimuovere l'accesso necessario al workspace invalida le revisioni in sospeso. I carrelli degli ordini modificati e le anteprime dei cambiamenti dei prezzi richiedono una nuova revisione. Utilizzare get_action_status per leggere l'esito; una richiesta in sospeso non è un'azione completata.

Il helper decide_action è disponibile solo per l'interfaccia utente della carta. La sua capacità di conferma a breve termine è nascosta dall'output del modello e vincolata alla persona che effettua la richiesta, alla connessione OAuth e alla proposta. Un messaggio del modello o un ID di azione non possono approvare un cambiamento. Le stesse verifiche per ruolo, snapshot, scadenza e utilizzo singolo si applicano sia alle approvazioni della carta che a quelle del browser.

Ogni azione dell'acquirente richiede il tuo esatto accountId. Per send_order, copia il carrello fingerprint in expectedBasket, insieme a expectedTotal. I prezzi, le quantità e l'account vengono verificati nuovamente prima dell'invio.

Utilizza gli strumenti di passaggio separati per il lavoro che termina nell'app con accesso effettuato: gli amministratori utilizzano open_api_key_settings, download_workspace_export e open_logo_settings; il personale utilizza open_import_page, open_product_image_upload e open_product_file_manager. I due passaggi del prodotto richiedono un productId verificato dal locatario. I collegamenti dei file da get_product e get_buyer_product richiedono il tuo browser con accesso effettuato; restituire un collegamento non indica che il documento è stato letto o che un caricamento, rimozione, esportazione o creazione di credenziali è stato completato. L'amministrazione della piattaforma non viene mai delegata tramite OAuth.

Liste clienti approvateCollegamento a questa sezione#

Il personale utilizza get_customer per leggere l'ambito del catalogo del cliente e i prodotti approvati. set_catalogue_scope passa tra all e approved. approve_products aggiunge prodotti espliciti o una categoria; unapprove_product rimuove un prodotto. Queste modifiche richiedono la revisione del cliente esatto, della lista corrente e dei prodotti interessati. La membership alla categoria viene verificata nuovamente al momento della conferma. I compratori rimangono limitati al loro account selezionato e ai prodotti visibili a quell'account.

Strumenti per fornitori e acquirentiCollegamento a questa sezione#

create_workspace è disponibile anche quando list_workspaces è vuoto. Crea un workspace per fornitori Free e una membership di proprietario solo dopo la conferma. La connessione /mcp/account opzionale offre anche open_billing: i proprietari possono aprire la fatturazione abbonamento sicura e confermare il pagamento in Stripe, quindi verificare get_settings per lo stato risultante. I collegamenti di fatturazione non completano i pagamenti. La connessione standard /mcp utilizzata dal plugin ChatGPT non espone open_billing. Consulta registrazione e fatturazione.

MCP 3.0.0 espone ogni operazione chiamabile da modello in anticipo con il proprio nome, descrizione, schema di input e annotazioni. Gli strumenti bulk_products e open_workspace_action precedenti vengono sostituiti dalle operazioni individuali riportate di seguito; aggiorna le definizioni degli strumenti del tuo client dopo l'aggiornamento. La risposta MCP tools/list è lo schema di input autoritativo. I seguenti strumenti completano gli strumenti di ricerca sopra indicati:

L'ingresso degli ordini del personale utilizza preview_customer_order poi revisionato create_customer_order con prezzi esatti e un UUID di ripetizione. Il processo utilizza set_order_status con note pubblici, internalNote/correctionReason privati e expectedRevision. set_order_delivery revisionati registra un metodo di consegna visibile al cliente e corriere opzionale, riferimento e collegamento HTTPS. Questi strumenti seguono le autorizzazioni e lo scope del cliente attuali. Vedi Ordini per i campi e il comportamento.