CMS Headless pour IA

Ce que contient ce pack

Ce pack rassemble les cinq backends headless qui valent la peine d'être installés quand vous avez besoin qu'un agent IA lise ou mute des données business réelles — contenu, produits, commandes, utilisateurs — sans écrire d'endpoints CRUD sur mesure.

La séparation est intentionnelle : Strapi pour contenu éditorial, Medusa / Vendure pour données produit+commande, Directus / Hasura pour surfaces SQL arbitraires. La plupart des systèmes en production choisissent un de chaque ligne selon quels cas d'usage dominent.

Pourquoi headless compte pour les agents

Les CMS traditionnels livrent du HTML ; les agents ne consomment pas bien le HTML. Les CMS headless livrent du JSON typé et des schemas GraphQL. La différence s'accumule :

• Introspection de schema. Les endpoints GraphQL sont auto-documentés. Un agent peut appeler __schema et découvrir quels champs existent, ce qu'ils retournent, quels arguments ils acceptent. Pas de docs API manuelles à synchroniser.
• Sécurité de mutation. Les endpoints REST + GraphQL déclarent les opérations d'écriture explicitement avec types d'entrée. Les agents peuvent valider avant d'envoyer, et le serveur rejette les payloads malformés à la couche transport plutôt qu'après une écriture partielle.
• Permissions. Chaque outil ici livre du contrôle d'accès basé rôle. Vous pouvez donner à l'agent un token scopé qui ne lit que certains types de contenu ou ne mute que des ressources spécifiques, avec logs d'audit.
• Multi-langue et i18n. Strapi et Directus ont un support locale de première classe, ce qui compte quand l'agent génère ou traduit du contenu.

Ces propriétés sont pourquoi un CMS headless, même excessif pour l'équipe humaine de contenu, est souvent le bon substrat pour un produit agent-driven.

Installer en une commande

# Installer le pack entier
tokrepo install pack/headless-cms-for-ai

# Ou choisir un backend
tokrepo install strapi
tokrepo install hasura

Chaque outil s'installe comme snippet Docker compose plus un skill Claude Code qui connaît la surface API. Le skill expose des méthodes typées comme strapi.list_articles({ filters }) pour que l'agent n'ait pas à fabriquer des URLs REST à la main.

Pièges courants

• Drift de schema entre agent et serveur. Quand vous ajoutez un type de contenu dans l'admin UI, le cache de schema local de l'agent vieillit. Re-introspectez à chaque démarrage de session, ou câblez un webhook pour que l'agent invalide aux changements de type de contenu.
• Queries N+1 depuis les agents. Les agents tendent à fetcher un enregistrement à la fois. Utilisez les endpoints bulk (Strapi populate=*, sélections imbriquées Hasura) et budgétez les queries — mettez un rate limit par agent.
• Tokens de lecture publics. Il est tentant de donner à l'agent un token de lecture large. Non. Scopez à des collections spécifiques ; révoquez aux changements de rôle. Les cinq outils ont une UI de permissions fines.
• Idempotence de mutation. Les agents retentent. Si un agent retente createOrder après un blip réseau, vous aurez des duplicatas. Utilisez des idempotency keys (Medusa les supporte nativement ; pour les autres, ajoutez un champ request_id).
• Backups. Les CMS headless centralisent le contenu ; si la BD est corrompue vous perdez un an de travail éditorial. Configurez des snapshots quotidiens avant de laisser l'agent écrire en production.

Idées fausses courantes

• "Hasura et Directus sont interchangeables." Ils se chevauchent sur "exposer SQL comme GraphQL" mais diffèrent en audience : Hasura est pour les ingénieurs qui veulent une couche GraphQL fine sur Postgres ; Directus est pour les équipes qui veulent aussi une UI admin de contenu. Si vous ne voulez que l'API, Hasura. Si des non-ingénieurs éditeront les données, Directus.
• "Strapi peut remplacer Medusa pour le commerce." Strapi gère le contenu magnifiquement mais manque de workflow de commande, paiement et inventaire. Utilisez Medusa ou Vendure, puis pointez Strapi sur le contenu adjacent aux produits (blog, pages marketing).
• "GraphQL est toujours meilleur que REST pour les agents." Parfois — l'introspection de schema c'est génial. Mais pour list/get simple, les endpoints REST sont plus faciles à cacher et plus faciles pour l'agent à composer avec des outils niveau HTTP. Les cinq parlent les deux ; choisissez par appel.

Relation avec d'autres packs

• Postgres pour Agents IA est la couche de données sous Hasura et Directus.
• Stack de Serveurs MCP inclut des wrappers MCP autour de ces CMS pour que l'agent les utilise via MCP plutôt qu'HTTP brut.
• Builders d'Apps IA consomment ces endpoints GraphQL depuis le frontend.