Model Context Protocol (MCP)
Connectez des assistants IA à la documentation The Wallet Crew et aux données d’environnement via le Model Context Protocol (MCP).
The Wallet Crew fournit des serveurs Model Context Protocol (MCP) pour la documentation et les opérations de la plateforme. Un assistant IA compatible MCP peut les utiliser pour récupérer les consignes actuelles, examiner les données du locataire et prendre en charge l'analyse opérationnelle.
Chaque environnement dispose de son propre serveur MCP opérationnel. Connectez-vous uniquement à l'environnement pertinent pour la tâche.
Choisissez un serveur MCP
Utilisez le serveur de documentation pour les consignes produit. Utilisez un serveur d'environnement pour les données opérationnelles spécifiques au locataire.
MCP de documentation
Le MCP de documentation donne accès à la documentation de The Wallet Crew. Il ne nécessite pas d'authentification.
Point de terminaison : https://docs.thewalletcrew.io/~gitbook/mcp
Ce serveur est adapté aux questions sur le produit, aux consignes d'implémentation et à la découverte de la documentation. Il n'expose pas les données du locataire.
Il ne nécessite aucune connexion. Connectez-le d'abord pour vérifier qu'un assistant prend en charge cette connexion.
MCP de production
Le MCP de production fournit des données opérationnelles et de diagnostic pour les locataires de production.
Point de terminaison : https://admin.thewalletcrew.io/api/mcp
Il utilise OAuth. Connectez-vous avec les mêmes identifiants Back-office utilisés pour l'accès à la production.
Les métadonnées d'autorisation sont détectables à /.well-known/oauth-protected-resource et /.well-known/oauth-authorization-server sur le même hôte, de sorte qu'un client MCP conforme se configure à partir de la seule URL du point de terminaison.
MCP QA
Le MCP QA fournit des données opérationnelles et de diagnostic pour les locataires QA.
Point de terminaison : https://admin-qa.thewalletcrew.io/api/mcp
Il utilise OAuth. Connectez-vous avec les mêmes identifiants Back-office utilisés pour l'accès QA.
Les métadonnées d'autorisation sont détectables à /.well-known/oauth-protected-resource et /.well-known/oauth-authorization-server sur le même hôte, de sorte qu'un client MCP conforme se configure à partir de la seule URL du point de terminaison.
Ajouter The Wallet Crew à un assistant IA
Choisissez un assistant ci-dessous. Dans tous les cas, collez l'adresse et connectez-vous avec un compte Back-office.
Claude
Oui
ChatGPT
Oui, une fois le mode développeur activé
Mistral Le Chat
Oui
Microsoft Copilot
Non — une équipe informatique le configure
Utilisez l'adresse correspondant à l'environnement requis.
Production — données réelles du locataire
https://admin.thewalletcrew.io/api/mcp
QA — données de test
https://admin-qa.thewalletcrew.io/api/mcp
Rien n'a besoin d'être installé ou téléchargé. Aucune clé, mot de passe ou code n'est nécessaire.
Claude
Ouvrez Claude dans un navigateur ou l'application de bureau.
Cliquez sur la photo de profil. Sélectionnez Paramètres, puis Connecteurs.
Cliquez sur Ajouter. Puis sélectionnez Ajouter un connecteur personnalisé.
Collez l'adresse requise. Cliquez Ajouter.
Connectez-vous avec le compte Back-office. Approuvez la demande d'accès.
Laissez Paramètres avancés inchangé. La connexion est prête.
Claude fonctionne avec les offres Free, Pro, Max, Team et Enterprise. Les comptes Free peuvent ajouter un connecteur personnalisé.
ChatGPT
Ouvrir Paramètres, puis Sécurité et connexion. Activez Mode développeur.
Ouvrir Paramètres, puis Connecteurs. Cliquez +.
Nommez la connexion, par exemple, « The Wallet Crew ». Ajoutez une brève description.
Collez l’adresse requise.
Sélectionnez OAuth comme méthode de connexion. Connectez-vous avec le compte Back-office.
Ouvrez la connexion pour voir ce qu’elle peut rechercher.
Après une version de The Wallet Crew, ouvrez la connexion et sélectionnez Actualiser.
Mistral Le Chat
Ouvrir Connecteurs dans Le Chat.
Cliquez sur + Ajouter un connecteur. Sélectionner Connecteur MCP personnalisé.
Saisissez un nom sans espaces, par exemple « walletcrew ».
Collez l'adresse requise dans URL du serveur.
Cliquez sur Connect. Connectez-vous avec le compte Back-office lorsqu'on vous y invite.
Microsoft Copilot
Microsoft Copilot ne permet pas encore à un individu d'ajouter cette connexion. Un administrateur doit la configurer pour l'organisation.
Envoyez cette page et l'adresse requise à l'équipe informatique. Ils peuvent l'ajouter via Ajouter un outil → Protocole de contexte du modèle dans Copilot Studio.
Autres assistants
Les autres assistants peuvent se connecter s’ils prennent en charge un connecteur personnalisé par adresse. Recherchez Connecteurs, Connecteur personnalisé, ou MCP dans les paramètres. Collez l’adresse, puis connectez-vous.
Les outils de développement, notamment Claude Code, Cursor et Visual Studio Code, utilisent la même adresse. Consultez leur documentation pour l’emplacement de configuration.
Vérifiez que cela a fonctionné
Demandez : « À quels locataires The Wallet Crew puis-je accéder ? »
Une liste de locataires confirme que la connexion fonctionne.
Une liste vide signifie que la connexion fonctionne. Le compte n’a pas accès dans cet environnement. Demandez l’accès à un administrateur de The Wallet Crew.
Ces questions aident à analyser les données des locataires :
« Combien de passes ont été installées le mois dernier, et comment cela se compare-t-il au mois précédent ? »
« Quelles offres sont en cours en ce moment, et combien de clients détient chacune d’elles ? »
“Montrez-moi la Carte avec le numéro de série
<PASS_ID>et ce qui lui est arrivé.”
Si quelque chose se passe mal
La fenêtre de connexion s’ouvre et se ferme sans se connecter
L’assistant ne prend peut-être pas en charge cette connexion. Essayez un navigateur web au lieu d’une application de bureau. Contactez le support si cela échoue toujours.
La connexion a fonctionné, mais les questions renvoient une erreur d’autorisation
Le compte Back-office n’a pas accès à ce locataire ni à ces données. Demandez à un administrateur de The Wallet Crew.
Une question échoue tandis que les autres fonctionnent
Cette recherche nécessite un accès que le compte n’a pas. Demandez à un administrateur de vérifier le rôle.
Les chiffres semblent erronés ou inconnus
Vérifiez l’adresse collée. QA contient des données de test, pas de vraies données client.
Il cesse de répondre après de nombreuses questions
Il existe une limite au nombre de recherches par minute. Attendez un instant. Reposez la question avec un périmètre plus restreint.
Ce que le MCP de l’environnement peut faire
Le MCP de l’environnement agit comme un plan de contrôle de diagnostic. Il expose 37 outils pour la configuration à l’échelle du locataire, la télémétrie, les opérations de Carte, la planification, les redirections et la posture d’accès.
Découvrir les locataires et la configuration
Commencez chaque session opérationnelle en résolvant le locataire à partir de la liste des locataires disponible. N’inférez jamais et ne devinez jamais un identifiant de locataire.
Lister les locataires accessibles
tenants_list
Résoudre le bon locataire avant l’investigation
Examiner la base du locataire
config_get
Inspecter l’identité, le cycle de vie, la localisation et les intégrations
Inspecter les fichiers de configuration
config_files_list, config_files_get
Trouver les valeurs de configuration actuelles ou historiques
Auditer les modifications de configuration
config_history_list, config_files_diff
Identifier quand et comment une configuration a changé
Valider la configuration
config_schema_list, config_schema_get, config_test
Vérifier les exigences du schéma et afficher les erreurs de validation
Examiner les intégrations et la télémétrie
Utilisez les outils d’intégration et de télémétrie pour valider le comportement à l’exécution et identifier les anomalies.
Examiner les extensions activées
extensions_list
Identifier les intégrations activées et leurs périmètres d’autorisations
Explorer la structure de la télémétrie
insights_schema, insights_query_examples
Construire des requêtes KQL valides
Interroger la télémétrie du locataire
insights_query
Examiner les erreurs, les tendances et les comportements inattendus
Examiner les Cartes et les offres
Utilisez les outils Carte et offre pour enquêter sur les workflows ayant un impact sur les clients.
Découvrez les modèles de Carte
passes_templates_list
Trouvez les noms de modèle, les champs de métadonnées et les données scannables
Trouvez et inspectez les Cartes
passes_list, passes_get
Examinez une Carte et son état actuel
Reconstituez l'historique de la Carte
passes_events_list, passes_privileges_list
Examinez les événements du cycle de vie, les soldes et les utilisations
Inspectez une carte à tampons
passes_stamps_get
Lisez le nombre actuel, la cible, le comportement de l'objectif et l'historique complet des mouvements
Examinez les définitions d'offre
offers_list, offers_get
Parcourez les offres disponibles et inspectez le type, la catégorie, la validité et le modèle de Carte associé
Retracez les privilèges émis
offers_privileges_list
Trouvez toutes les Cartes qui ont reçu une offre spécifique, ou qui correspondent à un identifiant de processus externe
Auditez les URL courtes
redirects_list
Trouvez les redirections et examinez les détails d'expiration
passes_stamps_get échoue lorsque la Carte n'est pas une carte à tampons. Une carte jamais tamponnée renvoie un nombre de 0 par rapport à sa cible configurée.
Examinez les automatisations
Les automatisations décrivent l'intention. Les exécutions décrivent le résultat. Utilisez les deux lorsque vous diagnostiquez « l'automatisation n'a pas été exécutée ».
Listez les automatisations
automations_list
Consultez chaque automatisation, les activées en premier, avec un résumé du déclencheur en anglais simple
Inspectez une automatisation
automations_get
Lisez tous les paramètres, les champs de déclenchement et l'état d'activation
Vérifiez si elle a réellement été exécutée
automations_executions_list
Confirmez la réussite, l'échec ou le report à partir de la télémétrie
Examinez les tâches planifiées sous-jacentes
scheduler_tasks_list
Lire server/scheduler.yml les tâches et leurs types de déclenchement
scheduler_tasks_listetautomations_listles deux décrivent la configuration, pas le résultat. Seulautomations_executions_listmontre si une automatisation a été exécutée. Chaque ligne là-bas correspond à une tentative de livraison, et non à une exécution logique. Plusieurs lignes peuvent partager uncorrelationId.success = nullsignifie que l'exécution a été reportée avant son lancement,fauxsignifie qu'elle s'est exécutée et a levé une exception, etvraisignifie qu’il s’est terminé.
récurrence— une expression cron incluant les secondes, évaluée en UTC, et non à l’heure locale du locataire.dateFixe— se déclenche une seule fois à un instant donné. Une date fixe dans le passé ne se déclenche jamais.dateRelative— se déclenche par Carte, décalée à partir d’un champ de date sur cette Carte. Elle peut être épinglée à une heure locale dans un fuseau horaire nommé.événement— se déclenche par Carte lorsqu’un événement se produit, comme une installation.premièreInstallationUniquementsignifie qu’une réinstallation ne le déclenche pas à nouveau.
Examiner les importations de fichiers SFTP
L’importation de fichiers SFTP est facultative. En interne, elle s’appelle Triglav. La plupart des locataires ne l’utilisent pas, et un locataire sans boîte de réception n’est pas une erreur.
Vérifier si SFTP est utilisé
sftp_status_get
Confirmer que la fonctionnalité est activée et lire un bref résumé de l’activité
Lister les fichiers déposés
sftp_files_list
Voir chaque fichier étiqueté en attente, traité ou erreur
Expliquer une importation
sftp_import_log_get
Lire le décompte des lignes et les résultats par Carte, avec la raison de l’échec
Inspecter le contenu brut du fichier
sftp_file_read
Parcourir les lignes brutes par pages pour repérer des problèmes de délimiteur, de colonne ou d’identifiant
Statuts des fichiers :
en attentesignifie déposé, pas encore récupéré, et toujours en cours.traitésignifie importé et terminal.erreursignifie que le traitement a échoué et est terminal. Utilisezsftp_import_log_getpour savoir pourquoi.sftp_import_log_getdistinguenoMatchCountfromerrorCount. La première compte les lignes dont les identifiants n’ont correspondu à aucune Carte. Elle signale un problème de qualité des données, pas un bogue du pipeline. La seconde compte les lignes qui ont levé une exception lors du traitement.L’historique de l’import est reconstruit à partir d’Application Insights, par nom de fichier, et non à partir d’un ID de corrélation exact. Un fichier téléversé de nouveau plusieurs fois rapidement avec le même nom peut mélanger les exécutions.
passIdpeut ne plus être disponible après la fenêtre de conservation des journaux de 90 jours.sftp_file_readrenvoie une fenêtre de lignes limitée. Utilisez lenextStartLinecommestartLinepour continuer.tronquédéfini àfauxetnextStartLinedéfini ànullmarque la fin du fichier.
Examiner les thèmes des cartes
Les thèmes rendent les visuels des cartes cohérents dans tout un locataire.
Lister les thèmes
themes_list
Voir chaque thème et combien de Cartes l’utilisent actuellement
Inspecter un thème
themes_get
Lire les couleurs, le titre et la description localisés, ainsi que chaque remplacement d’image par emplacement
Un thème est un habillage visuel réutilisable avec des couleurs et des images. Il est défini dans
server/themes.ymlet référencé par des cartes individuelles. Une Carte a au plus un thème.La modification d’un thème restyle chaque Carte qui le porte au prochain rendu. Lisez
lastModificationDateetpassCountensemble.Un thème n’a aucun comportement, aucune fenêtre de validité ni aucun code. Pour tout ce que les clients peuvent échanger, consultez les offres et les privilèges.
themes_listfournit l’ID du thème utilisé par lethemeIdfiltre depasses_list.Dans
themes_get,mainImageUrlest l’image par défaut. Elle alimente l’emplacement de bannière de chaque plateforme,appleStripetgoogleHero, lorsqu’aucun remplacement n’existe. Les autres grands emplacements d’Apple, les logos, l’icône et le plan du lieu ne se définissent que viaimages. Les images par langue s’appliquent uniquement à Apple Wallet. Google Wallet sert toujours la valeur par défaut.
Examiner la posture d’accès
Les outils de sécurité renvoient des métadonnées d’accès, pas les secrets des clés API.
Examiner les utilisateurs du back-office
security_users_list
Vérifier les rôles et les métadonnées de connexion récentes
Examiner les clés API
security_apikeys_list
Vérifier les autorisations et l’état d’activation sans exposer les secrets
Examiner les rôles et ce qu’ils accordent
security_roles_list
Voir chaque rôle tel qu’il est stocké, entièrement résolu, ainsi que les entrées qui ne se résolvent en rien
Comprendre une portée d’autorisation
security_permissions_list
Convertir un code de portée en signification en langage clair, ou trouver la bonne portée à accorder
Pour expliquer un 403, trouvez le rôle de la personne avec security_users_list. Puis vérifiez si la portée requise apparaît dans les resolvedScopes. Une portée dans unknownScopes n’accorde rien. C’est soit une faute de frappe, car l’orthographe de la portée n’est pas validée lorsqu’un rôle est enregistré, soit cela appartient à une extension actuellement désactivée. Confirmez les extensions avec extensions_list. Un rôle avec accès total défini à vrai détient * et contourne la liste des périmètres, y compris les périmètres ajoutés par les futures versions.
écriture n'implique jamais lecture n'importe où sur cette plateforme. Un rôle détenant uniquement tenant.carte:write peut mettre à jour une carte et ne peut pas en rechercher une.
Limites et comportement de connexion
L’ouverture d’une session nécessite un compte administrateur global ou un compte disposant d’une autorisation sur au moins un tenant. Le point de terminaison ne contient aucun chemin de tenant, donc cette porte de connexion est délibérément grossière. Chaque appel d’outil détermine l’accès réel.
Chaque outil à portée de tenant nécessite une portée Back-office spécifique. La plateforme applique le même modèle d’autorisations que l’API REST. Voir un tenant dans tenants_list ne signifie pas que chaque outil fonctionne avec lui. Une erreur d’autorisation signifie que la portée manque, pas que les données sont absentes. Utilisez security_permissions_list pour rechercher une portée.
Les appels sont limités par tenant et par outil. La valeur par défaut est de 60 appels par minute. Un tenant peut augmenter ou diminuer cette valeur dans server/security.yml sous mcpThrottling.defaultLimitPerMinute, ou définir une limite par outil sous mcpThrottling.limitsPerTool.
Un appel d’outil est limité à deux minutes. Les appels longs, y compris insights_query, restent actifs grâce aux notifications de progression. Le serveur ne peut les envoyer que lorsque le client fournit un jeton de progression. Un client qui ne demande pas la progression peut atteindre un délai d’inactivité en amont sans erreur. Privilégiez des plages de temps étroites dans les requêtes KQL.
Le serveur utilise Streamable HTTP en mode sans état. Il n’a pas de flux d’événements autonome. Il n’envoie aucune notification non sollicitée en dehors d’un appel en cours.
Le serveur ajoute l’environnement à son nom. Par exemple, Le Wallet Crew MCP – Production. La plupart des clients affichent ce nom, ce qui aide à confirmer l’environnement connecté.
Modèles d’invite
Des invites claires produisent des investigations ciblées. Incluez le contexte du locataire, la période et le résultat attendu.
État de la configuration
Exécutez une validation complète de la configuration pour ce locataire. Expliquez chaque erreur et recommandez la prochaine vérification.
Régression récente
Affichez les changements de configuration des dernières 24 heures. Mettez en évidence les trois modifications les plus risquées et expliquez pourquoi.
Enquête sur la Carte
Trouver une Carte
<PASS_ID>. Résumez son état actuel et les derniers événements importants de son cycle de vie.
Enquête sur l'offre
Listez les offres pour ce locataire. Pour l'offre
<OFFER_ID>, affichez la configuration complète et trouvez toutes les Cartes qui détiennent actuellement un privilège actif issu de celle-ci.
Automatisation planifiée
Répertoriez les automatisations pour ce locataire. Pour toute automatisation qui semble incorrecte, affichez la configuration et les exécutions récentes, et dites-moi si elle a réellement été exécutée et si elle a réussi.
Triage de l'import SFTP
Vérifiez si SFTP est activé pour ce locataire. Listez les fichiers récents, puis pour le fichier
<FILE_NAME>expliquez ce qui s'est passé pendant l'importation, notamment quelles passes ont échoué et pourquoi.
Dépannage des autorisations
Utilisateur
<EMAIL>obtient une erreur 403 sur<OPERATION>. Trouvez leur rôle, résolvez leurs périmètres et dites-moi exactement quel périmètre manque ou est mal orthographié.
Audit des thèmes
Listez les thèmes de Carte et combien de Cartes chacun comporte. Signalez les thèmes sans Carte et ceux modifiés au cours des 30 derniers jours.
Revue des accès
Examinez les utilisateurs Back-office et les clés API. Signalez les accès obsolètes et les permissions qui doivent être examinées.
Bonnes pratiques d'exploitation sûres
Utilisez le MCP de documentation pour les connaissances produit avant d'inspecter les données opérationnelles. Commencez par le périmètre le plus restreint qui puisse répondre à la question.
N'incluez pas de données client, de jetons, de clés API ni d'identifiants OAuth dans les requêtes à l'IA. Relisez les résultats avant de les partager en dehors de l'équipe autorisée.
Utilisez QA pour les tests et les répétitions. N'utilisez la production que lorsque des preuves de production sont requises.
Les outils SFTP peuvent renvoyer des données client brutes. Utilisez la fenêtre la plus restreinte qui réponde à la question.
FAQ
Mis à jour