Claude of ChatGPT koppelen aan je Leat-account (AI Assistant-integratie)

Wat het is

Met de AI Assistant-integratie kan een AI-client zoals Claude of ChatGPT je Leat-accounts lezen via het Model Context Protocol (MCP). Je stelt vragen in gewone taal, en de assistent gebruikt de tools van Leat om het antwoord in je eigen data op te zoeken. Via de connector verandert er niets in je accounts: hij leest alleen. Beloningen, spaarregels, lijsten, formulieren en campagnes maak of bewerk je in het Leat-dashboard, waar de Leat-assistent dat voor je kan doen.

Voordat je begint

• Je bent beheerder van elk Leat-account dat de assistent mag lezen.
• Ga in elk van die accounts naar Apps → Integraties, zoek naar AI Assistant en klik op Installeren.
• De integratiepagina toont de Connector-URL: https://api.leat.com/api/mcp. Die is voor elk account hetzelfde.

Claude koppelen

1. Open in Claude (web, desktop of mobiel) Settings → Connectors.
2. Voeg Leat toe vanuit de directory. Staat Leat er nog niet tussen, kies dan Add custom connector en plak de connector-URL.
3. Claude opent Leat. Log zo nodig in met je Leat-login.
4. Het toestemmingsscherm noemt de applicatie die om toegang vraagt en toont alle accounts die hij kan lezen. Controleer de lijst en klik op Toestaan. Gaat het om één account, dan bepaal je hier ook of de assistent persoonlijke klantgegevens mag zien.
5. Begin terug in Claude een chat en vraag bijvoorbeeld: "Hoe doet mijn loyaltyprogramma het?".

ChatGPT koppelen

1. Open Settings in de ChatGPT-desktopapp.
2. Kies Plug-ins en open daarna het tabblad MCPs.
3. Klik op Add server, geef hem een naam en kies Streamable HTTP.
4. Plak de connector-URL en klik op Save.
5. Klik terug in de serverlijst op Authenticate. Log in bij Leat in je browser, controleer de accounts en sta toegang toe.

Je hebt de ChatGPT-desktopapp en een betaald ChatGPT-abonnement nodig om het tabblad MCPs te zien.

Welke accounts de assistent kan lezen

Eén koppeling bereikt elk account waar je beheerder bent en waar de AI Assistant-integratie geïnstalleerd en actief is. Dat wordt bij elk verzoek opnieuw gecontroleerd:

• Een account waar je de integratie later activeert, komt er direct bij, zonder opnieuw te koppelen.
• Deactiveer je de integratie in een account, of ben je daar geen beheerder meer, dan valt dat account er direct af.

Kan een vraag over meer dan één account gaan, dan vraagt de assistent welk account je bedoelt. Heb je dat gezegd, dan blijft hij bij dat account tot je een ander noemt. Wil je accounts vergelijken, vraag daar dan om.

Een koppeling die je eerder maakte, toen het toestemmingsscherm je één account liet kiezen, blijft aan dat account vastzitten. Wil je dat de assistent al je accounts leest, verwijder dan de connector in Claude of ChatGPT en koppel opnieuw.

Andere MCP-clients

Elke MCP-client die OAuth ondersteunt, kan de connector-URL gebruiken. Een client die zonder toezicht draait en geen browser kan openen, kan in plaats daarvan een persoonlijk toegangstoken gebruiken: maak er een aan op het tabblad Auth van de integratiepagina en stuur het mee als Bearer-token. Zo'n token hoort bij dat ene account, is 90 dagen geldig en je kunt het op hetzelfde tabblad roteren of intrekken.

Wat de assistent kan zien

Alles is beperkt tot de accounts die de koppeling bereikt, en tot wat jouw eigen rol in Leat mag zien.

