Criar e administrar um VPS conversando com uma IA: guia prática do MCP da ArduMaker

Publicado em 2026-08-25 por frfrand

Guía práctica para crear, encender, redimensionar y administrar servidores VPS conversando con una IA a través del MCP de ArduMaker. Incluye un ejemplo de uso cotidiano para cada herramienta: crear_vps, controlar_vps, cambiar_plan_vps, ejecutar_comando_vps, ver_estado_vps, crear_usuario_vps, crear_redireccion_vps y más.

Administrar um servidor sempre foi a mesma coisa: abrir um painel, procurar o botão certo, lembrar do comando exato. Com o MCP da ArduMaker, um servidor é administrado descrevendo o que você quer que aconteça.

Este artigo percorre as ferramentas da área de VPS do MCP e, para cada uma, mostra um uso concreto do dia a dia. Todas são invocadas conversando em espanhol com uma IA conectada a https://mcp.ardumaker.com/mcp.

Duas coisas antes de começar, que economizam metade dos tropeços.

Primeiro: todas as ferramentas desta área levam company_id além do vps_id. Os VPS pertencem a uma empresa, não a uma pessoa. listar_empresas retorna os IDs que você pode usar, e ver_contexto_inicial fornece de uma vez as empresas, os projetos e os VPS visíveis para sua sessão, além do escopo com o qual foi autorizado. Vale a pena que seja a primeira chamada de qualquer conversa.

Segundo: seu VPS é um container LXC dentro de um host pai compartilhado. Essa máquina de cima tem o IP público, o nginx que termina o HTTPS, os certificados e os redirecionamentos de porta — e você não tem acesso a ela. Seu VPS é o de dentro: processos, serviços, tarefas, usuários, bancos, código. A divisão importa principalmente ao publicar portas ou domínios, e tem sua seção abaixo.

Ferramentas cobertas: listar_planes_vps, listar_empresas, crear_vps, listar_vps, ver_vps, editar_vps, controlar_vps, cambiar_plan_vps, ver_estado_vps, ver_stats_vps, ejecutar_comando_vps, redeploy_repo_github, listar_usuarios_vps, crear_usuario_vps, editar_usuario_vps, ver_usuario_vps, ver_estado_red_vps, listar_redirecciones_vps, crear_redireccion_vps y eliminar_redireccion_vps.

Levantar um servidor novo

listar_planes_vps — "Quais planos estão disponíveis?" Retorna os planos ativos com sua CPU, RAM e disco, cada um com seu plan_id. É a chamada prévia obrigatória, porque criar e redimensionar pedem esse id, não um nome: não existe o plano "médio", existe o plano 3. Uso típico: chega um cliente novo e quer saber qual opção cabe em um WordPress pequeno sem superdimensionar.

crear_vps — "Crie um VPS para a loja do cliente" Cria a máquina dentro de uma empresa, a partir de um company_id e um plan_id. Três coisas que vale a pena saber:

• É para administradores. Somente um admin da empresa (ou um admin do sistema) pode criar um VPS. Se o seu usuário for membro comum, a chamada é rejeitada.
• Volta logo, mas o servidor não está pronto. Retorna status: "creating" e o provisionamento continua em segundo plano por vários minutos: cria o container, atualiza o sistema, instala as ferramentas base, abre a porta do agente, atribui o nome DNS e cria o usuário admin. Para saber como está, consulta com ver_vps ou ver_estado_vps.
• Se sua sessão estiver limitada a certos VPS, o recém-criado não será visível para esse agente até que seu dono o adicione ao escopo da conexão.

Uso típico: inicia um projeto na segunda-feira de manhã e, em vez de preencher um formulário, você pede em uma frase enquanto continua falando sobre o restante do plano — sabendo que em alguns minutos terá que perguntar se já está pronto.

listar_vps — "Quais servidores temos ativos?" Retorna as máquinas de uma empresa, respeitando a visibilidade de cada uma (as listas de membros permitidos e excluídos). Uso típico: revisão mensal de infraestrutura, para detectar servidores que ficaram ligados sem projeto associado.

ver_vps — "Me conte tudo sobre o VPS de produção" Ficha completa de uma máquina. Se quem pergunta for administrador da empresa, inclui também as listas de acesso. Uso típico: quando alguém novo entra na equipe e precisa entender o que é cada servidor sem pedir acesso ao painel.

