Comment utiliser Claude Code avec Fabapp AI
Connecter Claude Code à votre compte
Une commande :
claude mcp add fabapp -- npx -y @fabappai/cli mcp
C'est tout. À la conversation suivante, Claude Code voit les outils Fabapp et se met à lire et écrire dans votre projet sans que vous colliez quoi que ce soit dans le chat.
Il vaut la peine de comprendre ce qu'il y gagne, car ce n'est pas « une commande de plus ». Il gagne le schema de votre projet : les entités, les champs et les règles d'accès. Sans cela, un id de modèle erroné répond 404 et un champ inventé répond 422, et l'assistant devine. Avec cela, il lit avant d'écrire.
Ce qu'il vous faut
Node 20 ou plus récent, un compte Fabapp au forfait Builder ou au-dessus, et une seule connexion :
npx @fabappai/cli login
La credential va dans le trousseau du système. Elle n'est jamais affichée et se révoque depuis un seul endroit, dans le panneau.
Le cycle
npx @fabappai/cli create "Ma boutique"
npx @fabappai/cli dev
dev assemble l'app sur votre machine avec le modèle même dont la plateforme se sert pour publier, installe les
dépendances et lance le serveur local. Avec ça qui tourne, demandez ce que vous feriez à la main : lire la
définition, créer les entités, écrire les écrans. Ensuite :
npx @fabappai/cli deploy
Il envoie ce que vous avez changé puis publie, dans cet ordre. Publier avant d'envoyer publierait ce qui est sur le serveur, et votre travail resterait derrière.
Ce qui change avec Claude Code
Claude Code vit déjà dans le terminal où l'app tourne, donc tout le cycle se passe au même endroit. Lancez dev,
laissez-le tourner, et parlez : « lis la définition du projet et crée le modèle de commande avec statut, client et
total ». Il appelle les outils, écrit le schema, et vous regardez le résultat dans le navigateur sans bouger.
Deux choses coincent souvent. Claude Code lance le serveur via npx, il lui faut donc Node dans le PATH de
l'environnement d'où il a été ouvert ; si vous utilisez un gestionnaire de versions de Node, l'ouvrir depuis un shell
qui ne l'a pas chargé est la raison la plus fréquente pour que le serveur ne démarre pas. Et une credential en
lecture seule ne montre pas les outils d'écriture, volontairement. Si l'assistant dit qu'il ne peut pas écrire,
vérifiez avec npx @fabappai/cli status quelle permission cette machine a reçue.
Quoi lui demander
« Lis la documentation de la plateforme avant d'écrire le schema. » Les types de champ sont une liste fermée et tout autre est refusé ; les règles d'accès sont la seule chose entre les données d'une app et le public.
« Lis la définition actuelle avant de la changer. » Sans le schema en main, un id de modèle erroné répond 404 et un champ inventé répond 422.
« Le schema d'abord, les écrans ensuite. » Le SDK est généré à partir du modèle de données.