@lastructure/mcp

Serveur MCP officiel de LA STRUCTURE — pilote ton academy et tes boutiques élèves directement depuis Claude Code.

26 outils · RBAC partenaire/élève · Retry automatique · Rate limiting · Audit log

Installation rapide

claude mcp add --transport stdio la-structure -- npx @lastructure/mcp

Puis ajoute ton token dans les variables d'environnement Claude :

LA_STRUCTURE_TOKEN=<ton-token>

Génère ton token depuis Paramètres → API MCP sur ton dashboard LA STRUCTURE.

Variables d'environnement

| Variable | Requis | Description | |---|---|---| | LA_STRUCTURE_TOKEN | Oui | Token généré depuis Paramètres → API MCP | | LA_STRUCTURE_URL | Non | URL de l'instance (défaut : https://lastructure.pro) |

Outils disponibles

Diagnostic (tous les rôles)

| Outil | Description | |---|---| | ping | Vérifie que le serveur répond | | whoami | Affiche ton identité et ton rôle | | batch | Exécute jusqu'à 10 outils en un seul appel HTTP |

Academy (partenaire/admin uniquement)

| Outil | Description | |---|---| | get_students | Liste tous les élèves de ta formation | | get_student | Détails d'un élève (progression, devoirs) | | get_analytics | Statistiques globales de l'academy | | send_broadcast | Envoie une notification à tes élèves | | list_modules | Liste les modules de formation | | get_pending_homeworks | Devoirs en attente de validation | | validate_homework | Valide ou refuse un devoir élève |

Studio (tous les rôles)

| Outil | Description | |---|---| | get_studio_doc | Récupère le document design d'une boutique | | update_studio_doc | Met à jour le document design complet | | apply_template | Applique un template Pro à une boutique | | set_page_theme | Change les couleurs/polices de la boutique | | list_sections | Liste les sections de la page | | add_section | Ajoute une nouvelle section | | delete_section | Supprime une section | | update_section | Modifie le contenu d'une section | | move_section | Déplace une section (haut/bas) |

Boutique (tous les rôles)

| Outil | Description | |---|---| | list_products | Liste les produits d'une boutique | | get_product | Détails d'un produit | | create_product | Crée un nouveau produit | | update_product | Met à jour un produit | | delete_product | Supprime un produit | | get_orders | Liste les commandes récentes | | create_promo_code | Crée un code promo | | get_shop_stats | Statistiques de vente (CA, commandes) |

Exemple d'utilisation

# Dans Claude Code, une fois le MCP configuré :

"Montre-moi les 5 derniers devoirs en attente de validation"
"Crée un produit 'Hoodie LA STRUCTURE' à 67€ dans ma boutique"
"Applique le template luxury à la boutique slug=example"
"Envoie un broadcast à tous mes élèves PRO"

RBAC

• Partenaire / Admin — accès complet aux 26 outils
• Élève — accès uniquement aux outils Studio et Boutique de sa propre boutique (slug auto-injecté depuis le token)

Le rôle est encodé dans le token à la génération — aucune vérification Clerk à chaque appel.

Optimisations

• Timeout 15s — AbortController sur chaque requête HTTP
• Retry 1× — sur erreur 5xx avec backoff 300ms (pas de retry sur 4xx)
• Rate limiting — 60 req/min global, 5 req/min pour les outils destructifs
• batch — N outils en 1 seul round-trip HTTP (max 10)
• _meta — chaque réponse inclut { latencyMs, rateLimit: { used, remaining } }

Audit log

Chaque appel MCP est enregistré dans Redis (mcp:audit:{userId}, 100 derniers).
Visible depuis Paramètres → Logs MCP dans ton dashboard.

Licence

MIT — LA STRUCTURE