Claude, ChatGPT of een andere AI-assistent koppelen met de ChannelDock MCP

Last updated

De ChannelDock MCP-server koppelt je eigen AI-assistent, zoals Claude of ChatGPT, aan je ChannelDock-account. MCP (Model Context Protocol) is een open standaard waarmee AI-apps met andere software samenwerken. Na het koppelen stel je in gewone taal vragen over je orders, voorraad en zendingen, en laat je de assistent wijzigingen voor je doorvoeren, bijvoorbeeld producten aanmaken, een inkomende levering aanmelden of factuurregels instellen.

Jij kiest de AI-app, ChannelDock levert de koppeling. De assistent werkt alleen in het account dat je koppelt, en elke wijziging gaat via dezelfde regels als de ChannelDock REST API.

Wil je eerst zien wat dit voor jouw bedrijf kan doen? Lees AI-assistenten met de ChannelDock MCP.

Voor wie is het?

Verkopers: vraag naar orders, voorraad en retouren, maak producten in bulk aan of werk ze bij, maak marketplace-listings aan in PIM, meld leveringen van leveranciers aan en maak verzendlabels.
Fulfillmentcenters: werk voor al je gekoppelde verkopers: inkomende leveringen, voorraadlocaties, orders, zendingen, taken en batches. Maak nieuwe verkopersaccounts aan en zet de facturatie op vanuit een prijslijst.

Elk type account heeft een eigen MCP-URL. Een verkopersaccount kan de URL voor fulfillmentcenters niet gebruiken, en andersom.

Voordat je begint

Abonnement: de MCP gebruikt dezelfde toegang als de API en is daarom niet beschikbaar op het gratis abonnement.
AI-functies staan aan: heeft een admin de AI-functies voor het account uitgezet, dan weigert de MCP elk verzoek. Je vindt de schakelaar onder Instellingen → Algemene instellingen → AI-functies (verkopers) of Instellingen → Account → AI-functies (fulfillmentcenters).
Wie mag koppelen: de accounteigenaar of een teamlid met adminrechten kan een OAuth-koppeling goedkeuren. Alleen de accounteigenaar (super admin) kan API-sleutels zien en aanmaken.
Een MCP-client: een AI-app die externe MCP-servers ondersteunt, zoals Claude, ChatGPT of Cursor.

Welke MCP-URL gebruik je?

Account	MCP-URL
Verkoper	`https://channeldock.com/portal/api/mcp/seller`
Fulfillmentcenter	`https://channeldock.com/portal/api/mcp/center`

Je vindt je URL ook in ChannelDock, met een kopieerknop en korte instructies voor Cursor, Claude en ChatGPT:

Verkoper: Instellingen → Koppelingen → MCP koppelen
Fulfillmentcenter: Instellingen → Aanvullend → MCP koppelen

Optie 1: koppelen met OAuth (Claude en ChatGPT)

Met OAuth plak je alleen de MCP-URL. Je logt in bij ChannelDock en keurt de koppeling goed. Je kopieert dus nooit een API-sleutel.

Claude

Open in Claude Settings → Connectors → Add custom connector.
Plak de MCP-URL die bij jouw type account hoort.
Claude stuurt je door naar ChannelDock. Log in als je nog niet bent ingelogd.
Het scherm MCP-toegang autoriseren toont de applicatie, je account en de MCP-URL. Controleer ze en klik op Toegang toestaan.

ChatGPT

Voeg in ChatGPT een externe MCP-connector toe. Daarvoor heb je de ontwikkelaarsmodus nodig, of in een zakelijke workspace een workspace-admin.
Plak de MCP-URL die bij jouw type account hoort.
Log in bij ChannelDock en klik op Toegang toestaan.

De menunamen in Claude en ChatGPT kunnen veranderen en verschillen per abonnement. Kun je ze niet vinden, zoek dan naar “Connectors” of “MCP” in de instellingen van de app. Andere AI-apps die MCP met OAuth ondersteunen werken op dezelfde manier: URL plakken, inloggen, toegang toestaan.

