Publique seu bot pelo terminal, VS Code ou IA (MCP)

Publicado em 10 min de leitura

Use uma chave de API e um arquivo mybotcloud.config para fazer deploy, pausar, reiniciar, mudar variáveis e apagar seu bot sem sair do editor.

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

  1. Entre no painel e abra Desenvolvedor no menu lateral.
  2. Dê um nome à chave (por exemplo notebook) e clique em Criar chave.
  3. 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_…"
}
CampoPara que serve
nameO nome da aplicação. No primeiro envio, é como a app é criada ou encontrada. Depois, o id (veja abaixo) liga a pasta à app.
mainO arquivo de entrada. Node: .js, .mjs ou .cjs. Python: main.py, app.py, bot.py ou run.py na raiz do projeto.
typebot ou app. Por enquanto é só informativo: os dois rodam do mesmo jeito.
startO 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>.
ramA 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.
keyA 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.
idGravado 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):

ComandoO que faz
Login / LogoutGuarda ou remove a chave neste computador. O login confere a chave no servidor antes de guardar
Create Configuration FileCria o mybotcloud.config sugerindo valores do seu package.json, e abre para você revisar
Deploy ApplicationCria ou atualiza, o que se aplicar à pasta. Mostra o progresso e, no fim, oferece Ver logs
Create Application from Project / Update ApplicationSó cria / só atualiza
View Application StatusEstado, memória usada/limite, CPU, disco, rede, tempo ativo, reinícios, ID e último deploy
Start / Stop / Restart ApplicationControle do bot. A árvore se atualiza sozinha
View Logs / Clear LogsAcompanha o log da app em um canal próprio; só as linhas novas são acrescentadas. Rodar de novo reconecta
Edit Environment VariablesLista só os nomes; adicionar, trocar o valor (caixa que esconde o texto) ou remover
Edit RAMEscolha entre os tamanhos que o seu plano permite (ou digite outro valor dentro do limite)
Backup Application / Download BackupGuarda um instantâneo na plataforma (os 3 mais recentes) / baixa um deles
Copy Application IDCopia o ID da app
Delete ApplicationJanela 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.serverUrl como http://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_set passa pela conversa com ela. Para tokens e senhas, prefira o envFile.

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 .env nunca 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

MensagemO que fazer
Sem chave de APIColoque a chave em key, em MYBOTCLOUD_KEY ou no cofre do VS Code.
[401] ... inválida ou revogadaA chave foi revogada ou copiada incompleta. Crie outra no painel.
[409] Seu plano não permite mais aplicaçõesO plano Start (grátis) tem uma aplicação. Apague a outra ou fale com o suporte.
ram ... passa da RAM total do seu planoDiminua 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 criadaApague a app e faça o deploy de novo.

Ficou com dúvida? Abra um ticket no Suporte do painel.

  • cli
  • vscode
  • mcp
  • deploy
  • tutorial

← Voltar ao blog