Como usar o Zed com a Fabapp AI
Ligando o Zed na sua conta
No Zed, servidores MCP entram como context servers, no settings.json do editor. O comando é o mesmo de sempre:
{ "context_servers": { "fabapp": { "command": { "path": "npx", "args": ["-y", "@fabappai/cli", "mcp"] } } } }
Se a sua versão do Zed organizar esse bloco de outro jeito, a documentação dele é que vale. A parte nossa, que não
muda, é npx -y @fabappai/cli mcp.
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 Zed
O Zed é rápido, e quem escolhe ele normalmente escolhe por isso. O ganho aqui é que o ciclo curto fica curto de
verdade: o dev roda no terminal integrado, o app recarrega ao salvar, e o painel do agente fica ao lado sem
pesar.
O que vale ajustar é a expectativa sobre o que é rápido. Editar uma tela e ver no navegador é instantâneo. Publicar
não é: o deploy sobe os arquivos e a plataforma constrói o app de verdade, com instalação de dependências e build.
Por isso o dev existe. Publique quando estiver pronto, não a cada alteraçã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.