Wat er gebeurt als je op Toegang toestaan klikt

ChannelDock maakt een API-sleutel voor MCP-koppelingen aan onder Instellingen → API & webhooks. De omschrijving begint met [MCP OAuth]. Latere OAuth-koppelingen van je account gebruiken dezelfde sleutel.
De AI-app krijgt een token dat één uur geldig is en dat de app zelf vernieuwt. Wordt de koppeling 30 dagen niet gebruikt, dan log je opnieuw in en sta je de toegang opnieuw toe.

Optie 2: koppelen met een API-sleutel (Cursor en andere MCP-clients)

Gebruik een API-sleutel voor apps waarin je zelf headers voor een MCP-server instelt, zoals Cursor, of voor je eigen scripts en agents.

Snelste manier

Open MCP koppelen (zie hierboven).
Klik op Verbindingsprompt kopiëren. ChannelDock maakt een nieuwe API-sleutel met de naam MCP / AI-agent aan en kopieert een prompt met de MCP-URL, de API-sleutel en het API-secret.
Plak de prompt in je AI-tool en verstuur hem. Een agent die zijn eigen MCP-instellingen kan aanpassen, voegt de server zelf toe.

Elke klik op Verbindingsprompt kopiëren maakt een nieuwe sleutel aan. Wil je een sleutel gebruiken die je al hebt, kies hem dan bij Bestaande sleutel gebruiken en klik op Prompt met deze sleutel kopiëren.

Handmatig instellen

Stuur deze twee headers mee met elk verzoek naar de MCP-URL:

Header	Waarde
`Authorization`	`Bearer <API-sleutel>`
`Api-Secret`	`<API-secret>`

Voorbeeld voor Cursor, in ~/.cursor/mcp.json of .cursor/mcp.json in een project:

{
  "mcpServers": {
    "channeldock": {
      "url": "https://channeldock.com/portal/api/mcp/seller",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "Api-Secret": "YOUR_API_SECRET"
      }
    }
  }
}

Gebruik voor een fulfillmentcenter de URL die eindigt op /center.

De verbindingsprompt en dit bestand bevatten je API-secret. Behandel ze als een wachtwoord: plak ze alleen in een app die je vertrouwt, en zet ze niet in een gedeelde repository. Je kunt een sleutel ook zelf aanmaken via Instellingen → API & webhooks → Nieuwe API-sleutels genereren. Zie ChannelDock REST API-documentatie.

Wat de assistent kan uitlezen

Tool	Wat het doet
`query_user_data`	Toont en filtert de gegevens van je account, zoals orders, producten, voorraad, voorraadlocaties, zendingen, retouren, leveringen, taken, batches, logs en instellingen.
`search_products`	Zoekt een product op EAN, SKU of titel.
`get_product_summary`	Toont één product in detail.
`resolve_reference`	Zoekt uit waar een nummer of code bij hoort: een order (ook marketplace-ordernummers en `#`-nummers), product, retour, levering, verzendlabel of trackingcode, batch of voorraadlocatie.
`export_user_data`	Exporteert orders, producten, retouren, leveringen, voorraadhistorie (verkopers), voorraadlogs of voorraadlocaties naar CSV. Grote exports worden in de wachtrij gezet.
`find_portal_page`	Vindt het ChannelDock-scherm voor een instelling of functie.
`search_technical_knowledge`	Zoekt veldnamen, statuswaarden en foutcodes op in de ChannelDock-documentatie.

Wat de assistent kan wijzigen

De tools om te wijzigen heten meestal manage_*. Ze zijn gekoppeld aan ChannelDock API v2 en lopen via dezelfde API v2-controllers als de REST API, dus dezelfde validatie en rechtencontroles gelden. Eén aanroep kan tot 50 records aanmaken of bijwerken.