editar_vps — "Renomeie para 'api-produccion' e dê acesso à Ana" Altera o nome, move a máquina para outra empresa ou gerencia quem a vê: adiciona e remove pessoas das listas de permitidos e excluídos, sempre com IDs de pessoas que já sejam membros da empresa do VPS. Apenas administradores da empresa. Atenção a um detalhe: mover o VPS para outra empresa reseta as listas de acesso. Uso típico: quando um projeto interno passa a ser faturado para um cliente e é necessário reorganizar a quem pertence cada recurso.

O que não está, e é de propósito: não existe uma ferramenta para excluir um VPS. Nenhum agente MCP pode apagar uma máquina, independentemente do escopo e de quem seja o administrador. Está na lista curta de operações proibidas para sempre, junto com excluir um projeto inteiro e alterar os membros de um projeto. Dar baixa em um servidor é uma decisão tomada no painel, com um humano acompanhando.

Operar o servidor no dia a dia

controlar_vps — "Reinicie o servidor de staging" Ligue, desligue ou reinicie uma máquina (action: start, stop, restart). Apenas administradores da empresa, e com razão: stop e restart interrompem tudo o que estiver rodando. Uso típico: o clássico "algo travou estranho depois do deploy", resolvido sem abrir o console nem procurar o botão.

cambiar_plan_vps — "Está justo de RAM, subo um plano" Redimensiona CPU, RAM e disco. Pede o plan_id que sai de listar_planes_vps, e também é apenas para administradores. Uso típico: uma campanha de marketing dispara o tráfego e é preciso escalar antes do fim de semana, não na segunda-feira.

ver_estado_vps — "Como está o servidor agora mesmo?" Estado do sistema ao vivo, tirado da API interna da máquina, mais os dados salvos. Uso típico: primeira parada quando um cliente escreve "o site está lento" e você precisa de um diagnóstico em trinta segundos.

ver_stats_vps — "Mostre o consumo de recursos" Uso de CPU, memória e disco. É a mesma informação que ver_estado_vps traz em seu bloco de estado do sistema, servida sozinha. Uso típico: justificar com dados se vale a pena subir de plano ou se o problema é a aplicação e não a máquina.

ver_estado_red_vps — "Como está a rede desta máquina?" Interfaces de rede, peers do WireGuard, IP do Tailscale. É notavelmente mais lenta que as demais porque se conecta ao VPS no momento: pode demorar até vinte segundos. Uso típico: quando dois servidores precisam se enxergar e algo no meio não está conectando.

redeploy_repo_github — "Traga o último do main e redespelgue" Dispara um git pull e o redespelhamento de um repositório já vinculado ao VPS. Retorna imediatamente: o pull roda em segundo plano e o estado é consultado depois com ver_repo_github_vps.

ejecutar_comando_vps: a ferramenta que convém usar menos

Executa um comando de shell no VPS e devolve sua saída. É o mais parecido com um terminal que o protocolo permite — uma sessão interativa e persistente não é possível sobre chamadas MCP. O parâmetro se chama script.

E aqui vai o conselho mais importante deste guia, que é o que a própria ferramenta dá sobre si mesma: se existe uma ferramenta dedicada para o que você quer fazer, use essa. Um shell pode fazer quase tudo o que as outras ferramentas desta série fazem —systemd, tarefas, usuários, domínios, nginx, redirecionamentos, bancos de dados, deploys— e passar pelo shell é pior por três motivos concretos:

• Não correm as proteções. eliminar_servicio_vps se recusa a excluir um serviço crítico; ejecutar_ddl_db_vps faz você nomear o objeto que está prestes a destruir. systemctl e psql digitados aqui não fazem nenhuma das duas coisas.
• O registro perde o verbo. Esta ferramenta anota no log de atividade do VPS exatamente uma coisa: que um script foi executado. Não anota qual foi o comando. eliminar_servicio_vps anota qual serviço. Quem ler esse log daqui a seis meses vai ver que um agente executou algo, e nunca o quê.
• Retorna texto para analisar em vez de campos estruturados com IDs que você pode passar para a próxima chamada.

Reserve-a para o que realmente não tem ferramenta: ler um arquivo, executar um build, inspecionar algo solto.

As regras da casa, que vale a pena conhecer antes de bater nelas:

