Servidor MCP

O servidor MCP do Panel KVM liga um assistente de IA aos seus VPS. O MCP (Model Context Protocol) é a norma aberta que permite aos assistentes utilizar serviços externos: pede em linguagem corrente a lista dos seus servidores, a carga da semana, um snapshot antes de uma atualização ou a abertura de uma porta, e o assistente faz por si as chamadas ao Panel KVM.

O servidor é alojado pela LWS, no endereço https://panelkvm.lwspanel.com/mcp/v1: não há nada a instalar. Tudo se configura no Panel KVM, na página API / MCP, separador Servidor MCP: aí escolhe o nível de permissões do assistente e os VPS que ele pode gerir, e pode cortar o seu acesso a qualquer momento. Cada uma das suas ações fica registada.

Antes de começar

• A conta principal. A página API / MCP está reservada ao titular da conta: as subcontas não podem ligar um assistente.
• Um assistente compatível com MCP «remoto»: Claude, ChatGPT, Claude Code, Cursor, VS Code, Gemini CLI, Codex CLI, Mistral, n8n ou qualquer ferramenta compatível com Streamable HTTP.
• Mais nada. O MCP funciona de forma independente da API REST: não é necessário ativar a API, criar uma chave de API nem declarar um endereço IP.

Ativar o MCP

1. No Panel KVM, abra a página API / MCP (menu à esquerda) e depois o separador Servidor MCP.
2. Ative o interruptor. Cada ativação e cada desativação são-lhe confirmadas por e-mail.
3. Escolha os servidores geríveis pelo assistente: todos os seus VPS, incluindo os adicionados mais tarde, ou uma seleção. Por predefinição, não gere nenhum.
4. Verifique o nível de permissões: por predefinição, o assistente está em apenas leitura (ver abaixo).

Ligar o seu assistente

Há duas formas de o fazer, consoante o assistente:

• O Claude e o ChatGPT ligam-se por autorização (OAuth): basta o endereço do servidor, não há nenhum token a copiar. Dá o seu consentimento numa página do Panel KVM.
• Os outros (Claude Code, Cursor, VS Code, n8n…) utilizam o token MCP, que gera no separador Servidor MCP e que eles enviam no cabeçalho Authorization: Bearer. O seu valor só é mostrado uma vez: copie-o quando o gerar. O painel mostra também, para cada ferramenta, a configuração pronta a copiar.

Os direitos são os mesmos nos dois casos: o nível de permissões e os servidores geríveis do seu acesso MCP.

Claude (claude.ai, aplicação de computador ou móvel)

1. No Claude, abra Definições › Conectores e adicione um conector personalizado.
2. Nome: LWS Panel KVM. Endereço: https://panelkvm.lwspanel.com/mcp/v1. Mantenha a autenticação proposta por predefinição, sem cabeçalho a introduzir.
3. O Claude abre a página de autorização do Panel KVM: verifique as informações e clique em Autorizar. O conector fica também disponível na aplicação de computador e no telemóvel.

ChatGPT

1. Em chatgpt.com, adicione um servidor MCP personalizado (menu de plugins ou de conectores, consoante a sua versão). A opção depende da sua subscrição e das definições do seu espaço de trabalho.
2. Endereço do servidor: https://panelkvm.lwspanel.com/mcp/v1. Autenticação: OAuth.
3. Clique em Ligar: o ChatGPT abre a página de autorização do Panel KVM, onde clica em Autorizar.

Se não tiver sessão iniciada no Panel KVM, a página de autorização convida-o a passar pela sua área de cliente LWS e a abrir o Panel KVM a partir de um VPS (Gerir): regressa automaticamente à autorização, que se mantém válida durante 10 minutos. A página indica o domínio da aplicação (claude.ai, chatgpt.com…): verifique-o antes de autorizar. Cada nova autorização é-lhe comunicada por e-mail.

Claude Code

Num terminal, substituindo O_SEU_TOKEN pelo valor do token:

claude mcp add --transport http lwskvm https://panelkvm.lwspanel.com/mcp/v1 --header "Authorization: Bearer O_SEU_TOKEN"

