Como usar o Cline com a Fabapp AI
Ligando o Cline na sua conta
O Cline é uma extensão do VS Code e guarda os servidores MCP num arquivo próprio, que o painel de MCP da extensão abre para você editar. O bloco é o de sempre:
{ "mcpServers": { "fabapp": { "command": "npx", "args": ["-y", "@fabappai/cli", "mcp"] } } }
Assim que salvar, o painel mostra o servidor e as ferramentas que ele ofereceu.
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 Cline
O Cline separa planejar de executar, e essa separação cai bem no trabalho com a Fabapp. Use o modo de planejamento para ele ler: a documentação da plataforma, a definição do projeto, o que já existe de tela. Só depois passe para a execução.
O motivo é concreto. As duas coisas que mais dão errado quando um assistente mexe num projeto da Fabapp são inventar tipo de campo e escrever regra de acesso errada. As duas falham fechadas, sem erro barulhento: o campo é recusado e a regra tranca todo mundo fora dos próprios registros. Ler antes de escrever é o que evita as duas, e o modo de planejamento é literalmente isso.
Vale também aprovar alteração por alteração nas primeiras vezes, até você pegar o jeito do que ele faz com o schema.
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.