Naar inhoud
Documentatie menu

Referentie

MCP

Verbind een AI-app

Verbind Claude, ChatGPT, Cursor, VS Code of een willekeurige MCP-client met TradeCatalog met uw eigen inloggegevens.

TradeCatalog draait een externe Model Context Protocol (MCP) server. Verbind het met uw AI-app en stel vragen zoals:

  • "Wat betaalt Oakfield Joinery voor 20 dozen HX-8510?"
  • "Heeft u vandaag nieuwe bestellingen?"
  • "Wie heeft de korting van Brookside gewijzigd, en wanneer?"
  • "Zoek me een zink hex bout, M10, en mijn prijs voor het." (als koper)

Hoe het werktLink naar deze sectie#

InstellingWaarde
Server URLhttps://tradecatalog.app/mcp
TransportStreamable HTTP
AanmeldenOAuth 2.1: u meldt u aan met uw normale TradeCatalog-account en kiest Toestaan
ToegangLeestoegang, plus optionele schrijftoegang met bevestiging bij belangrijke wijzigingen.
Wie het doetU. Het ziet precies wat u in TradeCatalog kunt zien.
  • Medewerkers zien de gegevens die zijn toegestaan door hun rol en klantbereik. Verkoopmedewerkers kunnen alleen toegang hebben tot toegewezen klanten of regio's; catalogus, prijzen, bestellingen en teamwijzigingen vereisen elk de overeenkomstige toestemming.
  • Kopers zien de leveranciers waarvan ze kopen, met hun eigen prijzen en hun eigen bestellingen alleen.

Teamuitnodigingen, werkruimtestellingen en API-toegang volgen de huidige medewerkerstoegangsrechten van de leverancier. Werkruimteverwijdering blijft alleen voor de eigenaar. Kopers kiezen hun eigen klantaccount voor elke bestelling. Bestaande verbindingen blijven leesalleen tot ze opnieuw worden goedgekeurd.

Elke toolaanroep wordt gecontroleerd met dezelfde regels als de app. Zie MCP tools voor wat elke tool doet.

WerkstroomvaardighedenLink naar deze sectie#

De TradeCatalog-plugin bevat tien gerichte vaardigheden met zijn MCP-verbinding. Elke vaardigheid beschrijft wanneer de werkstroom van toepassing is; de instructies leggen uit welke tools te gebruiken, wat eerst gelezen moet worden en hoe te omgaan met bevestigingen en onvolledige resultaten.

VaardigheidWanneer te gebruiken
tradecatalogVerbind, maak een leverancierswerkruimte aan of kies een leverancier en klantaccount.
tradecatalog-catalogueMaak, bewerk, verberg, toon en organiseer producten of open productmedia-uploads.
tradecatalog-pricingVerklaar overeengekomen prijzen en pas voorwaarden aan, of ontwerp en publiceer prijswijzigingen.
tradecatalog-importsControleer en importeer productrijen, klantaccounts of overeengekomen prijzen.
tradecatalog-customersOnboard klanten, nodig kopers uit en beheer toegang of goedgekeurde productlijsten.
tradecatalog-ordersZoek naar koperprijzen, bereid of herhaal een bestelling, download een toegestane prijslijst of volg een bestelling.
tradecatalog-fulfilmentBekijk leveranciersbestellingen en bevestig, verzend, voltooi of annuleer ze.
tradecatalog-updatesLees koperupdates of publiceer leveranciersaankondigingen met expliciete timing en e-mailkeuzes.
tradecatalog-workspaceBeheer bedrijfsinstellingen, medewerkeraanvragen en goedgekeurde export- of API-overdrachten.
tradecatalog-supportLees, bereid of stuur een leverancierssupportaanvraag of follow-up naar Happy Webs.

Andere agents kunnen dezelfde gidsen vinden van de publieke vaardigheidsindex. Vaardigheden leiden de werkstroom; de server controleert nog steeds accounttoegang en vereist bevestiging bij belangrijke wijzigingen.

Registreren en betalen met een agentLink naar deze sectie#

U kunt verbinden voordat u een werkruimte heeft. De verbinding opent de aanmeldingspagina van TradeCatalog, waar een nieuw e-mailadres uw inlognaam maakt na verificatie. Voltooi de verificatie daar, en ga terug naar uw AI-app. Deel nooit inlogcodes of betalingsgegevens in chat.

Vraag de agent om uw leverancierswerkruimte aan te maken. Het vraagt om uw bedrijfsnaam, productvaluta, tijdzone en land, en gebruikt create_workspace voor uw bevestiging. Uw werkruimte start een 14-daagse Pro-proefperiode zonder kaart. Het is geen betaald abonnement. Wanneer de proefperiode eindigt, keert het terug naar Free, maximaal 100 producten, tenzij u upgrade.

