QrX koppelen aan uw AI-assistent (MCP)

U kunt QrX koppelen aan een AI-assistent zoals Claude, ChatGPT of Cursor. Daarna stelt u vragen in gewone taal, bijvoorbeeld "Welke producten hebben weinig voorraad?", "Hoeveel orders wachten op inpakken?", "Wat is de betaalstatus van order 10452?" of "Wat heeft vandaag mijn aandacht nodig?". De assistent leest het antwoord rechtstreeks uit uw QrX-account. Als u het toestaat, kan de assistent ook een klein aantal magazijnwijzigingen doen, altijd nadat u bevestigt.

De koppeling gebruikt MCP (Model Context Protocol), de open standaard waarmee AI-assistenten met andere software praten. QrX heeft een MCP-server; uw assistent koppelt daaraan als aangepaste connector.

Wie het kan gebruiken

De AI-connector is inbegrepen in de betaalde QrX-abonnementen. Er is geen aparte prijs.
U logt in met uw eigen QrX-portaalaccount. De assistent krijgt dezelfde rechten als u in QrX hebt, nooit meer.
Vragen over voorraad en magazijn en magazijnwijzigingen vereisen de module QrX Warehouse (WMS). Vragen over retouren vereisen het recht om retouren te beheren in uw QrX-rol. Tools voor een module die u niet gebruikt, worden niet aan de assistent getoond.
QrX-beheeraccounts kunnen niet koppelen. Kijkt u in PortalX mee als een andere gebruiker, stop daar dan eerst mee en log in met uw eigen account.
CRM-vragen vereisen de CRM-rechten in je QrX-rol (elk QrX-account heeft het gratis CRM-plan). CRM-wijzigingen vereisen ook het recht om het CRM te bewerken.

Wat u nodig hebt

Een AI-assistent die aangepaste MCP-connectors ondersteunt (ook wel remote MCP-servers of custom apps genoemd).
De URL van de QrX MCP-server: https://api.qr-x.net/mcp
Uw QrX-portaalaccount (het account dat u gebruikt op portal.qr-x.app).

Zo koppelt u (elke assistent)

Open in uw AI-assistent de plek waar u connectors toevoegt en kies voor een aangepaste connector (of een aangepaste MCP-server).
Geef hem een naam, bijvoorbeeld "QrX", en vul de server-URL https://api.qr-x.net/mcp in. U hebt geen API-sleutel, client-ID of secret nodig.
Start het inloggen. Het QrX-portaal opent. Log in met uw QrX-portaalaccount als u nog niet bent ingelogd.
De QrX-pagina "[assistent] koppelen aan QrX" toont de app, waar u naar teruggestuurd wordt en een lijst van wat de assistent mag lezen. Vink alleen aan wat u wilt delen. Zie "Wat de QrX AI-connector wel en niet kan" voor de betekenis van elke optie.
Optioneel: vink Magazijnwijzigingen aan als de assistent ook magazijnwijzigingen mag doen. Dit staat standaard uit en vereist Voorraad en magazijn.
Optioneel: vink CRM-wijzigingen aan als de assistent CRM-personen, bedrijven, deals, notities en taken mag aanmaken of bijwerken, deals mag verplaatsen en een gesprek mag starten. Het staat standaard uit en vereist CRM.
Optioneel: vink Berichtencentrum-antwoorden, Retourafhandeling, Ordertags of Productwijzigingen aan als de assistent ook mag antwoorden in gesprekken, retouren mag afhandelen, ordertags mag wijzigen of een product offline mag halen en de voorraad mag instellen. Elke optie staat standaard uit en heeft zijn leesoptie nodig (Berichttekst, Retouren, Orders, Producten). Zie "De QrX AI-koppeling gebruiken voor gesprekken, retouren, orders en producten".
Klik op Toestaan. U keert terug naar uw assistent en de koppeling is klaar. Klik op Weigeren om te annuleren zonder te koppelen.

De nieuwe koppeling staat nu in QrX onder Instellingen > Geavanceerd > Gekoppelde apps.

Stappen per assistent