• Programma: instellingen, niveaus en niveau-mijlpalen, spaarregels, de beloningscatalogus met de zichtbaarheidsfilters, promoties, segmenten, je locaties en de gebruikers die toegang hebben tot het account.
• Contacten en transacties: recente bestellingen en hun betalingen; waarom een bestelling wel of geen punten of stempels opleverde; waarom een contact een beloning niet kan claimen; een voucher op zijn code, inclusief of hij nog te gebruiken is en waar hij is verzilverd; een cadeaukaart op zijn hash, met saldo en transacties; prepaidsaldo's; de stempelkaarten van een contact, of één kaart op de code van zijn QR-code: de stempels erop, volle kaarten die klaar zijn om in te wisselen, wanneer de stempels verlopen, en de stempels en inwisselingen die erop zijn geboekt; de loyaltystatus van een contact (punten, niveau, inschrijvingen, lijsten, kaarten, wallet pass); kassasessies voor Lightspeed K-Series-accounts.
• Problemen aan de kassa: waarom een beloning, voucher of stempelkaart niet aan de kassa kan worden ingewisseld, met de oorzaak, hoe je het oplost en de locaties waar het misging. Voor Lightspeed K-Series-accounts geeft hij ook aan welke Lightspeed-instellingen je moet controleren, in volgorde.
• Marketing: e-mailcampagnes met hun statistieken en voucherattributie; terugkerende e-mails met hun runs en statistieken; geautomatiseerde e-mails met hun statistieken; automatiseringen, wat elke automatisering doet en hoe die is gelopen; formulieren en hun inzendingen; de status van je e-maildomeinen (SPF, DKIM, DMARC) en afzenderprofielen.
• Business App: je Business App-configuraties met de instellingen waarop elk apparaat draait, en je gekoppelde apparaten met hun bedrijfsprofiel, appversie en wanneer ze voor het laatst zijn gezien. Koppelcodes voor nieuwe apparaten worden nooit getoond.
• Data: je imports en exports, gegenereerde batches en notificaties, en hoe die zijn verlopen.
• Analytics: geaggregeerde vragen over contacten, puntentransacties, bestellingen, cadeaukaarttransacties, voucherverzilveringen, bezoeken en reserveringen. De resultaten zijn aggregaten, maximaal 1000 rijen.
• Helpcenter: de assistent kan deze supportartikelen doorzoeken.

Wat de assistent niet kan

Iets wijzigen. De connector heeft geen enkele tool die iets aanmaakt, bewerkt of verwijdert, dus een gekoppelde assistent kan geen beloning toevoegen, geen regel veranderen, geen lijst bouwen en geen campagne versturen, wat je hem ook vraagt. Daarvoor gebruik je de Leat-assistent in het dashboard of het dashboard zelf.

Persoonlijke klantgegevens

Standaard ziet de assistent niet wie een contact is. Hij krijgt loyaltystatus, saldo's en aggregaten, maar namen, e-mailadressen, telefoonnummers, geboortedatums en adressen worden achtergehouden, ook binnen filterdefinities.

Persoonlijke gegevens delen stel je per account in, met Toegang tot persoonlijke klantgegevens toestaan op het tabblad Machtigingen van de integratiepagina van dat account. Het tabblad verschijnt zodra de integratie is geïnstalleerd. Bereikt je koppeling één account, dan toont het toestemmingsscherm dezelfde schakelaar. Bereikt hij er meer, dan toont het toestemmingsscherm per account of het persoonlijke gegevens deelt, en wijzig je dat op het tabblad Machtigingen van dat account. Je kunt het op elk moment weer uitzetten; het volgende verzoek volgt de nieuwe instelling.

Toegang stoppen

Elk van deze stappen stopt de assistent direct:

• Verwijder de connector in Claude of ChatGPT. Dat stopt de toegang tot alle accounts.
• Deactiveer of verwijder de integratie onder Apps → Integraties → AI Assistant. Dat stopt de toegang tot dat account.
• Verwijder de persoon die de koppeling heeft goedgekeurd als beheerder van een account. De toegang hangt aan diens rol en wordt bij elk verzoek gecontroleerd.
• Voor een persoonlijk toegangstoken: trek het in op het tabblad Auth.

Beveiliging

• Inloggen gebeurt via OAuth 2.1 met PKCE. De AI-client ziet je Leat-wachtwoord nooit.
• Toegangstokens verlopen na 24 uur en worden automatisch vernieuwd zolang de koppeling goedgekeurd blijft.
• Elk verzoek wordt gecontroleerd tegen je huidige rol op het account dat het leest.
• Een koppeling bereikt alleen de accounts waar je beheerder bent en waar de AI Assistant-integratie actief is. Een verzoek voor een ander account wordt geweigerd, ook met een geldige login.

Problemen oplossen

• "Couldn't connect" in Claude: controleer of de integratie actief is in minstens één account waar je beheerder bent, onder Apps → Integraties → AI Assistant.
• Er ontbreekt een account: de integratie is in dat account niet geïnstalleerd of niet actief, of je bent daar geen beheerder. Los dat op en het account komt er bij het volgende verzoek bij.
• De assistent leest maar één account: de koppeling is gemaakt toen je op het toestemmingsscherm één account koos. Verwijder de connector en koppel opnieuw.
• De assistent vraagt welk account je bedoelt: je koppeling bereikt meer dan één account. Noem het account in je vraag.
• De assistent zegt dat een tool niet beschikbaar is: je rol in Leat omvat dat onderdeel niet, of de integratie in dat account heeft die machtiging niet.
• De assistent zegt dat hij iets niet kan aanmaken of wijzigen: dat is zo bedoeld. De connector leest alleen; de Leat-assistent in het dashboard kan de wijziging doen.
• Cijfers komen niet overeen met het dashboard: vraag de assistent welke periode hij heeft geteld. Analytics-tools antwoorden in hele dagen in de tijdzone van het account.

Support

Mail naar support@leat.com of gebruik de chat in het dashboard.