Onderdeel	Verkopers	Fulfillmentcenters
Producten en voorraad	Producten, producttags, bundels, variantgroepen	Voorraad van gekoppelde verkopers, voorraad in bulk bijwerken, producttags, bundels
Magazijn	Voorraadlocaties en -secties, leveranciers	Voorraadlocaties en -secties, verpakkingen, ladingdragertypes (pallets)
Orders en verzending	Orders en orderregels, zendingen met trackinggegevens, verzendlabels, verzendmethoden, batchstatus	Orders en orderregels, orders claimen, fulfillmentstatus, zendingen, verzendlabels, verzendmethoden, batchstatus
Inkomend	Leveringen	Inkomende leveringen, inclusief ontvangen artikelen op voorraad boeken
Retouren en taken	Retouren, retourbijlagen, taken	Retouren, retourbijlagen, taken
PIM	Marketplace-listings: aanmaken, bijwerken, valideren, publiceren en ophalen uit een gekoppelde winkel; listing-attributen en -afbeeldingen; PIM-gegevens opzoeken	–
Verkopers en facturatie	–	Gekoppelde verkopers (overzicht, of een nieuw verkopersaccount aanmaken dat aan je center gekoppeld is), facturatieprofielen, regels, presets en conceptfactuurexports

Voor een API v2-endpoint van jouw type account zonder eigen tool kan de assistent call_portal_api gebruiken.

Voorbeelden

Verkopers:

“Welke orders van gisteren hebben nog geen verzendlabel?”
“Hier is de productlijst van mijn leverancier. Maak de producten aan die nog niet in ChannelDock staan.”
“Meld een levering van deze leverancier aan voor deze producten, aankomst volgende dinsdag.”
“Maak een listing voor deze EAN op mijn gekoppelde marketplace en vul de verplichte attributen in.”
“Bij welke order hoort deze trackingcode?”

Fulfillmentcenters:

“Welke inkomende leveringen verwachten we deze week, en voor welke verkopers?”
“Maak voorraadlocaties aan voor gang A, stellingen 1 tot en met 10, met elk vier niveaus.”
“Maak een verkopersaccount aan voor dit bedrijf en koppel het aan ons center.” (Geef de contactgegevens zelf op. De assistent krijgt de instructie ze niet te verzinnen.)
“Hier is de offerte voor deze verkoper. Zet de facturatie ervoor op.”

Fulfillmentcenters: facturatie opzetten vanuit een prijslijst

Sleep een offerte of tarievenblad in Claude of ChatGPT en vraag de assistent de facturatie op te zetten. De MCP geeft de assistent de instructie om in deze volgorde te werken:

Kijken wat er al is: je verpakkingen, ladingdragertypes en facturatieprofielen.
Aanmaken wat ontbreekt: alleen de dozen en pallettypes uit de prijslijst die je nog niet hebt (manage_packaging, manage_load_carrier_types).
Profiel en regels aanmaken: een facturatieprofiel, en per prijs één regel, elk met een voorwaarde en tarief die in ChannelDock-facturatie bestaan (manage_invoicing_profiles, manage_invoicing_rules).
Het profiel aan de verkoper koppelen met een facturatiepreset (manage_invoicing_presets).
Het resultaat controleren: een conceptfactuurexport draaien over een recente periode en de samenvatting lezen: het totaal per verkoper, het bedrag per regel, en de zendingen waar geen regel voor verzendkosten op paste (manage_invoicing_exports).

Kan de assistent een prijs niet plaatsen, dan meldt hij dat in plaats van te gokken. Conceptexports blijven concept en er wordt niets naar je verkopers gestuurd. Controleer het profiel in ChannelDock voordat je een factuur verstuurt. Meer over facturatie: Aan de slag met Smart Invoicing.

Veiligheid en limieten

