01
> Baixe o instalador
Na página de confirmação da compra há um botão para Windows e outro para Mac (o e-mail do pedido traz o link para essa página). É um arquivo só para os dois programas.
Instalação · Windows e Mac
Cole a chave. O instalador faz o resto.
Um instalador só, para os dois programas. A chave da licença diz qual instalar: no pacote, você cola as duas.
> Passo a passo
Do pagamento à primeira pergunta
02
> Abra o arquivo
O Windows e o macOS mostram um aviso na primeira vez, porque o instalador ainda não tem assinatura de código. Os cliques estão logo abaixo.
03
> Cole a chave
Cole a chave da licença. Comprou o pacote? Cole as duas no mesmo campo, uma por linha (vírgula ou espaço também servem, e dá para colar o e-mail inteiro): o instalador descobre qual programa é cada uma, baixa a versão certa e confere o arquivo.
04
> Crie o seu aplicativo
O Alpha ERP usa um aplicativo seu no Bling; o Alpha Commerce, um aplicativo seu no Mercado Livre e/ou a chave da API da sua loja WooCommerce (na tela Conectar loja WooCommerce do instalador). É o único passo que leva alguns minutos: o instalador mostra o que fazer e já entrega o endereço de retorno para você copiar.
05
> Ligue ao seu assistente
O instalador mostra os assistentes que achou no computador (Claude Desktop, Cursor, Windsurf, Gemini CLI, VS Code). Marque os que quiser e clique: ele escreve o programa na configuração de cada um. Feche e abra o assistente de novo e peça: "Conecte minha empresa do Bling".
> Primeira vez
Se o computador mostrar um aviso
> Windows 10 e 11
- Dê duplo clique no arquivo baixado.
- Se aparecer "O Windows protegeu o computador", clique em Mais informações e depois em Executar assim mesmo.
- Abre uma janela preta com um endereço: é o instalador funcionando. Deixe-a aberta até terminar. O assistente abre no navegador.
> macOS 13.5 ou mais novo
- Abra o .zip baixado e dê duplo clique em Instalar Alcateia.command.
- macOS 14 ou anterior: se aparecer o aviso de desenvolvedor não identificado, clique com o botão direito no arquivo, escolha Abrir e confirme.
- macOS 15 (Sequoia) ou mais novo: abra Ajustes do Sistema, Privacidade e Segurança, e clique em Abrir Mesmo Assim ao lado do aviso.
- Outro caminho, que não passa pelo aviso: no Terminal, digite
bashe um espaço, arraste o arquivo para a janela e aperte Enter.
> Por dentro
O que o instalador faz
- Instala na sua pasta de usuário, sem senha de administrador. No Windows, em %LOCALAPPDATA%\Alcateia; no Mac, em ~/Library/Application Support/Alcateia. O Node.js que roda os programas vai junto: você não precisa instalar nada.
- Confere o que baixa. O arquivo só é usado se for exatamente o que a Alcateia publicou, e as respostas do servidor de licenças vêm assinadas: se a assinatura não bater, o instalador não instala nada.
- Guarda os dados do seu aplicativo só no seu computador. O Client ID e o Client Secret (os dados do aplicativo que você cria no Bling ou no Mercado Livre) ficam num arquivo da sua pasta de usuário, e as contas conectadas ficam criptografadas, com uma senha que o instalador cria.
- Liga aos assistentes só quando você clica. Ele liga o programa ao assistente de cada caixa marcada, sem mexer no resto das configurações dele, e guarda uma cópia do que alterou. Só o Claude Desktop teve o formato conferido: Cursor, Windsurf, Gemini CLI e VS Code seguem a documentação de cada um e estão marcados como experimentais.
- O que a Alcateia recebe: a chave de acesso, qual programa é, a versão, a data, um código aleatório da instalação e quantas consultas foram feitas (só o número). Ela nunca vê seus pedidos, produtos ou clientes.
> Perguntas
CONSULTAR_BASEO aviso aparece para todo programa sem assinatura de código, que é um certificado pago, vendido à parte. Ainda não temos o nosso. Quando tivermos, o aviso some e esta página muda.
Não. No Windows, o instalador já traz o que roda os programas. No Mac, ele baixa na primeira vez o Node.js (um componente gratuito, do site nodejs.org) e confere se o arquivo é o certo.
Não. Cole as duas chaves na primeira tela, no mesmo campo, uma por linha, e ele instala os dois programas, um após o outro, cada um com o seu formulário.
É o padrão que permite a um assistente de IA, como o Claude, usar programas de fora com segurança, por exemplo para consultar o seu ERP. Os produtos da Alcateia seguem esse padrão. Você não precisa entender nem mexer nisso: o instalador faz a ligação.
Sozinho. Ao abrir o assistente, e a cada 24 horas, o programa pede ao instalador (sem janela) que procure uma versão nova. O servidor da Alcateia confere a sua licença e só libera o que a assinatura cobre; o instalador baixa, confere e troca, e volta para a versão anterior se a nova não abrir. Seus aplicativos e contas continuam. Para desligar, ou para buscar na hora, abra o instalador: há a opção Atualizar sozinho e o botão Buscar atualização.
Não. No WooCommerce, abra o instalador e use Conectar loja WooCommerce; no Bling e no Mercado Livre, peça ao assistente "conecte outra empresa" ou "conecte outra conta". Só a nova é conectada: as que já estavam continuam como estão.
Abra o instalador e clique em Desinstalar. No Windows, também aparece em Aplicativos instalados. Ele tira os programas dos assistentes onde foram ligados e apaga os arquivos que instalou; o arquivo das contas conectadas só é apagado se você marcar a opção, e ao instalar de novo você conecta as contas outra vez.
Escreva para [email protected] com o que apareceu na tela. Não precisa enviar a chave nem o Client Secret.
> AINDA_SEM_CHAVE
O instalador vem
com a assinatura.
Pagamento pelo Mercado Pago, no cartão, sem sair do site. Assinatura anual: cancele quando quiser.
Dúvida antes? [email protected]