Exécutez SocialHub à partir de Claude Code
SoCode est l'intégration SocialHub pour Claude Code (et Claude Desktop / Cursor) : une compétence téléchargeable plus un serveur MCP gouverné. Utilisez SocialHub – et posez des questions sur vos données – dans un langage simple.
› Posez votre question en langage clair
vous › GMV de la semaine dernière par magasin, top 3▋
↳ métrique gouvernée · GMV · par magasin · last_7d
de la couche sémantique · pas de SQL · audité · illustratif
Qu'est-ce que SoCode ?
SoCode est la façon dont SocialHub se connecte à votre assistant IA. Il s'agit de deux éléments qui travaillent ensemble : Claude peut donc faire fonctionner SocialHub et répondre aux questions sur vos données, dans un langage simple, sans que vous quittiez votre éditeur.
flash-operations
Une compétence téléchargeable Claude qui enseigne Claude comment utiliser SocialHub en toute sécurité — quel outil utiliser, confirmer les écritures par nom/e-mail du membre et ne citer que les chiffres de métriques réglementés.
Serveur MCP géré
Un point de terminaison Model Context Protocol qui expose les outils de SocialHub (fidélité, membres, coupons, campagnes et vos métriques gouvernées) authentifiés par une clé de locataire API et autorisés par outil.
Pourquoi SoCode ?
Vos données et opérations sont accessibles depuis les outils d'IA que votre équipe utilise déjà, sans compromettre la gouvernance.
Langage naturel, sans tableaux de bord
Demandez en anglais simple ; Claude sélectionne le bon outil gouverné et l’exécute. Pas de clic sur les écrans, pas de SQL à écrire.
Conception sécurisée et gouvernée
Les indicateurs proviennent de la couche sémantique de SocialHub (l'IA n'invente jamais de chiffres). Les écritures nécessitent une autorisation et passent un contrôle côté serveur. Chaque clé est associée à votre équipe ; chaque appel est audité.
Fonctionne là où vous travaillez déjà
Claude Code, Claude Desktop, Cursor — n'importe quel client MCP. Connectez-vous une fois avec une seule commande et utilisez SocialHub sans quitter votre assistant.
Démarrer en lecture seule
Commencez par le préréglage « metrics:read » (le plus sûr pour l'IA). N'ajoutez d'autorisations d'écriture que pour attribuer des points ou émettre des coupons : vous gardez le contrôle.
Fonctionnalités impossibles avant SoCode
Auparavant, chacun de ces éléments nécessitait un analyste, un ingénieur ou un tableau de bord que vous n'avez pas – de sorte que la personne qui posait la question obtenait rarement la réponse à temps. Un agent gouverné au sein de votre propre outil d'IA est ce qui les rend possibles : des réponses et des actions de qualité professionnelle, en libre-service, sans renoncer au contrôle de vos données. C'est là la clé : pas un tableau de bord plus rapide, mais un modèle opérationnel différent.
« Identifier les membres susceptibles de se désabonner, lancer une campagne de reconquête et optimiser en continu pour atteindre mon objectif. »
AvantTrois équipes et trois outils sur plusieurs semaines : un analyste extrait les données, un spécialiste du marketing construit la campagne, quelqu'un vérifie les résultats le mois prochain – le moment est alors passé et la boucle ne se ferme jamais réellement.
Avec SoCodeUne boucle automatisée analyse, exécute et améliore en continu : elle lit les indicateurs définis, lance le parcours que vous approuvez, mesure l'impact et effectue des ajustements, en fonction des objectifs et des limites que vous avez fixés.
« Le volume brut de marchandises (GMV) de la semaine dernière par magasin – et pourquoi les remboursements sont-ils en baisse ce mois-ci ? »
AvantSoumettez une demande et attendez la réponse d’un analyste, ou compilez les données sur différents tableaux de bord : la réponse arrive après que la décision soit déjà prise.
Avec SoCodeUne réponse fiable et sécurisée en quelques secondes : la décision est prise sur la base de données, et non d'une intuition.
Exposez les métriques gouvernées de SocialHub à votre propre assistant ou à un workflow Cursor sur MCP.
AvantUne intégration personnalisée, des requêtes écrites manuellement et une gouvernance entièrement réimplémentée : des mois de travail et un nouveau contexte propice à la dérive des données.
Avec SoCodeUne seule clé de portée et la couche gérée est accessible depuis votre pile. L'intégration, auparavant un projet, se résume désormais à une ligne de configuration.
« Le nombre de membres actifs a-t-il diminué par rapport au mois dernier ? Analysez les données par niveau. »
AvantVous le remarqueriez dans le bilan mensuel… une fois le mois écoulé.
Avec SoCodeUn diagnostic en plusieurs étapes et en libre-service dès que vous avez un doute — détectez la fuite tant que vous pouvez encore agir.
Fonctionnement de SoCode
Trois étapes : télécharger la compétence, installer le MCP serveur, et l’utiliser en langage naturel.
1. Téléchargez SoCode (la compétence)
La compétence SoCode (flash-operations) apprend à Claude comment utiliser SocialHub en toute sécurité. Elle se synchronise avec le serveur SocialHub MCP que vous ajouterez à l'étape 2.
Obtenez le dossier de compétences
# Pull just the SoCode skill into Claude Code
npx degit huangchunbo2025/flash/skills/flash-operations \
~/.claude/skills/flash-operationsOu consultez/téléchargez-le sur GitHub → skills/flash-operations. Copiez le dossier dans ~/.claude/skills/ (personnel) ou dans .claude/skills/ de votre projet.
La compétence est facultative mais recommandée : le serveur MCP fonctionne sans elle ; La compétence de SoCode permet simplement à Claude de bien l'utiliser.
2. Installez le serveur MCP
a) Créer une clé API
Dans SocialHub, accédez à Paramètres → APIClés → Créer une clé et sélectionnez le préréglage « Lecture seule » (incluant metrics:read — le plus sûr pour l’IA ; n’ajoutez les droits d’écriture que pour attribuer des points ou émettre des coupons). La clé s’affiche une seule fois ; copiez-la.
b) Ajoutez le serveur à Claude Code
Exportez d'abord la clé en tant que variable d'environnement, afin que la clé en texte brut n'arrive jamais dans l'historique de votre shell ou dans un fichier de configuration :
export FLASH_API_KEY="fl_live_your_key_here"
claude mcp add --transport http flash \
https://flash.socialhub.ai/api/mcp \
--header "Authorization: Bearer ${FLASH_API_KEY}"Vous préférez la configuration ? Ajoutez un .mcp.json à l'échelle du projet à la racine de votre dépôt - référencez la variable d'environnement, ne collez jamais de clé en texte brut :
{
"mcpServers": {
"flash": {
"type": "http",
"url": "https://flash.socialhub.ai/api/mcp",
"headers": {
"Authorization": "Bearer ${FLASH_API_KEY}"
}
}
}
}c) Vérifier
- Exécutez
claude mcp list—flashdevrait apparaître comme connecté. - Demandez à Claude de "lister les outils SocialHub disponibles" — vous ne verrez que les outils autorisés par les portées de votre clé.
- Le nom du serveur doit être exactement
flash, etFLASH_API_KEYdoit être exporté dans le shell qui lance Claude Code. Une clé invalide entraîne un échec de connexion.
3. Utilisation
Il suffit de demander à Claude en langage clair. Par exemple :
Interrogez vos données
- « Liste des indicateurs que je peux interroger. »
- « Valeur brute d'échange (VBE) de la semaine dernière par magasin. »
- « Pourquoi les rachats ont-ils chuté ce mois-ci ? »
Lancer les opérations
- « Attribuez 200 points à Alice (alice@…). »
- « Répertorier les pools de coupons actifs. »
- « Émettre un code ambassadeur pour ce membre. »
Gardez le contrôle
- Les écritures sont confirmées avant exécution.
- Les limites côté serveur bloquent les écritures surdimensionnées.
- Consultez chaque appel sous API Clés → Activité récente MCP.
Sécurité garantie. Les valeurs des indicateurs proviennent de la couche sémantique contrôlée de SocialHub (l'IA n'écrit jamais de SQL ni n'invente de chiffres). Les opérations d'écriture nécessitent une autorisation d'écriture ( et ) et passent une vérification côté serveur (limite de valeur par appel + limitation de débit). La confirmation par chat est facultative ; le serveur fait office de limite. Chaque touche est réservée à votre équipe.