Cómo usar Claude Code con Fabapp AI
Conectar Claude Code a tu cuenta
Un comando:
claude mcp add fabapp -- npx -y @fabappai/cli mcp
Listo. En la siguiente conversación, Claude Code ve las herramientas de Fabapp y empieza a leer y escribir en tu proyecto sin que pegues nada en el chat.
Vale entender qué gana con eso, porque no es "un comando más". Gana el schema de tu proyecto: las entidades, los campos y las reglas de acceso. Sin eso, un id de modelo equivocado responde 404 y un campo inventado responde 422, y el asistente adivina. Con eso, lee antes de escribir.
Lo que necesitas
Node 20 o más nuevo, una cuenta de Fabapp en el plan Builder o superior, y un único inicio de sesión:
npx @fabappai/cli login
La credencial va al llavero del sistema. Nunca se muestra y se revoca desde un solo lugar, en el panel.
El ciclo
npx @fabappai/cli create "Mi tienda"
npx @fabappai/cli dev
dev arma la app en tu máquina con la misma plantilla con la que la plataforma publica, instala las dependencias y
levanta el servidor local. Con eso corriendo, pide lo que harías a mano: leer la definición, crear las entidades,
escribir las pantallas. Después:
npx @fabappai/cli deploy
Sube lo que tú cambiaste y publica, en ese orden. Publicar antes de subir publicaría lo que está en el servidor, y tu trabajo quedaría atrás.
Qué cambia con Claude Code
Claude Code ya vive en la terminal donde corre la app, así que todo el ciclo ocurre en un solo lugar. Levanta dev,
déjalo corriendo y conversa: "lee la definición del proyecto y crea el modelo de pedido con estado, cliente y
total". Llama a las herramientas, escribe el schema, y tú ves el resultado en el navegador sin moverte.
Dos cosas que suelen trabar. Claude Code levanta el servidor con npx, así que necesita Node en el PATH del entorno
desde donde se abrió; si usas un gestor de versiones de Node, abrirlo desde un shell que no lo cargó es la razón más
común de que el servidor no suba. Y una credencial de solo lectura no muestra las herramientas de escritura, a
propósito. Si el asistente dice que no puede escribir, revisa con npx @fabappai/cli status qué permiso recibió esa
máquina.
Qué pedirle
"Lee la documentación de la plataforma antes de escribir el schema." Los tipos de campo son una lista cerrada y cualquier otro se rechaza; las reglas de acceso son lo único entre los datos de la app y el público.
"Lee la definición actual antes de cambiarla." Sin el schema a mano, un id de modelo equivocado responde 404 y un campo inventado responde 422.
"Schema primero, pantallas después." El SDK se genera sobre el modelo de datos.