Saltar para o conteúdo
Rascunho

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.

Não é o tipo de implementação MCP Server

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.

O conjunto de ferramentas na máquina precisa da DigitalOcean

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).

Alterar capacidades depois de criar não está disponível

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.