Skip to main content
Qargo

INTEGRATIES - ChatGPT: via MCP verbinden met Qargo - Stappenplan

Het Qargo-account met ChatGPT verbinden en ChatGPT daarna vragen stellen over live gegevens. Bij Business-, Enterprise- en Education-abonnementen publiceert een eigenaar van de werkruimte eerst de Qargo-app. Bij Plus en Pro voegt de gebruiker de app zelf toe.

Inhoudsopgave
  1. Vereisten
  2. Business, Enterprise en Education: de app publiceren
  3. Het Qargo-account verbinden
  4. Plus en Pro: de connector zelf toevoegen
  5. Gegevens wijzigen
  6. Probleemoplossing

Vereisten

  • Qargo Intelligence op de tenant. MCP maakt deel uit van de add-on Qargo Intelligence. Zonder deze add-on contact opnemen met de accountmanager.
  • MCP-toegang ingesteld voor de gebruiker. Een super admin in de organisatie stelt deze in via Configuratie > Instellingen organisatie > Gebruikers. Een aanvraag bij Qargo is niet nodig. Zie INTEGRATIES - Een AI-assistent via MCP met Qargo verbinden voor de stappen.
  • De gewone Qargo-inloggegevens. Er is geen aparte sleutel of token.
  • ChatGPT op het web. Aangepaste MCP-apps werken niet in de mobiele apps van ChatGPT.
Abonnement Wie voegt de Qargo-app toe Mogelijkheden
Business, Enterprise of Education Een admin of eigenaar, eenmalig voor de werkruimte Gegevens lezen en wijzigen, afhankelijk van het MCP-toegangsniveau in Qargo
Plus of Pro De gebruiker zelf, voor eigen gebruik Alleen gegevens lezen. OpenAI beperkt aangepaste connectoren bij individuele abonnementen tot lezen en ophalen
Free Niemand. Aangepaste connectoren vereisen een betalend abonnement. Niets

Business, Enterprise en Education: de app publiceren

Een admin of eigenaar voegt de Qargo-app eenmalig toe. Daarna authenticeren de leden zich elk afzonderlijk.

Vereisten

  • Admin- of eigenaarsrechten. Alleen admins en eigenaars kunnen de ontwikkelaarsmodus inschakelen en een app publiceren. Een admin kan de ontwikkelaarsmodus niet namens een lid inschakelen.
  • MCP-toegang ingesteld in Qargo voor de gebruikers die deze nodig hebben. Een super admin stelt deze per gebruiker in via Configuratie > Instellingen organisatie > Gebruikers. Dit vóór het publiceren doen, zodat leden zich meteen kunnen authenticeren.

Ontwikkelaarsmodus inschakelen

Aangepaste MCP-apps zijn alleen beschikbaar in de ontwikkelaarsmodus, en elke admin schakelt die voor zichzelf in.

  • Business. Instellingen > Apps > Geavanceerde instellingen openen en de ontwikkelaarsmodus inschakelen. Dit kan ook tijdens het aanmaken van de app.
  • Enterprise en Education. Een admin verleent eerst toegang via Werkruimte-instellingen > Machtigingen en rollen > Verbonden gegevens. Elke gemachtigde persoon schakelt de modus daarna in via Instellingen > Apps > Geavanceerde instellingen.

De Qargo-app toevoegen en publiceren

  1. Navigeren naar Werkruimte-instellingen > Apps en vervolgens op Maken klikken.
  2. Invoeren: Qargo als naam en https://mcp.qargo.com/mcp als endpoint.
  3. Selecteren: OAuth als authenticatiemethode. Client-ID en secret leeg laten; Qargo geeft geen van beide uit.
  4. Klikken op Tools scannen, de inlogprompt voltooien wanneer die verschijnt en wachten tot de scan klaar is.
  5. Klikken op Maken. De app verschijnt onder Werkruimte-instellingen > Apps > Concepten.
  6. Testen: het concept vóór het publiceren in een nieuwe chat uitproberen.
  7. Publiceren vanuit Concepten en daarna instellen wie toegang heeft.

Bepalen wie de app kan gebruiken

Publiceren maakt de app beschikbaar. Het geeft niemand toegang tot Qargo-gegevens.

  • Gebruikerstoegang instellen, zodat alleen de bedoelde personen de app kunnen gebruiken. Bij Enterprise en Education kan vóór het publiceren ook gekozen worden welke acties de app mag uitvoeren.
  • Actiebevestiging instellen om te bepalen wanneer ChatGPT om bevestiging vraagt voordat een tool wordt aangeroepen.
  • Qargo-rechten aan Qargo overlaten. Elk lid authenticeert zich afzonderlijk en krijgt alleen de eigen rechten in Qargo.

De leden vragen de stappen in de volgende sectie te volgen.


Het Qargo-account verbinden

