Cómo usar Windsurf con Fabapp AI
Conectar Windsurf a tu cuenta
Windsurf tiene su propio archivo de configuración de MCP, y el panel de plugins del editor te lo abre. El bloque es el mismo:
{ "mcpServers": { "fabapp": { "command": "npx", "args": ["-y", "@fabappai/cli", "mcp"] } } }
Al guardar, Windsurf ofrece recargar los servidores. Las herramientas de Fabapp pasan a aparecer en la lista del panel.
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 Windsurf
El flujo de Windsurf es una conversación larga con el agente, y lo que más rinde aquí es dejar dev corriendo al
lado. Cada cambio de pantalla se ve en el navegador; cada cambio de schema hace que la app local vea los campos
nuevos sin que publiques nada.
Una nota sobre créditos que suele confundir: los créditos de Windsurf y los de Fabapp son cosas distintas. Windsurf cobra por usar su modelo. Fabapp cobra créditos de creación cuando la IA de la plataforma genera código, que no es lo que pasa cuando quien escribe es tu asistente. Por el camino del MCP, lo que consume tu cuenta de Fabapp es el plan, no crédito de generación.
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.