Menunamen in AI-assistenten veranderen vaak. Klopt een stap hieronder niet met wat u ziet, volg dan de algemene stappen hierboven en de helppagina's van uw assistent. De menunamen staan hieronder in het Engels, zoals in de assistent.

Claude (Free, Pro en Max): ga naar Customize > Connectors, klik op + en daarna op Add custom connector, vul de naam en de URL https://api.qr-x.net/mcp in, ga verder en log in met QrX. Zet de connector aan in een chat met de knop +, Connectors. Met het Claude Free-abonnement kunt u één aangepaste connector toevoegen.
Claude (Team en Enterprise): een Owner voegt de connector één keer toe onder Organization settings > Connectors, Add, Custom, Web, met dezelfde URL. Elk lid gaat daarna naar Customize > Connectors, zoekt QrX en klikt op Connect om in te loggen met het eigen QrX-account.
ChatGPT (Business, Enterprise en Edu): aangepaste MCP-apps vereisen de developer mode, die een workspace-beheerder aanzet. Ga daarna naar Settings > Apps > Create (beheerders kunnen ook Workspace settings gebruiken), vul de URL https://api.qr-x.net/mcp in, kies OAuth, klik op Scan Tools, log in met QrX en klik op Create.
Cursor: voeg QrX toe als remote MCP-server met de URL https://api.qr-x.net/mcp (in de MCP-instellingen of in mcp.json) en log in met QrX wanneer Cursor daarom vraagt.

Iedereen koppelt met het eigen QrX-account, ook als een connector in een team-workspace gedeeld is. De assistent ziet dan alleen wat die persoon in QrX mag zien.

Goed om te weten

"Niet geverifieerd" op de koppelpagina betekent dat QrX de app niet heeft geverifieerd en dat de app zijn eigen naam heeft gekozen. Ga alleen verder als u de koppeling zelf bent gestart vanuit een assistent die u vertrouwt. De pagina toont waar uw gegevens naartoe gaan.
Wat de assistent leest, wordt naar het bedrijf achter uw AI-assistent gestuurd, zodat het u kan antwoorden. Deel alleen wat nodig is. Berichttekst wordt nooit gedeeld, tenzij u Berichttekst aanvinkt.
U kunt altijd ontkoppelen via Instellingen > Geavanceerd > Gekoppelde apps. Zie "Een gekoppelde AI-app ontkoppelen (intrekken)".
Meer over de QrX AI-connector: qrx.eu/mcp.

Veelvoorkomende problemen

"Deze koppellink is niet geldig": de link is verlopen of al gebruikt. Start het koppelen opnieuw vanuit uw AI-assistent.
"Log in om verder te gaan": uw QrX-sessie is beëindigd. Log opnieuw in en het koppelen gaat verder.
"Je account kan geen apps koppelen": uw account heeft geen toegang tot het QrX-portaal. Vraag een beheerder van uw bedrijf om toegang.
"QrX-beheeraccounts kunnen niet koppelen": log in met een merchantaccount.
Een optie op de koppelpagina is grijs: "Deze module is niet actief op je account" betekent dat u die QrX-module niet gebruikt. "Je rol staat dit niet toe" betekent dat uw QrX-rol het recht mist; vraag een beheerder van uw account.
De assistent zegt dat hij geen toegang heeft of vraagt opnieuw in te loggen: de koppeling is beëindigd, bijvoorbeeld in Gekoppelde apps, doordat u op alle apparaten bent uitgelogd of na een wachtwoordreset. Koppel opnieuw.
De assistent zegt dat een limiet is bereikt: wacht een minuut en probeer het opnieuw. Zie de limieten in "Wat de QrX AI-connector wel en niet kan".

Wanneer neemt u contact op met ons supportteam

Neem contact op met QrX support als u de stappen hebt gevolgd en het koppelen nog steeds mislukt, als u in Gekoppelde apps een koppeling ziet die niemand in uw bedrijf herkent, of als de assistent gegevens toont die hij volgens u niet mag zien. Vermeld de assistent die u gebruikt, het tijdstip van de poging en de exacte melding op het scherm. Stuur nooit wachtwoorden of tokens.