---
title: "MCP"
description: "Connectez le serveur MCP TRYB Loyalty à Claude, Cursor, VS Code et autres assistants IA, et gérez votre programme de fidélité en langage naturel."
url: https://help.tryb.business/fr/articles/86-mcp
collection: "API"
updated: 2026-08-18
language: fr
alternates: [en, es]
---

# MCP

Connectez le serveur MCP TRYB Loyalty à Claude, Cursor, VS Code et autres assistants IA, et gérez votre programme de fidélité en langage naturel.

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](https://modelcontextprotocol.io/) 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.
    

#### **Détails de connexion**

**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.

#### **Avant de commencer**

-   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](https://nodejs.org/) 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.
    

#### **Choisissez comment vous connecter**

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.
    

### **Option 1 — Se connecter avec OAuth (recommandé)**

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

```javascript
claude mcp add --transport http tryb https://api.trybloyalty.com/mcp
```

Ensuite, 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.

### **Option 2 — Se connecter avec une clé API**

Utilisez ceci pour les clients qui ne supportent pas OAuth, ou pour les scripts et l'automatisation.

### **Obtenir votre clé API**

1.  Connectez-vous à votre **tableau de bord TRYB Loyalty**.
    
2.  Ouvrez **Paramètres → API**.
    
3.  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.

### **Ajouter le serveur à votre assistant IA**

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

```javascript
claude mcp add --transport http tryb https://api.trybloyalty.com/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"
```

Vérifiez avec `claude mcp list`.

### **Vérifier la connexion**

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.

#### **Comptes d'agence**

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.

#### **Bonnes pratiques de sécurité**

-   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.
    

#### **Dépannage**

**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](https://nodejs.org/) 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.