• Os comandos que parecem destrutivos são rejeitados. rm -rf, mkfs, dd contra um dispositivo, shutdown, reboot, userdel, DROP DATABASE, fork bombs: retorna um 409 com o que coincidiu, e é necessário reenviar com confirmado=True. É uma rede contra acidentes, não uma barreira de segurança — qualquer pessoa que possa abrir um shell pode burlar isso.
• A saída é cortada em 20.000 caracteres, mantendo o início e o fim. Quando isso acontece, vem truncated: true. A solução é filtrar dentro do próprio comando com grep/head/tail, não repetir esperando que saia menos.
• O timeout é limitado a 300 segundos. O agente do VPS mata o que ultrapassar esse limite, então esperar mais não adianta: para trabalhos longos, execute-os em segundo plano e verifique o log em outra chamada.
• Vinte comandos por minuto por VPS.
• O diretório de trabalho é lembrado entre chamadas (persistente, ativado por padrão): um cd /app seguido de npm install ocorre onde você espera. Apenas o diretório persiste — variáveis de ambiente e processos em segundo plano não, pois cada chamada continua sendo seu próprio shell.
• A saída chega marcada como conteúdo não confiável. O que um comando imprime foi escrito por qualquer pessoa — um log, um arquivo, uma resposta de rede — então o servidor o entrega à IA como dados, nunca como instruções.

Uso típico razoável: revisar um arquivo de configuração, verificar qual versão está instalada, ver o que está ouvindo em uma porta. Uso típico a evitar: reiniciar um serviço com systemctl quando existe controlar_servicio_vps.

Usuários do Linux

listar_usuarios_vps — "Quem tem conta neste servidor?" Lista as contas de Linux da máquina. Uso típico: auditoria trimestral de acessos, ou revisar quem ficou com conta depois de alguém deixar a equipe. Toda máquina nova começa com um usuário admin com sudo, criado durante o provisionamento.

criar_usuario_vps — "Crie uma conta para o novo desenvolvedor, com sudo" Cria uma conta de Linux com senha, com ou sem permissões de administrador, e por padrão exige que a senha seja alterada no primeiro login (force_password_change, ativado a menos que você desative). Uso típico: onboarding. Em vez de uma sessão SSH e três comandos, é uma frase.

editar_usuario_vps — "Mude a senha e tire o sudo dele" Atualiza a senha ou a pertença ao grupo sudo — é necessário pelo menos uma das duas. Uso típico: rotação de credenciais, ou reduzir permissões quando alguém muda de função.

ver_usuario_vps — "Quais permissões esta conta tem?" Detalhe de um usuário específico. Uso típico: confirmar antes de um deploy que a conta de serviço tem o que precisa e nada mais.

Portas: onde seu aplicativo é publicado realmente

Esta é a parte onde a arquitetura de duas camadas deixa de ser um detalhe e passa a ser a única coisa que importa.

Seu VPS não tem um IP público próprio. O IP que a internet vê é o do host pai, compartilhado com outros VPS. Uma "redireção" é um dispositivo proxy que o host cria contra seu container: abre um porta dele e a conecta contra um porta dentro da sua máquina.

internet → IP del host padre : <puerto del host>  →  tu VPS : <puerto del container>

O porta do host não é escolhido por você: é atribuído automaticamente do intervalo livre. Você diz qual porta de dentro quer publicar; o sistema retorna por qual porta de fora fica acessível. Por isso, a resposta da criação é o dado que deve ser salvo.

listar_redirecciones_vps — "Quais portas estão expostas?" Mostra os encaminhamentos TCP e UDP configurados, cada um com seu host_port e seu container_port, além do IP do host. Uso típico: revisão de segurança, para encontrar portas que foram abertas para um teste e ficaram abertas. Duas coisas que você vai notar: o porta do agente do ArduMaker não aparece na lista, e a redireção de SSH vem marcada à parte com seu vencimento.

crear_redireccion_vps — "Expõe a porta 3000 do app" Cria o encaminhamento contra um porta interno do VPS (container_port, TCP por padrão) e abre o firewall do host para o porta que foi atribuído. Uso típico: publicar um painel do n8n, uma API ou um ambiente de demonstração. É também o passo que falta quando um domínio recém-publicado retorna 502: sem redireção, o nginx de borda não tem com o que falar.

Dois comportamentos que vale a pena conhecer:

