Como usar o Windsurf com a Fabapp AI
Ligando o Windsurf na sua conta
O Windsurf tem um arquivo de configuração de MCP próprio, e o painel de plugins do editor abre ele para você. O bloco é o mesmo:
{ "mcpServers": { "fabapp": { "command": "npx", "args": ["-y", "@fabappai/cli", "mcp"] } } }
Depois de salvar, o Windsurf pede para recarregar os servidores. As ferramentas da Fabapp passam a aparecer na lista do painel.
O que você precisa
Node 20 ou mais novo, uma conta da Fabapp no plano Builder ou superior, e o login feito uma vez:
npx @fabappai/cli login
A credencial vai para o chaveiro do sistema. Ela nunca é exibida e pode ser revogada de um lugar só, no painel.
O ciclo
npx @fabappai/cli create "Minha loja"
npx @fabappai/cli dev
O dev monta o app na sua máquina com o mesmo template que a plataforma usa para publicar, instala as dependências
e sobe o servidor local. Com ele rodando, peça o que você faria à mão: ler a definição, criar as entidades, escrever
as telas. Depois:
npx @fabappai/cli deploy
Sobe o que você mudou e publica, nessa ordem. Publicar antes de subir publicaria o que está no servidor, e o seu trabalho ficaria para trás.
O que muda no Windsurf
O fluxo do Windsurf é de conversa longa com o agente, e o que mais rende aqui é deixar o dev rodando ao lado. A
cada alteração de tela, o navegador já mostra; a cada alteração de schema, o app local passa a enxergar os campos
novos sem você precisar publicar nada.
Uma observação sobre créditos que costuma confundir: os créditos do Windsurf e os créditos da Fabapp são coisas diferentes. O Windsurf cobra pelo uso do modelo dele. A Fabapp cobra créditos de criação quando a IA da plataforma gera código, o que não acontece quando quem escreve é o seu assistente. Pelo caminho do MCP, o que a sua conta da Fabapp consome é o plano, não crédito de geração.
O que pedir
"Leia a documentação da plataforma antes de escrever o schema." Os tipos de campo são uma lista fechada e qualquer outro é recusado; as regras de acesso são a única coisa entre os dados do app e o público.
"Leia a definição atual antes de mudar." Sem o schema em mãos, um id de modelo errado responde 404 e um campo inventado responde 422.
"Schema primeiro, telas depois." O SDK é gerado em cima do modelo de dados.