Você escreve o bot na sua máquina. Com as ferramentas do desenvolvedor da MyBotCloud, publicar, pausar, reiniciar, trocar variáveis e apagar acontece do terminal, do VS Code ou de um agente de IA, sem abrir o painel. O código é empacotado no seu computador e só o pacote vai para a plataforma.
São três formas de usar a mesma coisa: o CLI (mybotcloud), a extensão do VS Code e um servidor MCP para assistentes de IA. Todas fazem exatamente as mesmas operações.
Onde baixar: o CLI e a extensão do VS Code estão para download no site do MyBotCloud (na página inicial ou em Desenvolvedor no painel). Eles não estão no npm nem no Marketplace do VS Code, e o SHA-256 de cada arquivo fica publicado ao lado dele (
/downloads/checksums.txt).
1. Crie uma chave de API
- Entre no painel e abra Desenvolvedor no menu lateral.
- Dê um nome à chave (por exemplo
notebook) e clique em Criar chave. - Copie a chave agora: ela começa com
mbc_e não é mostrada de novo. A plataforma guarda só uma impressão digital dela.
O que uma chave pode: publicar, pausar, iniciar, reiniciar, ver logs, mudar variáveis e apagar as suas aplicações. O que ela não pode: acessar sua conta, o suporte ou criar outras chaves. Mesmo assim, trate-a como uma senha. Você pode ter até 5 chaves e revogar qualquer uma no painel; a revogação vale na hora.
2. Instale o CLI
Precisa do Node 20 ou mais novo. Baixe o arquivo do CLI (mybotcloud-<versão>.tgz) e instale:
npm install -g ./mybotcloud-<versão>.tgz
mybotcloud --help
O pacote já traz tudo o que precisa, então a instalação não baixa mais nada.
No Linux (e no WSL) o npm install -g pode falhar com EACCES: permission denied, porque o npm tenta gravar numa pasta do sistema. Sem sudo, instale na sua própria pasta:
npm install -g --prefix ~/.local ./mybotcloud-<versão>.tgz
export PATH="$HOME/.local/bin:$PATH" # coloque esta linha no ~/.bashrc para valer sempre
mybotcloud --help
3. Crie o mybotcloud.config
Na pasta do seu bot:
mybotcloud init
Isso cria o mybotcloud.config (um JSON) e o adiciona ao .gitignore, para a chave não ir parar no Git:
{
"name": "meu-bot",
"type": "bot",
"main": "index.js",
"start": "node index.js",
"ram": 100,
"key": "mbc_…"
}
| Campo | Para que serve |
|---|---|
name | O nome da aplicação. No primeiro envio, é como a app é criada ou encontrada. Depois, o id (veja abaixo) liga a pasta à app. |
main | O arquivo de entrada. Node: .js, .mjs ou .cjs. Python: main.py, app.py, bot.py ou run.py na raiz do projeto. |
type | bot ou app. Por enquanto é só informativo: os dois rodam do mesmo jeito. |
start | O comando de início. node index.js roda direto e usa cerca de 60 MB a menos que npm start, o que importa num plano de 100 MB. Em Python só vale python <arquivo>. |
ram | A RAM que você espera, em MB. É só conferida: um app novo começa com a parte padrão do plano (Start: 100 MB; Pulse e Orbit: 200 MB) e você ajusta depois com mybotcloud ram. Pedir mais que a RAM total do plano dá erro antes de qualquer envio. |
key | A chave de API. Veja a nota de segurança abaixo. |
envFile | (opcional) Um arquivo .env cujas variáveis são enviadas junto. Ele nunca vai dentro do pacote. |
ignore | (opcional) Pastas ou arquivos para deixar de fora do pacote. |
id | Gravado pela ferramenta no primeiro envio. Liga a pasta à app mesmo que você mude o name (renomear a app na plataforma ainda não é suportado). Não edite. |
version | (opcional) Um rótulo seu para a versão. Informativo. |
Deixando pastas de fora: .mybotcloudignore
Crie um arquivo .mybotcloudignore na raiz, com um padrão por linha:
# pastas pesadas
data/
*.log
/rascunhos
nome vale em qualquer profundidade, /nome ou a/b valem a partir da raiz, e *, ** e ? são curingas. Linhas com ! (exceção) não são suportadas. O arquivo soma-se ao campo ignore. node_modules já fica sempre de fora.
Um campo desconhecido no config é um erro: assim um nome digitado errado não passa em silêncio.
Onde colocar a chave
Em ordem de prioridade: a variável de ambiente MYBOTCLOUD_KEY, o cofre do VS Code (comando Definir a chave de API) ou o campo key do arquivo. O mais seguro é não deixar a chave no arquivo.
Em desenvolvimento local, aponte para o seu servidor com MYBOTCLOUD_URL=http://localhost:3000. O endereço do servidor nunca é lido do mybotcloud.config: assim um projeto clonado de terceiros não consegue redirecionar a sua chave para outro lugar.
4. Publique
mybotcloud deploy --dry-run # mostra o que seria enviado, sem enviar
mybotcloud deploy
O CLI monta o ZIP na sua máquina e já confere o que a plataforma recusaria: ZIP de até 5 MB, 20 MB descompactado, 2 MB por arquivo, 300 arquivos, nada de binários. Ficam sempre de fora: o mybotcloud.config, qualquer arquivo que comece com ponto (.env, .git), node_modules, __pycache__ e venv. Arquivos com extensão não aceita (.sh, .png...) também ficam de fora, e o CLI avisa quais.
No primeiro deploy a app é criada; nos seguintes, atualizada no lugar. Se a versão nova não subir, a anterior é restaurada e a saída do próprio bot é mostrada para você ver o erro.
5. O dia a dia
mybotcloud status # estado, memória e nomes das variáveis
mybotcloud stop # pausa
mybotcloud start # inicia
mybotcloud restart # reinicia (leva de 15 a 30 s)
mybotcloud logs -n 100 # últimas linhas do log
mybotcloud delete --yes meu-bot # apaga de vez
O delete só funciona se você repetir o nome exato da app. Uma flag solta ou um comando digitado sem pensar não apagam nada.
Adicione --json a qualquer comando para obter uma saída para scripts.
Variáveis de ambiente (tokens e senhas)
mybotcloud env list # só os nomes
mybotcloud env set DISCORD_TOKEN=abc123 # grava (o bot reinicia)
mybotcloud env set --from-file .env # grava tudo de um arquivo
mybotcloud env unset DISCORD_TOKEN # remove
Os valores nunca voltam: nem na resposta, nem nos logs, nem no painel. O CLI só mostra nomes. Prefira --from-file ou o campo envFile, porque um valor digitado na linha de comando fica no histórico do seu terminal.
Se você usa envFile no mybotcloud.config, o deploy envia as variáveis junto: na criação, antes da primeira execução (o bot que exige token já sobe com ele); nas atualizações, antes do código novo.
6. Extensão do VS Code
Baixe o arquivo da extensão (mybotcloud-vscode-<versão>.vsix) na mesma página. No VS Code, abra Extensões → … → Instalar do VSIX, ou, pelo terminal:
code --install-extension mybotcloud-vscode-<versão>.vsix
Ao abrir a pasta do seu bot, o VS Code pergunta se você confia nos autores da pasta (Modo Restrito). Clique em Sim, confio: a extensão só funciona em pastas confiáveis, como toda extensão que lê e envia arquivos do projeto.
A barra lateral
Um ícone de nuvem aparece na barra de atividades. Sem chave, ele mostra o botão Entrar com a chave de API: cole a chave (a extensão a confere no servidor antes de guardar, e a guarda no cofre do VS Code, não no projeto). Depois você vê:
- Conta: seu plano, a RAM do plano (dividida entre os seus bots: o que as suas apps usam / o total) e quantas aplicações você usa do limite.
- Meus aplicativos: cada app com um ícone de nuvem verde (no ar), cinza (pausada) ou vermelha (com falha), a linguagem, o estado e a memória. Expanda para ver estado, memória, tempo ativo e reinícios.
Passe o mouse sobre uma app para ver os botões iniciar/parar, reiniciar e logs. Clique com o botão direito para o menu completo: status, logs, atualizar código, adicionar ou remover variável e apagar. Você pode agir sobre uma app clicada mesmo numa pasta sem mybotcloud.config. A lista atualiza sozinha a cada 15 segundos.
Comandos (paleta e atalhos)
Na paleta (Ctrl+Shift+P, digite mybotcloud):
| Comando | O que faz |
|---|---|
| Login / Logout | Guarda ou remove a chave neste computador. O login confere a chave no servidor antes de guardar |
| Create Configuration File | Cria o mybotcloud.config sugerindo valores do seu package.json, e abre para você revisar |
| Deploy Application | Cria ou atualiza, o que se aplicar à pasta. Mostra o progresso e, no fim, oferece Ver logs |
| Create Application from Project / Update Application | Só cria / só atualiza |
| View Application Status | Estado, memória usada/limite, CPU, disco, rede, tempo ativo, reinícios, ID e último deploy |
| Start / Stop / Restart Application | Controle do bot. A árvore se atualiza sozinha |
| View Logs / Clear Logs | Acompanha o log da app em um canal próprio; só as linhas novas são acrescentadas. Rodar de novo reconecta |
| Edit Environment Variables | Lista só os nomes; adicionar, trocar o valor (caixa que esconde o texto) ou remover |
| Edit RAM | Escolha entre os tamanhos que o seu plano permite (ou digite outro valor dentro do limite) |
| Backup Application / Download Backup | Guarda um instantâneo na plataforma (os 3 mais recentes) / baixa um deles |
| Copy Application ID | Copia o ID da app |
| Delete Application | Janela de confirmação; Cancelar não apaga nada |
Atalhos: Ctrl+Alt+M abre o menu de ações e Ctrl+Alt+U atualiza a app. A barra de status mostra MyBotCloud: conectado (ou pede para entrar de novo se a chave foi recusada) e abre o menu.
Você também pode clicar com o botão direito numa pasta no Explorer (ou no mybotcloud.config) e escolher Deploy Application ou Update Application. O mybotcloud.config ganha validação e autocompletar. Se faltar a configuração, o erro traz um botão Criar arquivo de configuração.
Sobre o progresso do deploy: a extensão mostra as duas etapas que ela realmente acompanha: validar e compactar e enviar e publicar. A instalação das dependências e a partida do app acontecem no servidor, dentro do mesmo envio, e o servidor só devolve o resultado final.
Sobre os logs: a plataforma ainda não tem transmissão contínua; a extensão consulta o log a cada poucos segundos (mais devagar quando o bot fica quieto).
- Em desenvolvimento local, defina a configuração
mybotcloud.serverUrlcomohttp://localhost:3000. Ela só pode ser mudada nas suas configurações de usuário, nunca por um projeto. - Para RAM, nome, avatar, backup, equipe e domínios, veja Equipe, domínios, backup e RAM: como funciona na MyBotCloud.
7. Deixe uma IA operar o bot (MCP)
O MCP (Model Context Protocol) é o jeito de assistentes de IA, como o Claude Code, chamarem ferramentas. O comando mybotcloud mcp expõe 21 ferramentas. As de operar o bot são mybotcloud_deploy, _status, _stop, _start, _restart, _logs, _env_list, _env_set e _delete; as outras cobrem RAM, nome, avatar, backups, equipe e domínios. Nenhuma abre um shell dentro do seu container.
Ele usa o CLI instalado no passo 2. No Claude Code:
claude mcp add mybotcloud -e MYBOTCLOUD_KEY=mbc_… -- mybotcloud mcp
Em outros clientes, a configuração costuma ser:
{
"mcpServers": {
"mybotcloud": {
"command": "mybotcloud",
"args": ["mcp"],
"env": { "MYBOTCLOUD_KEY": "mbc_…" }
}
}
}
Depois é só pedir: "publique o bot", "reinicie e me mostre os logs". O servidor trabalha na pasta onde foi iniciado, relendo o mybotcloud.config a cada chamada.
Dois cuidados:
- A ferramenta de apagar exige o nome exato da app (
confirmName). Peça à IA para confirmar com você antes. - Um valor de variável que a IA passa em
mybotcloud_env_setpassa pela conversa com ela. Para tokens e senhas, prefira oenvFile.
Segurança, em resumo
- A chave é guardada na plataforma só como impressão digital e mostrada uma vez.
- Ela só abre as rotas das suas aplicações. Não acessa conta, suporte nem outras chaves.
- O config, a chave e o
.envnunca entram no pacote enviado. - O endereço do servidor não vem do projeto.
- Os valores das variáveis são só de escrita.
- Revogou a chave? Ela deixa de funcionar na próxima requisição.
Problemas comuns
| Mensagem | O que fazer |
|---|---|
Sem chave de API | Coloque a chave em key, em MYBOTCLOUD_KEY ou no cofre do VS Code. |
[401] ... inválida ou revogada | A chave foi revogada ou copiada incompleta. Crie outra no painel. |
[409] Seu plano não permite mais aplicações | O plano Start (grátis) tem uma aplicação. Apague a outra ou fale com o suporte. |
ram ... passa da RAM total do seu plano | Diminua ram (ou remova o campo). |
Python: o servidor executa o primeiro que existir entre main.py... | Renomeie o arquivo de entrada para um desses nomes, na raiz. |
A linguagem não muda depois de criada | Apague a app e faça o deploy de novo. |
Ficou com dúvida? Abra um ticket no Suporte do painel.