VPS Full Stack
Crie um VPS com a sua própria base de dados, uma chave de API com âmbito limitado e um endpoint MCP, para que agentes de IA e o seu próprio código o possam controlar.
Um VPS Full Stack é um VPS Xuda normal com três coisas associadas no momento da criação: uma chave de API com âmbito limitado que pertence à máquina, a sua própria base de dados de projeto e um endpoint MCP que expõe como ferramentas chamáveis as capacidades da plataforma que escolher. É guardado como um VPS normal com uma marca, por isso todas as funcionalidades de um VPS simples, firewall, redimensionamento, energia, cópias de segurança, a rota web, funcionam nele sem alterações.
A Xuda tem também um tipo de implementação separado chamado MCP Server, que põe um endpoint MCP dedicado à frente das rotas de API de um projeto. É um produto diferente do endpoint aqui descrito, que está integrado na própria máquina.
Antes de começar
Não há nível gratuito: um VPS Full Stack é faturado à hora desde a primeira hora, em qualquer plano. Há duas coisas a decidir antes de clicar em criar, porque ambas ficam fixas no momento da criação:
- A classe de servidor partilhado não está disponível para este produto. Escolhê-la é recusado antes de ser aprovisionado o que quer que seja. Escolha Otimizado, Desempenho ou Grande.
- As capacidades são escolhidas uma só vez. O separador Ferramentas fica só de leitura depois. Decida o conjunto de capacidades no assistente.
Criar um
Abrir o fluxo Criar
Na galeria Criar, escolha App Full Stack em VPS. O assistente tem quatro passos: Potência, Configuração, Ferramentas, Finalizar detalhes. O passo Ferramentas é o que o assistente de um VPS simples não tem.
Escolher a região e a potência
Escolha uma região e depois um tamanho. O Otimizado é o ponto de partida sensato; o Desempenho troca disco por memória por núcleo; o Grande destina-se a discos locais muito grandes. Veja Tamanhos e preços geridos para a escala completa.
Escolher o sistema operativo
Um seletor de SO simples no alojamento da própria quinta da Xuda, ou o seletor completo de imagens e marketplace quando a máquina é aprovisionada na DigitalOcean. Escolha um sistema operativo limpo, a menos que tenha motivo para não o fazer.
Escolher os grupos de capacidades
Uma grelha de interruptores, todos ligados por predefinição, com Selecionar tudo e Limpar no topo. Cada interruptor é um grupo de métodos da plataforma; a união de todos os grupos deixados ligados passa a ser a lista de permissões na chave da máquina. Veja Grupos de capacidades abaixo para saber exatamente o que cada um concede.
Dar um nome à máquina e criá-la
As cópias de segurança automáticas são aqui também um extra pago opcional. Prima criar e uma vista de progresso mostra os passos reais: iniciar, emitir a chave de API, criar o servidor, definir a firewall e o plano de cópias de segurança, ligar ao servidor, instalar o conjunto de ferramentas, ativar.
No alojamento da própria quinta da Xuda, o cloud-init não instala o Node, a CLI nem o Codex. Uma máquina alojada na quinta continua a receber a sua chave, base de dados e endpoint MCP; instala você mesmo o conjunto de ferramentas se o quiser na máquina. O caminho em que está é visível no passo de Configuração: uma lista de SO simples significa a quinta, o seletor completo de imagens e marketplace significa a DigitalOcean.
Encontrar o endpoint e a chave
Abra o separador Ferramentas da máquina. O cartão Endpoint MCP tem um botão Copiar; copie-o daí em vez de escrever um de memória. Por baixo, cada grupo ativado é listado com os métodos que concedeu, e tudo o que desligou aparece numa faixa Não ativado.
Abra Chaves de API para a chave com o nome <nome da máquina> (full stack vps), o token bearer do
endpoint. Suspender esta chave a partir desse separador desliga de uma só vez toda a superfície de ferramentas da máquina,
sem tocar na máquina em execução nem nos seus dados.
Numa máquina alojada na DigitalOcean, a mesma chave já está na máquina, em
/root/xuda.config.js e como XUDA_API_KEY, XUDA_HOSTNAME e XUDA_AGENT_KEY em
/etc/profile.d/xuda.sh.
Apontar um agente para a máquina
Há duas formas, e não são equivalentes:
- A partir do seu próprio cliente MCP. Adicione um servidor com o URL do separador Ferramentas e
Authorization: Bearer <key>. A plataforma regista uma ferramenta por cada método da lista de permissões da chave, mais uma ferramenta por cada plugin da máquina, com o nome<plugin>__<method>. - A partir de dentro da Xuda. No Studio, adicione a um agente uma ferramenta do tipo VPS Full Stack e escolha a máquina na lista pendente. Só a identidade da máquina fica guardada no agente; a chave é resolvida no servidor no momento da execução.
Prefira a segunda opção para um agente que vive na Xuda. Cada ação que um agente faz na máquina é escrita no separador Registos da máquina.
Vale a pena conhecer dois comportamentos de segurança: abrir a primeira porta da firewall abre também a porta 22, para que um agente não o possa deixar de fora por engano, e um agente que peça para fechar a porta 22 é recusado de imediato.
Grupos de capacidades
Treze interruptores, que se expandem num conjunto fixo de métodos da plataforma. O cartão Implementação e alojamento
nomeia três métodos SSH sobre WebSocket (vps_enable_ssh, vps_rotate_ssh_token,
vps_disable_ssh) que não são realmente acessíveis com a chave da máquina, por isso esse grupo concede
onze métodos funcionais em vez dos catorze que lista; gira o acesso SSH a partir do separador
Visão geral da máquina. O MCP server não tem métodos próprios, é o interruptor que
publica tudo o resto como ferramentas MCP.
Se a máquina vai ser entregue a um agente autónomo, desligue o que ele não tem de tocar. Contactos, E-mail e Drive são os três que a maioria das pessoas limita primeiro, porque chegam a dados de toda a conta e não a este servidor.
Consentimentos de acesso
Um VPS Full Stack é tratado como a sua máquina, não como a da Xuda, por isso cinco funcionalidades pedem consentimento na primeira vez que cada uma é usada, e as cinco podem ser revistas em Avançado:
Cada concessão e revogação é registada com quem e quando. Revogar uma não afeta as outras.
Tamanhos e preços geridos
Sem restrição por plano de subscrição, sem taxa por capacidade nem por chamada MCP: ativar os treze grupos custa o mesmo que ativar um.
Extras: cópias de segurança automáticas $10/mês mais $0.05/GB guardado, IPv4 dedicado $2.50/mês mais uma taxa de configuração única de $10, Diagnóstico automático $5/mês por servidor, armazenamento em bloco da quinta $0.10/GB/mês (apenas a tarifa, veja VPS para saber porque ainda não pode criar um volume a partir do painel).
O separador Ferramentas di-lo no próprio local: voltar a emitir a chave da máquina com um conjunto de capacidades diferente está para vir, ainda não está ativo. Se precisa de uma superfície diferente hoje, crie uma nova máquina ou suspenda a chave em Chaves de API como paragem imediata.
A seguir
Para os separadores de VPS simples que este produto herda sem alterações, veja Criar e gerir um VPS. Para pôr um domínio na máquina, veja Domínios.