# 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](https://modelcontextprotocol.io) (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 werkt

| Instelling   | Waarde                                                                                  |
| ------------ | --------------------------------------------------------------------------------------- |
| Server URL   | `https://tradecatalog.app/mcp`                                                          |
| Transport    | Streamable HTTP                                                                         |
| Aanmelden    | OAuth 2.1: u meldt u aan met uw normale TradeCatalog-account en kiest **Toestaan**      |
| Toegang      | Leestoegang, plus optionele schrijftoegang met bevestiging bij belangrijke wijzigingen. |
| Wie het doet | U. 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](/docs/mcp/tools) voor wat elke tool doet.

## Werkstroomvaardigheden

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.

| Vaardigheid               | Wanneer te gebruiken                                                                                                 |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `tradecatalog`            | Verbind, maak een leverancierswerkruimte aan of kies een leverancier en klantaccount.                                |
| `tradecatalog-catalogue`  | Maak, bewerk, verberg, toon en organiseer producten of open productmedia-uploads.                                    |
| `tradecatalog-pricing`    | Verklaar overeengekomen prijzen en pas voorwaarden aan, of ontwerp en publiceer prijswijzigingen.                    |
| `tradecatalog-imports`    | Controleer en importeer productrijen, klantaccounts of overeengekomen prijzen.                                       |
| `tradecatalog-customers`  | Onboard klanten, nodig kopers uit en beheer toegang of goedgekeurde productlijsten.                                  |
| `tradecatalog-orders`     | Zoek naar koperprijzen, bereid of herhaal een bestelling, download een toegestane prijslijst of volg een bestelling. |
| `tradecatalog-fulfilment` | Bekijk leveranciersbestellingen en bevestig, verzend, voltooi of annuleer ze.                                        |
| `tradecatalog-updates`    | Lees koperupdates of publiceer leveranciersaankondigingen met expliciete timing en e-mailkeuzes.                     |
| `tradecatalog-workspace`  | Beheer bedrijfsinstellingen, medewerkeraanvragen en goedgekeurde export- of API-overdrachten.                        |
| `tradecatalog-support`    | Lees, bereid of stuur een leverancierssupportaanvraag of follow-up naar Happy Webs.                                  |

Andere agents kunnen dezelfde gidsen vinden van [de publieke vaardigheidsindex](https://tradecatalog.app/.well-known/agent-skills/index.json). Vaardigheden leiden de werkstroom; de server controleert nog steeds accounttoegang en vereist bevestiging bij belangrijke wijzigingen.

## Registreren en betalen met een agent

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](https://developers.openai.com/plugins/plugin-guidelines) 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)

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 Code

```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.

## ChatGPT

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**.

## Cursor

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 Code

Voeg dit toe aan `.vscode/mcp.json`:

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

## Andere clients

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](/docs/mcp/oauth).

## Verwijder een app

Bekijk elke AI-app die u hebt goedgekeurd en verbreek de verbinding met een van hen op [tradecatalog.app/oauth/connections](/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?

|                             | MCP                                              | REST API                                      |
| --------------------------- | ------------------------------------------------ | --------------------------------------------- |
| Voor                        | Mensen die in een AI-app chatten                 | Uw eigen systemen en scripts                  |
| Meldt zich aan als          | Elke persoon, met hun eigen inlog                | De werkruimte, met een eigenaar's API-sleutel |
| Kopers kunnen het gebruiken | Ja, met hun eigen prijzen                        | Nee                                           |
| Kan gegevens veranderen     | Ja, met schrijfbereik en beoordeelde wijzigingen | Ja, met een Lees & schrijf-sleutel            |
| Instellen door              | Elke persoon, in hun AI-app                      | De eigenaar, in Instellingen                  |
| Docs                        | [Tools](/docs/mcp/tools)                         | [REST API](/docs/api)                         |