Como o Buildprint funciona
O Buildprint conecta ferramentas de IA ao seu app Bubble para que elas possam inspecionar, depurar, testar, documentar e, quando você permitir, fazer alterações na estrutura do app.
O Buildprint não substitui o Bubble. O Bubble continua sendo a fonte da verdade para o seu app, branches, banco de dados, logs e alterações no editor. O Buildprint oferece aos agentes uma maneira mais segura de entender e trabalhar com esse app.
O que o Buildprint pode acessar
Depois de conectar um app Bubble, o Buildprint pode ajudar os agentes a trabalhar com:
Entendimento e edição do app: páginas, elementos, elementos reutilizáveis, workflows, workflows de backend, tipos de dados, option sets, estilos, configurações e branches.
Logs: logs do servidor Bubble quando a sincronização de logs está habilitada.
Acesso ao banco de dados: buscas apenas para leitura, buscas (fetches) e consultas agregadas.
Ferramentas do Buildprint: testes, automações, monitores, revisões, branches e histórico de versões.
O Buildprint não pode editar registros no seu banco de dados Bubble. O acesso ao banco de dados é usado apenas para investigação e depuração.
Como funciona a configuração
Uma configuração típica se parece com isto:
Crie um projeto Buildprint para o seu app Bubble.
Convide
[email protected]como um colaborador do Bubble.Verifique a propriedade e as permissões de colaborador.
Sincronize a branch do Bubble que você deseja que o Buildprint entenda.
Use o chat do Buildprint, ferramentas de MCP, CLI ou API REST para inspecionar o app, testar o comportamento ou solicitar alterações.
Quando você sincroniza uma branch, o Buildprint armazena um snapshot da estrutura do app dessa branch. Os agentes usam esse snapshot para raciocinar sobre o seu app sem precisar buscar todo o estado do editor do Bubble todas as vezes.
Registros de banco de dados são diferentes. O Buildprint não armazena seu banco de dados Bubble como estado do projeto. Os registros são buscados apenas quando você os solicita por meio de ferramentas de leitura.
Credenciais e segurança
As credenciais do provedor de IA conectadas são específicas do usuário e criptografadas antes do armazenamento.
Valores privados do API Connector e segredos de plugins privados não são expostos aos agentes do Buildprint. O Buildprint também não pode ir além das permissões de colaborador do Bubble que você conceder.
O Buildprint é somente leitura por padrão. O modo Build pode fazer alterações na estrutura do app apenas quando a edição estiver habilitada e as permissões relevantes do Buildprint, da branch e do Bubble permitirem.
Você ainda deve revisar e testar alterações importantes geradas por IA antes de confiar nelas.
Conceitos-chave
Workspace: o espaço da sua equipe no Buildprint.
Projeto: um app Bubble conectado.
Branch: uma versão de app Bubble, como test, live ou uma branch de funcionalidade (feature branch).
Snapshot de versão: uma visualização sincronizada de um ponto no tempo de uma branch do Bubble.
Servidor MCP: um servidor MCP público que permite que clientes de IA externos usem ferramentas do Buildprint.
Agente: uma tarefa de IA que pode investigar, testar, documentar ou, quando permitido, editar seu app Bubble.
O que o Buildprint não faz
O Buildprint não:
Modifica automaticamente seu app live sem permissões de edição.
Substitui o controle de versão, savepoints ou testes manuais do Bubble.
Armazena uma cópia do seu banco de dados Bubble como estado do Buildprint.
Expõe valores privados do API Connector ou segredos de plugins aos agentes.