Instalação e autenticação

A CLI buildprint oferece aos agentes um espaço de trabalho de edição local para a lógica de aplicativos Bubble. Funciona melhor em conjunto com o servidor MCP Buildprint: use a CLI para arquivos de apps, verificações, sincronização e aplicação; use ferramentas MCP para dados de tempo de execução, logs, métricas de carga de trabalho e ferramentas hospedadas do Bubble.

Instalar a CLI

Instale a CLI global com npm:

npm install -g buildprint
buildprint --version

Para verificar se há uma versão mais recente mais tarde:

buildprint update --check
buildprint update

Se o seu shell ainda executar um binário antigo após a atualização, reinicie o terminal ou execute hash -r.

Criar um token de CLI

No Buildprint, abra Agent > Integrations > CLI e gere um token de CLI. Você pode definir o escopo do token para projetos específicos.

Trate esse token como uma senha. Ele concede acesso aos projetos no escopo e pode editar os apps Bubble associados quando as permissões do app permitem que o Buildprint edite. Não o cole em chats públicos, não faça commit em um repositório nem o compartilhe com outras pessoas.

Vincular a CLI

Vincule a CLI uma vez em cada máquina:

buildprint link <token>

Um vínculo bem-sucedido verifica o token, armazena a autenticação local para a API do Buildprint e exibe os projetos que o token pode acessar.

Duas verificações rápidas:

buildprint project list
buildprint docs buildprint "getting started"

Se qualquer um dos comandos retornar um erro de autenticação, gere um novo token e execute buildprint link <token> novamente.

Começar pelo playbook

Após vincular, imprima o playbook do agente local:

buildprint quickstart

Ele resume o layout do espaço de trabalho, o loop usual de sync -> edit -> check -> apply e as convenções de comando que os agentes devem seguir.

Instalar o servidor MCP em um cliente de IA

O Buildprint MCP complementa a CLI. Instale-o em um cliente local suportado com:

buildprint mcp install --client codex

Os seletores de clientes suportados são cursor, codex, claude-code, claude-desktop, opencode e all. Flags úteis:

• --client <clients> seleciona um ou mais clientes, por exemplo cursor,codex.

• --dry-run visualiza os arquivos de configuração sem criar um token ou gravar arquivos.

• --json imprime detalhes da instalação legíveis por máquina.

• --name <serverName> altera o nome do servidor MCP. O padrão é buildprint.

• --token <token> usa um token de portador MCP existente em vez de criar um novo.

Exemplo:

buildprint mcp install --client cursor,codex --dry-run

Fazer login como um usuário Bubble para testes de navegador

buildprint login cria cookies run-as-user para o Agent Browser. Execute-o dentro de um workspace de branch ou passe o app e a branch explicitamente:

buildprint login [email protected]
buildprint login [email protected] --app my-app --branch test
buildprint login [email protected] --app my-app --version test --session my-app
buildprint login [email protected] --no-browser

Por padrão, o comando tenta instalar cookies no agent-browser. Se isso falhar, ele imprime os comandos de fallback exatos agent-browser cookies set.