Dezelfde regels als de API: wijzigingen lopen via de API v2-controllers, met dezelfde validatie en rechtencontroles als de REST API.
De rechten van de sleutel gelden: de assistent krijgt alleen de wijzigingen die de Endpoint-machtigingen van de API-sleutel toestaan (Instellingen → API & webhooks, open de sleutel). Bij OAuth-koppelingen is dat de [MCP OAuth]-sleutel. Machtigingen stel je per endpoint in: een endpoint waarvoor je geen methode selecteert, blijft volledig open. Endpoint-machtigingen beperken wat de assistent kan wijzigen; de tools om uit te lezen blijven beschikbaar.
Verkoper en center blijven gescheiden: de verkopers-URL accepteert alleen verkopersaccounts, de center-URL alleen fulfillmentcenteraccounts.
Jij keurt OAuth-toegang goed: het toestemmingsscherm toont de app, het account en de URL. Alleen de accounteigenaar of een teamlid met adminrechten kan goedkeuren.
Tot 50 records per aanroep: grotere klussen verdeelt de assistent over meerdere aanroepen.
Limiet per uur: elk MCP-verzoek telt mee voor de uurlimiet van de API-sleutel. Standaard is dat 1.000 verzoeken per uur, net als bij de REST API.
AI-schakelaar: staan de AI-functies van het account uit, dan weigert de MCP elk verzoek.
Je AI-app verwerkt wat hij uitleest: gegevens die de assistent uitleest, worden verwerkt door de AI-app die je hebt gekoppeld. Controleer de privacy- en data-instellingen van die app.
Keur acties goed in je app: veel AI-apps kunnen om je goedkeuring vragen voordat een tool wordt uitgevoerd. Laat dat aan staan voor wijzigingen tot je je opzet vertrouwt.

Ontkoppelen

Verwijder de connector in je AI-app.
Verwijder de API-sleutel onder Instellingen → API & webhooks: de [MCP OAuth]-sleutel bij OAuth-koppelingen, of de sleutel die je zelf hebt gebruikt (bijvoorbeeld MCP / AI-agent). De koppeling werkt dan direct niet meer.
Zet de AI-functies uit om de MCP voor het hele account te sluiten.

Problemen oplossen

De MCP geeft foutmeldingen in het Engels.

Melding	Wat je doet
`AI features are turned off for this account.`	Vraag een admin om de AI-functies aan te zetten (zie Voordat je begint).
`On the free plan you are not allowed to use the API.`	Stap over op een betaald abonnement.
`This MCP endpoint is for seller accounts.` / `This MCP endpoint is for fulfillment center accounts.` / `Your account type does not match this MCP endpoint.`	Je hebt de URL van het andere type account gebruikt. Gebruik de verkopers-URL voor een verkopersaccount en de center-URL voor een fulfillmentcenter.
`You do not have permission to authorize MCP access for this account.`	Vraag de accounteigenaar of een teamlid met adminrechten om de koppeling te maken.
`Invalid API credentials.`	Controleer de API-sleutel en het secret, of maak een nieuwe sleutel aan.
`Invalid or expired OAuth access token.`	Koppel de connector in je AI-app opnieuw en sta de toegang opnieuw toe.
`Permission denied for …` / `Operation '…' is not available for this API key.`	De endpoint-machtigingen van de sleutel staan deze actie niet toe. Pas de machtigingen aan of gebruik een andere sleutel.
`API call limit exceeded. Please try again later.`	Wacht tot de uurlimiet weer is vrijgegeven.

Veelgestelde vragen

Ziet ChannelDock mijn gesprek met de AI-app? Nee. ChannelDock ontvangt de verzoeken die de assistent naar de MCP-server stuurt, bijvoorbeeld welke orders hij wil uitlezen of welk product hij wil aanmaken. Het gesprek zelf blijft in je AI-app.

Welke AI-apps kan ik gebruiken? Elke app die externe MCP-servers ondersteunt. Claude en ChatGPT koppelen met OAuth. Apps zoals Cursor koppelen met een API-sleutel in de headers.

Kan de assistent gegevens verwijderen? Sommige tools kunnen records verwijderen waar de API dat toestaat, bijvoorbeeld producten, voorraadlocaties of orders die nog niet verzonden zijn. Wil je dat niet, sta de methode DELETE dan niet toe in de endpoint-machtigingen van de sleutel, en keur acties goed in je AI-app.

Kunnen mijn teamleden koppelen? Een teamlid met adminrechten kan een OAuth-koppeling goedkeuren. API-sleutels kan alleen de accounteigenaar zien en aanmaken.

Was this helpful?