De Qargo-app hoort al in de lijst met apps te staan. Als dat niet zo is, contact opnemen met de admin van de werkruimte. Leden kunnen de app niet zelf toevoegen.

  1. Openen: de Qargo-app in ChatGPT.
  2. Inloggen met de gewone Qargo-inloggegevens wanneer de browser opent.
  3. Goedkeuren: het toegangsverzoek. De browser keert terug naar ChatGPT.
  4. Selecteren: de Qargo-app voor het bericht, en ChatGPT vervolgens vragen de Qargo-tenants op te sommen. Een antwoord met de naam van de tenant bevestigt dat de verbinding werkt.

Plus en Pro: de connector zelf toevoegen

Bij een individueel betalend abonnement is het niet nodig op een admin te wachten, maar Qargo-gegevens kunnen alleen gelezen worden, niet gewijzigd. Aangepaste connectoren zijn alleen beschikbaar in de ontwikkelaarsmodus, in de webapp.

  1. Openen: de instellingen van ChatGPT, daarna Apps > Geavanceerde instellingen, en de ontwikkelaarsmodus inschakelen.
  2. Klikken op Maken om een aangepaste connector toe te voegen.
  3. Invoeren: Qargo als naam en https://mcp.qargo.com/mcp als endpoint.
  4. Selecteren: OAuth als authenticatiemethode. Client-ID en secret leeg laten.
  5. Scannen: de tools, daarna inloggen met de gewone Qargo-inloggegevens en het toegangsverzoek goedkeuren.
  6. Selecteren: de connector voor het bericht, en ChatGPT vervolgens vragen de Qargo-tenants op te sommen.

Gegevens wijzigen

Dit geldt voor werkruimtes met Business, Enterprise en Education. Bij Plus en Pro kan ChatGPT Qargo-gegevens lezen, maar niet wijzigen.
De eerste wijziging aan productiegegevens in een sessie wordt tegengehouden en ChatGPT geeft een goedkeuringslink terug. De link openen, goedkeuren en ChatGPT vragen het opnieuw te proberen. De volledige stappen staan in INTEGRATIES - Een AI-assistent via MCP met Qargo verbinden.


Probleemoplossing

Probleem Oplossing
De Qargo-app staat niet in de lijst met apps De app is nog niet gepubliceerd in de werkruimte. Contact opnemen met de admin van de werkruimte. Bij Plus of Pro de app zelf toevoegen met de stappen hierboven.
De toggle voor de ontwikkelaarsmodus ontbreekt Het abonnement bevat deze niet, of de toegang is niet verleend op werkruimteniveau. Bij Enterprise en Education verleent een admin eerst toegang, onder Machtigingen en rollen > Verbonden gegevens. Dit is beleid, geen fout.
Aangepaste connectoren zijn niet te vinden op de telefoon Aangepaste MCP-apps werken alleen op het web. ChatGPT in een browser gebruiken.
Het scannen van de tools levert niets op Controleren of het endpoint precies https://mcp.qargo.com/mcp is. Een schuine streep aan het einde of een ontbrekend pad verhindert dat de tools gevonden worden.
De app is gepubliceerd, maar leden zien geen Qargo-tools De leden hebben zich nog niet geauthenticeerd, of hun MCP-toegang staat nog op Uitgeschakeld in Configuratie > Instellingen organisatie > Gebruikers. Beide controleren.
Toolaanroepen mislukken sinds een update van Qargo ChatGPT gebruikt de lijst met tools die bij het publiceren van de app is vastgelegd. De admin vragen de acties van de app te vernieuwen via Werkruimte-instellingen > Apps. Bij Business-abonnementen moet de app opnieuw aangemaakt en opnieuw gepubliceerd worden.
ChatGPT meldt dat MCP-toegang niet is ingeschakeld voor de gebruiker De toegang staat nog op Uitgeschakeld. Een super admin vragen deze in te stellen via Configuratie > Instellingen organisatie > Gebruikers.
Qargo vraagt steeds opnieuw om in te loggen Sessies verlopen, in de praktijk ongeveer één keer per dag, dus af en toe opnieuw authenticeren is normaal. Als het veel vaker gebeurt, contact opnemen met Qargo support.
De browser toont bij het inloggen een fout over een onbekende client De admin van de werkruimte vragen de app te verwijderen en opnieuw te publiceren. Dit kan gebeuren na een update van het Qargo-platform.
ChatGPT negeert Qargo en antwoordt op basis van algemene kennis De Qargo-app selecteren voor dat bericht en Qargo in de vraag noemen.
Lezen werkt, maar een wijziging wordt geweigerd De gebruiker heeft Alleen lezen in Qargo, wat een super admin kan wijzigen via Configuratie > Instellingen organisatie > Gebruikers, of gebruikt ChatGPT Plus of Pro, waar aangepaste connectoren beperkt zijn tot lezen.