Brancher un assistant IA
Le serveur MCP de StampyWallet relie Claude, ChatGPT, Cursor ou un agent à votre carte de fidélité. Une adresse, aucune clé, et rien ne change sans votre accord.
StampyWallet parle le Model Context Protocol (MCP), le standard qui permet à un assistant IA d'utiliser des outils. Une fois branché, vous pouvez demander en conversation : « dessine-moi une carte de fidélité », « combien de clients sont venus ce mois-ci ? », « préviens mes habitués que je ferme lundi ».
L'adresse du serveur
https://app.stampywallet.com/mcpHTTP « streamable », réponses JSON, sans état. C'est la seule chose à donner à votre assistant.
Paramètres › Connecteurs › Ajouter un connecteur personnalisé, collez l'adresse. Le pas à pas : Claude.
Paramètres › Applications et connecteurs, mode développeur, Créer, collez l'adresse. Le pas à pas : ChatGPT.
{
"mcpServers": {
"stampywallet": { "url": "https://app.stampywallet.com/mcp" }
}
}Le pas à pas, et Claude Code : Cursor et agents.
Sans compte, puis avec votre compte
Le serveur sert deux familles d'outils sur la même adresse :
- Sans compte :
concevoir_cartedessine une carte à l'image d'un commerce,simuler_fidelitechiffre ce qu'elle coûte, etcreer_commercela met en service et rend un lien pour en devenir propriétaire. Aucune connexion n'est demandée. - Avec votre compte : vos chiffres, vos clients, vos messages, les avis Google, les réglages de la carte, l'affichette, l'équipe. Au premier appel, l'assistant ouvre la page de connexion StampyWallet (OAuth) : vous vous connectez, choisissez le commerce, et autorisez l'accès.
À l'écran d'autorisation, vous pouvez cocher lecture seule : l'assistant lit vos chiffres et vos réglages, mais ne peut rien changer. Les accès se gèrent dans Réglages › Vos données › Assistants connectés, où chaque assistant se coupe d'un clic.
| Portée | Ce qu'elle permet |
|---|---|
stampy.lecture | Lire vos chiffres, vos clients (prénoms), vos réglages et votre carte |
stampy.ecriture | Agir pour vous : messages aux clients, réglages, carte, équipe, toujours après votre accord dans la conversation |
Rien ne change sans votre accord
Les outils qui écrivent prennent un paramètre confirmer, false par défaut. Appelés ainsi, ils ne font rien : ils rendent un aperçu (le texte exact d'un message et le nombre de destinataires, l'avant et l'après d'un réglage). L'assistant vous le montre, et ne rappelle l'outil avec confirmer: true qu'après votre « oui ».
Attention : deux choses ne se font qu'au comptoir, en scannant la carte du client : poser des tampons et offrir des récompenses. Aucun outil MCP ne le fait. Pour les poser depuis une caisse, il y a l'API.
Les outils
| Outil | Compte | Effet |
|---|---|---|
concevoir_carte | Sans | Lecture seule |
simuler_fidelite | Sans | Lecture seule |
creer_commerce | Sans | Écrit (confirmer) |
tableau_de_bord | Avec | Lecture seule |
rentabilite | Avec | Lecture seule |
meilleurs_moments | Avec | Lecture seule |
chercher_clients | Avec | Lecture seule |
fiche_client | Avec | Lecture seule |
envoyer_message | Avec | Écrit (confirmer) |
historique_messages | Avec | Lecture seule |
regler_automatismes | Avec | Écrit (confirmer) |
fermetures | Avec | Écrit (confirmer) |
avis_google | Avec | Écrit (confirmer) |
voir_carte | Avec | Lecture seule |
modifier_carte | Avec | Écrit (confirmer) |
fiche_commerce | Avec | Écrit (confirmer) |
affichette | Avec | Lecture seule |
envoyer_affichette | Avec | Écrit (confirmer) |
equipe | Avec | Écrit (confirmer) |
Les outils qui demandent un compte suivent aussi votre rôle (un employé n'a accès à aucun ; equipe est réservé au propriétaire) et votre formule (certains chiffres et les avis Google demandent Croissance).
Essayer à la main
Le serveur répond à n'importe quel client MCP, ou à curl :
curl https://app.stampywallet.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Sans compte, les appels sont limités par adresse IP : au-delà, le serveur demande d'attendre quelques minutes.
Questions fréquentes
Faut-il une clé pour brancher le serveur MCP ?
Non, aucune clé. Les outils sans compte marchent tout de suite ; pour vos chiffres et vos clients, l'assistant vous fait connecter votre compte StampyWallet au premier appel.
Est-ce que ça marche avec ChatGPT gratuit ?
Côté StampyWallet, rien n'est à payer pour brancher le serveur, et les outils sans compte sont ouverts à tous. Côté ChatGPT, le connecteur se crée en mode développeur, dont l'accès dépend de votre offre ChatGPT. Si la vôtre ne le propose pas, Claude, Cursor ou tout autre client MCP se branchent à la même adresse.
L'assistant peut-il changer quelque chose sans mon accord ?
Non. Les outils qui écrivent rendent d'abord un aperçu, et l'assistant ne les rappelle avec confirmer: true qu'après votre « oui ». Vous pouvez aussi n'autoriser que la lecture seule.
L'assistant peut-il poser des tampons ?
Non. Poser des tampons et offrir des récompenses se fait uniquement au comptoir, en scannant la carte du client. Depuis une caisse, c'est la route Ajouter un passage de l'API qui le fait.
Comment couper l'accès d'un assistant ?
Dans Réglages › Vos données › Assistants connectés : chaque assistant se coupe d'un clic.
Mis à jour le