Como usar o Cursor com a Fabapp AI
Ligando o Cursor na sua conta
O Cursor lê a configuração de MCP de um arquivo dentro do projeto, o que é a vantagem dele aqui:
{ "mcpServers": { "fabapp": { "command": "npx", "args": ["-y", "@fabappai/cli", "mcp"] } } }
Colocando isso em .cursor/mcp.json, a configuração viaja com o repositório. Quem clonar o projeto e abrir no
Cursor já encontra a Fabapp conectada, sem passo manual e sem um README explicando o que configurar. Se preferir
valer para todos os seus projetos, o mesmo bloco vai no arquivo equivalente na sua pasta pessoal.
Depois de salvar, o painel de MCP do Cursor lista as ferramentas disponíveis. É por ali que você confere se a conexão subiu, e quantas ferramentas vieram: uma credencial só de leitura mostra menos, porque as de escrita não são oferecidas.
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 Cursor
O Cursor é um editor, não um terminal, e isso muda o ritmo. O dev roda no terminal integrado enquanto você
conversa no painel lateral, e os arquivos que o assistente escreve aparecem no editor com diff antes de você
aceitar. Para quem revisa o que a IA escreve, essa é a diferença prática em relação a um assistente de terminal.
Duas coisas para saber: o arquivo por projeto é o que faz a configuração viajar com o repositório, então vale commitá-lo; e o painel de MCP é onde você descobre que a conexão caiu, em vez de descobrir pelo assistente dizendo que não encontrou a ferramenta.
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.