Cursor e outros editores

Adicione este servidor ao ficheiro de configuração MCP do editor (para o Cursor: ~/.cursor/mcp.json) e reinicie-o:

{
  "mcpServers": {
    "lwskvm": {
      "url": "https://panelkvm.lwspanel.com/mcp/v1",
      "headers": { "Authorization": "Bearer O_SEU_TOKEN" }
    }
  }
}

O VS Code, o Gemini CLI e o Codex CLI têm cada um o seu próprio formato de ficheiro: o painel mostra o adequado a cada um.

n8n

1. Adicione ao seu agente de IA a ferramenta MCP Client Tool.
2. Endpoint: https://panelkvm.lwspanel.com/mcp/v1. Transport: HTTP Streamable.
3. Authentication: Bearer Auth, com o valor do token.

Escolher o que o assistente pode fazer

O seu acesso MCP tem as suas próprias definições, independentes das da API:

• o nível de permissões, entre três (ver abaixo);
• os servidores geríveis: um VPS fora da lista é invisível para o assistente;
• os endereços IP autorizados, opcionais: deixe a lista vazia para o Claude e o ChatGPT, que se ligam a partir da sua própria infraestrutura.

Comece por apenas leitura e alargue só se for necessário. Qualquer subida de nível é-lhe comunicada por e-mail, e a passagem para o nível Completo tem de ser confirmada por um código enviado por e-mail ao titular da conta. Regressar a um nível inferior não o exige.

As ferramentas de apenas leitura não alteram nada. As de operação agem sem destruir nada: iniciar ou parar um VPS, criar um snapshot ou uma cópia de segurança, gerir as regras da firewall, o DNS reverso, as imagens ISO e as chaves SSH. As ferramentas do nível Completo são irreversíveis ou expõem o servidor: regresso a um snapshot, restauro de uma cópia de segurança, desativação da firewall, modo de resgate, palavra-passe root, reinstalação. Uma ferramenta acima do nível escolhido nem sequer é proposta ao assistente.

Manter o controlo

• Confirmação antes de qualquer ação: o assistente anuncia o que vai fazer e aguarda o seu acordo. Para uma ação destrutiva (reinstalação, palavra-passe root, eliminação de um snapshot…), tem de copiar uma frase exata, por exemplo rebuild 107596.
• Simulação antes de alterar a firewall: regras adicionadas ou retiradas, e um aviso se o acesso SSH correr o risco de ser cortado, sem aplicar nada.
• Histórico de chamadas: as 50 últimas chamadas dos 30 últimos dias (hora, ferramenta, origem, VPS, resultado, endereço IP), com filtros por ações e erros. As ações aparecem também no registo de atividade da sua conta.
• Aplicações ligadas: cada assistente autorizado por OAuth figura aí com o seu domínio e a sua última utilização. Revogar retira-lhe o acesso de imediato.
• A qualquer momento, pode regenerar o token (as ferramentas que o utilizam são desligadas) ou cortar o acesso MCP com um interruptor.

Bom saber

• Um assistente pode enganar-se: reveja o que ele propõe antes de uma reinstalação, de um restauro ou de uma alteração da firewall.
• O número de chamadas é limitado por hora: 600 leituras e 60 ações por conta, e 3 ações pesadas (reinstalação, restauro, regresso a um snapshot, modo de resgate) por VPS, até um máximo de 20 para a conta. Acima disso, o assistente é informado do tempo de espera. O estado e as métricas de um VPS são atualizados, no máximo, a cada 15 segundos.
• Os textos que introduziu no painel (comentários, descrições…) são assinalados ao assistente como dados, nunca como instruções.
• Uma autorização OAuth renova-se sozinha; após 30 dias sem utilização, o assistente pede-lhe que a autorize novamente.
• O que o MCP devolve ao assistente (lista de VPS, métricas…) é transmitido ao respetivo fornecedor, que o trata segundo as suas próprias condições. O histórico, por sua vez, nunca guarda o conteúdo dos seus pedidos.
• A LWS nunca lhe pedirá o seu token MCP.