Voor agents die host toestemming hebben voor software-abonnementsfacturering, verbind u met https://tradecatalog.app/mcp/account. Het gebruikt dezelfde TradeCatalog-inlog, OAuth-bereiken en werkruimte-lidmaatschappen, met alle gewone tools plus open_billing. Wanneer u vraagt om te betalen of uw abonnement te beheren, opent dit eigenaar-only hulpmiddel de beveiligde facturatiepagina van de werkruimte. Kies maandelijkse of jaarlijkse facturering en bevestig de betaling in Stripe. Bestaande abonnees kunnen hun abonnement daar beheren. De agent kan daarna get_settings controleren; het openen van een link is geen bewijs dat de betaling is voltooid.

ChatGPT-plugins gebruiken https://tradecatalog.app/mcp, wat geen factureringstools blootlegt. OpenAI's pluginrichtlijnen sluiten op dit moment het verkopen van software-abonnementen en het promoten van upgrades uit. Gratis registratie en werkruimtecreatie zijn beschikbaar via die verbinding. Agents kunnen handelsorderaanvragen voorbereiden. Optionele klantbetalingen vereisen dat de koper de ingelogde bestellingspagina opent, de exacte leverancier-bevestigde betaling goedkeurt en Stripe Checkout voltooit. Een agent goedkeuring van een bestelling is nooit een betalingsgoedkeuring.

Claude (web, desktop en mobiel)Link naar deze sectie#

  1. Open Instellingen, ga naar Connectors en kies Aangepaste connector toevoegen.
  2. Noem het "TradeCatalog" en plak https://tradecatalog.app/mcp.
  3. Kies Verbinden. Meld u aan bij TradeCatalog met uw e-mailcode en kies Toestaan.

Connectors die u op de webversie toevoegt, verschijnen ook in Claude Desktop en de mobiele apps. Bij Team- en Enterprise-plannen moet een eigenaar mogelijk eerst de connector voor de organisatie toevoegen.

Claude CodeLink naar deze sectie#

bash
claude mcp add --transport http tradecatalog https://tradecatalog.app/mcp

Voer daarna /mcp in Claude Code uit en kies tradecatalog om in te loggen.

ChatGPTLink naar deze sectie#

  1. Open Instellingen, dan Apps & Connectors. Als uw plan dit vereist, schakel Developer mode aan onder Geavanceerd.
  2. Maak een connector aan met de URL https://tradecatalog.app/mcp en OAuth-verificatie.
  3. Meld u aan bij TradeCatalog en kies Toestaan.

CursorLink naar deze sectie#

Voeg dit toe aan ~/.cursor/mcp.json (of .cursor/mcp.json in een project):

json
{
  "mcpServers": {
    "tradecatalog": { "url": "https://tradecatalog.app/mcp" }
  }
}

Cursor opent de TradeCatalog-inlogpagina de eerste keer dat u het gebruikt.

VS CodeLink naar deze sectie#

Voeg dit toe aan .vscode/mcp.json:

json
{
  "servers": {
    "tradecatalog": { "type": "http", "url": "https://tradecatalog.app/mcp" }
  }
}

Andere clientsLink naar deze sectie#

Elke client die ondersteuning biedt voor remote MCP over Streamable HTTP met OAuth werkt. Voor clients die alleen lokale (stdio) servers uitvoeren, gebruik de mcp-remote-brug:

json
{
  "mcpServers": {
    "tradecatalog": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://tradecatalog.app/mcp"]
    }
  }
}

Bouwt u uw eigen client? Zie OAuth voor MCP-clients.

Verwijder een appLink naar deze sectie#

Bekijk elke AI-app die u hebt goedgekeurd en verbreek de verbinding met een van hen op tradecatalog.app/oauth/connections. Het verwijderen van de connector in uw AI-app stopt dat de app het gebruikt. Het verbreken van de verbinding hier onthult ook zijn toegang aan onze kant, direct.

MCP of de REST API?Link naar deze sectie#

MCPREST API
VoorMensen die in een AI-app chattenUw eigen systemen en scripts
Meldt zich aan alsElke persoon, met hun eigen inlogDe werkruimte, met een eigenaar's API-sleutel
Kopers kunnen het gebruikenJa, met hun eigen prijzenNee
Kan gegevens veranderenJa, met schrijfbereik en beoordeelde wijzigingenJa, met een Lees & schrijf-sleutel
Instellen doorElke persoon, in hun AI-appDe eigenaar, in Instellingen
DocsToolsREST API