RT Cloud para VS Code
Gerencie a sua hospedagem RT Cloud sem sair do editor: aplicações e bancos com o estado ao vivo, logs, métricas de 24 horas e 7 dias, variáveis de ambiente, arquivos, snapshots com restauração acompanhada, domínios e o servidor MCP da RT Cloud para o modo agente.
Funciona no VS Code e nos editores que instalam extensões pelo Open VSX (VSCodium, Cursor, Windsurf e outros).
O que dá para fazer
- Barra lateral da RT Cloud: todas as aplicações e bancos de dados da conta com o estado ao vivo (no ar, desligada, preparando, suspensa), o estado da plataforma, o plano e a memória em uso.
- Painel da aplicação, no mesmo visual do painel web:
- Visão geral — CPU, memória, rede, armazenamento e tempo no ar ao vivo, detalhes, monitor do site ou do bot e as últimas publicações.
- Métricas — 24 horas ou 7 dias: CPU e memória (média, pico e agora), disponibilidade, quedas e os acessos do site (requisições, visitas, países, rotas, navegadores e respostas).
- Logs ao vivo — com pausa, filtro, cópia e “abrir no editor”.
- Variáveis — ver, criar, trocar e remover, com a opção de reiniciar para valer na hora.
- Arquivos — navegar pelas pastas e abrir no editor.
- Snapshots — criar agora e restaurar, com o andamento acompanhado até o fim e um snapshot de segurança do estado atual antes de restaurar.
- Domínios — endereço, subdomínio, registros DNS do domínio próprio com o estado de cada um e limpeza do cache do site.
- Ligar, desligar e reiniciar aplicações e bancos, e gerar backup de banco, direto da barra lateral.
- Arquivos no editor: abra a pasta da aplicação no Explorer, edite e salve — a mudança vai para a RT Cloud.
- Modo agente: o servidor MCP da RT Cloud fica registrado no chat do editor, para o assistente consultar e cuidar das aplicações com a sua permissão.
Começando
- Instale a extensão.
- No painel da RT Cloud, abra menu da conta → Chaves de API e gere uma chave (começa com
rtc_).
- No editor, clique no ícone da RT Cloud na barra de atividades e em Entrar com a chave de API. Cole a chave.
Pronto: as aplicações aparecem na barra lateral. Clique numa delas para abrir o painel.
Chave de assistente (arquivos, domínios e modo agente)
Os arquivos, os registros DNS e o histórico de CPU e memória chegam por uma segunda chave, a chave de assistente (começa com rtm_):
- No painel, abra Assistentes de IA e crie uma chave. Para editar arquivos aqui, marque Ler arquivos e Alterar código; para domínios e histórico, Ver aplicações.
- No editor, rode RT Cloud: Conectar a chave de assistente e cole a chave.
As duas chaves ficam no cofre do editor (o mesmo onde ele guarda senhas), nunca em arquivo ou configuração.
Arquivos no editor
Use Abrir os arquivos da aplicação no Explorer (botão direito na aplicação) ou a aba Arquivos do painel. A pasta aparece no Explorer como “nome-da-aplicação (RT Cloud)”.
- Salvar manda só os trechos que você mudou. Assim, o que a RT Cloud protege no arquivo nunca é regravado por cima.
- A mudança vale depois de reiniciar a aplicação. A extensão oferece reiniciar logo depois de salvar (dá para desligar esse aviso nas configurações).
- Segredos não passam por aqui:
.env, chaves privadas e certificados não aparecem, e credenciais que estejam escritas no código aparecem como [oculto]. Uma linha com [oculto] não pode ser alterada pela extensão — edite essa parte pelo painel web.
- Se o arquivo mudou na RT Cloud depois que você abriu, o salvamento é recusado sem gravar nada. Use Recarregar da RT Cloud (ícone no topo do editor) e refaça a mudança.
- Arquivos que não são texto (imagens, zips, bancos) e arquivos novos acima de 256 KB vão pelo painel web.
Modo agente (MCP)
A extensão registra o servidor MCP da RT Cloud no chat do editor. Abra o chat no modo agente e ative as ferramentas da RT Cloud.
- Com a chave de assistente conectada, o servidor entra direto com ela.
- Sem ela, o editor pede para você autorizar no site da RT Cloud na primeira vez.
- Em editores que ainda não têm esse registro automático, use RT Cloud: Adicionar o servidor MCP ao mcp.json deste projeto (VS Code ou Cursor) ou copie a configuração. O arquivo nunca leva a sua chave.
O servidor orienta o assistente a pedir a sua confirmação antes de desligar, restaurar, apagar ou trocar variáveis, e o editor mostra cada ação antes de rodar. Valores de variáveis, senhas e .env não passam pelo servidor MCP.
Comandos
Todos ficam na paleta de comandos (Ctrl+Shift+P) com o prefixo RT Cloud.
| Comando |
O que faz |
| Entrar com a chave de API |
Conecta a conta (chave rtc_) |
| Conectar a chave de assistente |
Libera arquivos, domínios, histórico e modo agente (chave rtm_) |
| Abrir painel da aplicação |
Abre o painel com as abas da aplicação |
| Ver logs ao vivo |
Abre o painel direto nos logs |
| Abrir os arquivos da aplicação no Explorer |
Põe a pasta da aplicação no Explorer |
| Ligar / Reiniciar / Desligar |
Liga, reinicia ou desliga a aplicação (desligar pede confirmação) |
| Abrir o endereço da aplicação |
Abre o site no navegador |
| Abrir no painel web |
Abre a aplicação no painel do site |
| Adicionar o servidor MCP ao mcp.json deste projeto |
Para editores sem o registro automático |
| Abrir a página de status |
Estado da plataforma |
| Recarregar da RT Cloud |
Lê de novo o arquivo aberto |
| Sair e apagar as chaves deste computador |
Remove as duas chaves do cofre do editor |
Configurações
| Configuração |
Padrão |
Para que serve |
rtcloud.atualizarACada |
20 |
Segundos entre as conferências da barra lateral (só com ela aberta) |
rtcloud.logs.intervalo |
4 |
Segundos entre as leituras dos logs ao vivo |
rtcloud.mcp.registrar |
true |
Registrar o servidor MCP no modo agente |
rtcloud.arquivos.avisarReinicio |
true |
Oferecer reiniciar depois de salvar um arquivo |
rtcloud.endereco |
https://rtcloud.com.br |
Só troque se o suporte pedir |
Limites
A extensão usa a API pública da RT Cloud e respeita os mesmos limites por chave: 60 leituras por minuto, 15 ações de ligar, desligar, reiniciar e snapshot por minuto e 20 alterações de variáveis por minuto. A barra lateral só confere o estado enquanto está aberta e usa uma única chamada para todas as aplicações. Se um limite for atingido, a extensão espera liberar sozinha.
Quando a RT Cloud está publicando uma atualização, a extensão mostra “RT Cloud em atualização” e continua normalmente quando ela volta — suas aplicações seguem no ar.
Segurança e privacidade
- As chaves ficam só no cofre do editor deste computador. Sair apaga as duas.
- A extensão fala apenas com o endereço da RT Cloud. Não há telemetria.
- A chave age com as mesmas permissões que você tem nas aplicações e equipes. Uma chave somente leitura funciona para acompanhar, mas não liga, desliga nem troca variáveis.
- Se uma chave vazar, revogue no painel: a próxima chamada com ela já é recusada.
Problemas comuns
- “A RT Cloud recusou a chave” — ela foi revogada ou venceu. Gere outra e entre de novo.
- Arquivos não aparecem — conecte a chave de assistente com Ler arquivos. O explorador de arquivos também precisa fazer parte do seu plano.
- “Nada foi gravado” ao salvar — o arquivo mudou na RT Cloud ou a mudança encostou numa parte protegida. Recarregue e refaça.
- Histórico de 7 dias mostra 24 horas — o histórico de 7 dias vale para aplicações a partir de 512 MB.
- Acessos do site vazios — os relatórios de acesso fazem parte do plano Carbon para cima.
Suporte
Documentação e suporte em rtcloud.com.br/docs.
| |