Le serveur TRYB Loyalty MCP permet à votre assistant IA de communiquer directement avec votre compte TRYB Loyalty.
Une fois connecté, vous pouvez gérer les clients, les cartes de fidélité, les modèles de cartes, les soldes et les flux de travail d'automatisation en posant simplement des questions — dans Claude, Cursor, VS Code ou tout autre client compatible MCP.
Il utilise le protocole Model Context Protocol via HTTP en continu et s'authentifie soit en vous connectant avec votre compte TRYB Loyalty (OAuth) — la méthode recommandée — soit avec une clé API personnelle.
Ce que vous pouvez faire une fois connecté
Clients et segments — créer, rechercher, mettre à jour et supprimer des clients ; lister les segments.
Modèles — créer des modèles de carte et gérer les niveaux de récompense, les niveaux d'adhésion et les liens de rétroaction.
Cartes — émettre des cartes, les rechercher, mettre à jour les champs et définir l'expiration et le niveau d'adhésion.
Soldes — ajouter ou soustraire des timbres, des points, des scores, des visites, des montants, des achats et des récompenses ; utiliser des coupons.
Emplacements — créer et gérer les emplacements de magasins.
Liens UTM — créer et gérer les liens de suivi UTM et lire leurs statistiques de récompense et d'inscription.
Flux de travail — créer, activer, mettre en pause, exécuter et inspecter les flux de travail d'automatisation et leurs journaux.
Services externes — connecter et gérer les intégrations tierces.
Marque blanche — gérer les domaines personnalisés, l'image de marque et les menus de sous-comptes pour les configurations de marque blanche.
Agences — rechercher des sous-comptes et agir en leur nom sur les plans Agence.
Propriété
Valeur
URL du serveur
https://api.trybloyalty.com/mcp
Transport
HTTP en continu
Authentification
OAuth 2.1 (recommandé) ou Authorization: Bearer <YOUR_API_KEY>
Méthode
POST
Utilisez-vous un domaine personnalisé ou une solution white-label ? Remplacez api.trybloyalty.com par votre propre hôte API partout ci-dessous (par exemple https://api.your-brand.com/mcp). La connexion fonctionne de la même manière sur n'importe quel domaine — chaque hôte est son propre émetteur.
Un compte TRYB Loyalty Business Plan qui inclut l'accès à l'API.
Un client compatible MCP tel que Claude Desktop, Claude Code, Cursor ou VS Code.
Node.js n'est nécessaire que pour la configuration de la clé API sur Claude Desktop (le proxy mcp-remote). La configuration OAuth ne nécessite rien de supplémentaire.
Il y a deux façons de vous authentifier. Choisissez-en une :
Se connecter avec OAuth (recommandé) — aucune clé à copier. Pointez votre client vers l'URL du serveur, puis connectez-vous avec votre identifiant TRYB Loyalty habituel dans le navigateur et approuvez l'accès. Votre client s'enregistre automatiquement et actualise son accès pour vous.
Clé API — envoyez un jeton Bearer personnel avec chaque requête. Idéal pour les clients sans support OAuth, les scripts et l'automatisation.
Vous donnez à votre client uniquement l'URL du serveur. À la première utilisation, il ouvre un navigateur, vous vous connectez à TRYB Loyalty et approuvez l'accès, et l'assistant est connecté — aucune clé API à copier ou stocker.
Claude Code
Claude Desktop / Claude.ai
Cursor
VS Code (Copilot)
Autres clients
Exécutez cette commande dans votre terminal :
Copier
claude mcp add --transport http tryb https://api.trybloyalty.com/mcpEnsuite, exécutez /mcp, sélectionnez tryb → Authenticate, et une fenêtre de navigateur s'ouvre pour que vous vous connectiez et approuviez. Vérifiez avec claude mcp list.
Permissions. Lorsque vous approuvez l'accès, l'assistant reçoit deux portées : mcp:read pour les outils en lecture seule, et mcp:write pour les outils qui créent, mettent à jour ou suppriment des données.
Utilisez ceci pour les clients qui ne supportent pas OAuth, ou pour les scripts et l'automatisation.
Connectez-vous à votre tableau de bord TRYB Loyalty.
Ouvrez Paramètres → API.
Copiez votre clé API personnelle.
Votre clé API vous accorde un accès complet à votre compte.
Traitez-la comme un mot de passe. Ne la partagez jamais. Ne la validez jamais dans un référentiel public. Renouvelez-la immédiatement si elle fuit.
Choisissez votre client ci-dessous et ajoutez la configuration.
Remplacez <YOUR_API_KEY> par la clé de l'étape précédente.
Claude Code
Claude Desktop
Cursor
VS Code (Copilot)
Autres clients
Exécutez cette commande dans votre terminal :
Copier
claude mcp add --transport http tryb https://api.trybloyalty.com/mcp \
--header "Authorization: Bearer <YOUR_API_KEY>"Vérifiez avec claude mcp list.
Après la connexion, demandez à votre assistant :
Utilisez l'outil whoami et dites-moi à quel compte vous êtes connecté.
Si la connexion fonctionne, elle retourne le nom de votre entreprise, le tarif, la devise et la locale.
Vous pouvez également lui demander de lister vos modèles de cartes ou lister vos clients pour confirmer que les outils fonctionnent de bout en bout.
Si votre compte est sur un tarif Agency ou Agency Partner , vous disposez également d'outils pour travailler sur plusieurs sous-comptes :
search_companies et get_company — trouvez et inspectez les sous-comptes et les parrainages.
impersonate_company — basculez la session pour agir au nom d'un sous-compte.
stop_impersonation — retournez à votre propre contexte d'agence.
L'usurpation d'identité est limitée à la session et expire automatiquement après 1 heure.
Préférez OAuth — aucun secret de longue durée n'est stocké dans les fichiers de configuration de votre client.
Si vous utilisez une clé API, stockez-la dans une variable d'environnement ou dans le magasin de secrets de votre client.
Utilisez une clé dédiée pour les assistants IA afin de pouvoir la renouveler indépendamment.
Renouvelez la clé immédiatement si vous soupçonnez qu'elle a été exposée.
Symptôme
Cause probable et solution
La connexion au navigateur ne se termine pas
Assurez-vous d'être connecté au bon compte TRYB Loyalty dans ce navigateur, puis réessayez. Supprimez et rajoutez le serveur pour redémarrer le flux.
401 Unauthorized
Avec OAuth, relancez la connexion. Avec une clé API, la clé est manquante, mal saisie, ou votre forfait n'inclut pas l'accès à l'API — recopiez-la depuis Paramètres → API et confirmez votre tarif.
Les outils n'apparaissent pas
Le client n'a pas été complètement redémarré. Quittez et rouvrez-le. Pour Claude Desktop, quittez complètement l'application.
npx ou erreurs mcp-remote
Node.js n'est pas installé ou ne se trouve pas sur votre PATH. Installez Node.js et réessayez. (Seule la configuration Claude Desktop avec clé API en a besoin.)
La connexion fonctionne mais les actions échouent
L'action peut ne pas être disponible sur votre forfait, ou un champ obligatoire peut être manquant. Vérifiez le message d'erreur renvoyé pour la réponse du serveur.