• É idempotente. Se já existir um redirecionamento para essa mesma porta e protocolo, ele devolve o que já estava em vez de criar outro.
• Há portas que nunca saem para a internet. A do agente do ArduMaker, a do PostgreSQL (5432) e a do MySQL/MariaDB (3306) ficam sempre restritas à rede privada do Tailscale, mesmo que você solicite o redirecionamento. O motivo é concreto: a senha padrão dos bancos nesses VPS é o slug do servidor, e o slug é público. Expor a 5432 na internet seria deixar o banco sem senha. Se você quiser acessar seu banco de fora, o caminho é um túnel, não um redirecionamento.

SSH é um caso especial, e é o mais usado. O acesso SSH não vem aberto: ele é aberto criando um redirecionamento para a porta 22, e aí você pode passar closed_in_hs, que fecha sozinha após N horas. É a forma correta de dar acesso temporário a alguém sem depender de que se lembre de pedir para você fechá-la. Sem esse parâmetro, fica aberta até que você a exclua.

eliminar_redireccion_vps — "Feche a porta da demonstração, já terminou" Exclui um encaminhamento específico, pelo device_name que vem de listar_redirecciones_vps. É o oposto do anterior, e o motivo pelo qual convém solicitá-la no mesmo momento em que a demonstração terminar.

TÚ: Se quejan de que la API va lenta. Fijate qué pasa.

IA: ver_contexto_inicial() -> empresa 3, VPS visibles: 14 (api-produccion), 9, 7

ver_estado_vps(company_id = 3, vps_id = 14) -> carga alta, memoria al 94%

ver_stats_vps(company_id = 3, vps_id = 14) -> la memoria viene saturada desde hace tres días

ejecutar_comando_vps(company_id = 3, vps_id = 14, script = "df -h /") -> disco al 88%

"La máquina está sin memoria desde el martes y el disco va por el 88%. El plan actual se quedó corto."

TÚ: Subila un plan y reiniciá.

IA: listar_planes_vps() -> [{ "id": 2, "nombre": "..." }, { "id": 3, ... }]

cambiar_plan_vps(company_id = 3, vps_id = 14, plan_id = 3) controlar_vps(company_id = 3, vps_id = 14, action = "restart") -> { "status": "running" }

"Listo. Ahora tiene el doble de RAM y ya está arriba. Aviso: cambiar plan y reiniciar son acciones de admin de la empresa — si tu usuario no lo fuera, las dos habrían sido rechazadas y te lo habría dicho antes de intentar."

Perguntas frequentes

Precisa saber Linux para administrar um VPS assim? Ajuda, mas não é indispensável para as tarefas comuns. Você pode pedir "revisá si hay disco lleno" sem saber que isso se traduz em df -h.

A IA pode excluir um servidor? Não. Nenhum agente MCP pode excluir um VPS, independentemente do escopo. Está na lista de operações proibidas para sempre, junto com excluir um projeto inteiro, acessar os membros de um projeto e manipular anexos marcados como secretos. Desligar pode, se quem autorizou for administrador da empresa; excluir, não existe esse caminho.

A IA pode desligar um servidor por engano? Ela só age quando você pede, apenas sobre as máquinas que seu usuário já podia administrar, e ligar, desligar ou reiniciar são ações reservadas a administradores da empresa. Se você também autorizou a sessão em modo somente leitura, nem isso.

Posso continuar usando SSH normalmente? Sim, mas há um passo prévio: a porta SSH não está aberta por padrão. Ela é aberta com crear_redireccion_vps contra a porta 22, e convém passar closed_in_hs para que ela feche sozinha. Você vai entrar pelo IP do host pai e pela porta que foi atribuída, não pela 22.

Por que não consigo conectar ao meu banco de dados de fora? Porque 5432 e 3306 ficam restritos à rede privada mesmo que você crie o redirecionamento: a senha padrão desses bancos é o slug do VPS, que é público. Use um túnel.

Por que todas as ferramentas pedem company_id? Porque os VPS pertencem a uma empresa. listar_empresas te dá os ids, e ver_contexto_inicial te dá todo o mapa de uma.

Como conecto o MCP? Adicionando o servidor https://mcp.ardumaker.com/mcp em um cliente compatível com o protocolo MCP e autorizando com sua conta da ArduMaker.

Este guia faz parte de uma série sobre as ferramentas do MCP da ArduMaker. Cada artigo cobre uma área de trabalho com exemplos reais de uso cotidiano.