blog
Painéis

Conectar o Claude Desktop ao cPanel via MCP sem dar acesso demais

Guia documental baseado na documentação oficial do cPanel, com Claude Desktop como cliente de exemplo, checklist reutilizável para agência e a frase pronta para explicar o acesso ao cliente.

JR · · 7 min de leitura · 2 tabelas · 1 bloco de código

Resposta curta: ligar um assistente de IA ao cPanel segue cinco passos: gerar token de API só de leitura, configurar o cliente MCP com host, usuário e token, validar uma consulta real contra o painel aberto em paralelo, ampliar para escrita só se a tarefa exigir e revogar o token ao fim. O cPanel documenta essa conexão.

Neste artigo
  1. Leitura primeiro, escrita depois, revogação sempre
  2. O que você precisa ter em mãos antes de gerar o token
  3. Os cinco passos da conexão documentada
  4. Cinco erros de configuração e o que cada um provoca
  5. Checklist de token para rodar igual em todo cliente
  6. A frase que autoriza o acesso antes de configurar qualquer coisa
  7. Três casos em que o MCP só adiciona risco

Ligar um assistente de IA ao cPanel deixou de ser gambiarra com scraping de tela. O cPanel documenta um servidor MCP (Model Context Protocol), o protocolo que Claude, ChatGPT e outros clientes usam para conversar com ferramentas externas, e a conexão é autenticada por um token de API gerado dentro da própria conta cPanel. A documentação oficial do procedimento está em Connect to MCP.

O que muda para quem mantém sites de cliente é o modelo de risco. Antes, a IA só sabia o que você colava no chat. Agora ela fala com o painel. Um token mal escopado transforma um pedido ambíguo ("limpa os e-mails antigos daquele domínio") em ação real, na conta real, sem confirmação intermediária. Por isso este guia é organizado em torno de uma regra única: leitura primeiro, escrita depois, revogação sempre.

Leitura primeiro, escrita depois, revogação sempre

Aplique nesta ordem, sem pular etapa, em qualquer conta de cliente:

  1. Gere o token com o menor escopo possível, idealmente só leitura.
  2. Valide uma consulta real que você já sabe responder de cabeça: lista de domínios, uso de disco, contas de e-mail. Se a resposta da IA bater com o painel, a conexão está correta e apontando para a conta certa.
  3. Só então amplie para escrita, e amplie para a tarefa específica, não para tudo.
  4. Revogue o token ao fim do teste ou do trabalho. Token esquecido ativo é credencial permanente de um sistema que não é seu.

O passo 2 existe porque é o único momento barato de descobrir que você conectou a conta errada. Em agência com dezenas de contas cPanel, errar o host na configuração do cliente MCP é o erro mais fácil de cometer e o mais caro de perceber tarde.

Leitura primeiro, escrita depois, revogação sempreToken mínimoSó leitura, nome com dataValidarComparar resposta com painelAmpliarSegundo token, só a tarefaRevogarAo fim do trabalho
Ordem fixa para qualquer conta de cliente: a validação acontece antes de qualquer permissão de escrita.

O que você precisa ter em mãos antes de gerar o token

Item Por quê
Acesso cPanel da conta do cliente O token desta conexão é o da conta cPanel; o WHM emite tokens próprios, de escopo de servidor, que não devem ser usados aqui
Recurso de token de API disponível no painel Pode estar oculto pelo plano ou pela política do provedor
Cliente MCP instalado (Claude Desktop, por exemplo) É quem lê o arquivo de configuração e abre a conexão
Hostname correto do servidor Confundir srvXX.exemplo.com com o domínio do site é o erro clássico
Autorização por escrito do cliente Você vai dar acesso programático à conta dele a um serviço de terceiro

O último item não é burocracia. Se a IA roda em nuvem, os dados consultados (nomes de domínio, endereços de e-mail, uso de recursos) saem do servidor. Trate como qualquer outro subprocessador.

Os cinco passos da conexão documentada

Gerar o token com o menor escopo que a tarefa aceita

A fonte autorizada desta conexão é a página Connect to MCP, e ela trata do token de API da conta cPanel. A localização exata do gerenciador de tokens (na prática, na área de segurança do painel) não está fixada ali: confira na tela da sua versão. Crie um token com nome que identifique uso e data, por exemplo mcp-leitura-2026-10. Nome genérico (token1) é o que faz você não revogar depois, porque não lembra para que servia.

Na criação, o cPanel permite restringir as permissões do token em vez de conceder acesso total. Marque apenas o que a tarefa exige. A lista exata de permissões disponíveis varia conforme a versão do cPanel instalada, então leia a tela, não a memória de outra instalação.

Resultado esperado: a string do token aparece na tela de criação. Copie na hora, porque o gerenciador costuma não reexibi-la depois. Esse comportamento não está descrito na página Connect to MCP: confira na tela da sua versão antes de fechar a janela. Se perder, gere outro token e revogue o anterior.

Apontar o cliente MCP para o servidor certo

O cliente MCP precisa saber o endereço do servidor, o usuário cPanel e o token. A documentação oficial do cPanel descreve o formato aceito e os campos exigidos; siga-a, porque o formato muda entre versões do cliente.

O bloco abaixo é exemplo fictício de como um cliente MCP costuma estruturar o arquivo de configuração, apenas para você reconhecer o formato:

{
  "mcpServers": {
    "cpanel-cliente-exemplo": {
      "url": "https://servidor.exemplo.com:2083/mcp",
      "headers": {
        "Authorization": "cpanel usuario:TOKEN_AQUI"
      }
    }
  }
}

Valores, caminho e nome de campo devem vir da página Connect to MCP, não deste exemplo.

Sobre outros clientes: a página Connect to MCP descreve a configuração via Claude Desktop. Não há, nela, instrução para conectar o ChatGPT. Se o seu cliente de IA aceitar servidor MCP remoto com cabeçalho de autenticação, os três dados que ele precisa são os mesmos (host do servidor, usuário cPanel e token), mas o formato do arquivo e o suporte a MCP remoto são do cliente, não do cPanel: confira na documentação dele antes de prometer a integração ao cliente final.

Resultado esperado: ao reiniciar o cliente, o servidor aparece na lista de ferramentas conectadas. Se não aparece, o problema é de configuração ou de rede, não de permissão.

Comparar a resposta da IA com o painel aberto ao lado

Peça algo verificável. Três pedidos bons:

Abra o cPanel em outra aba e compare. Se bater, a conexão está íntegra e na conta certa. Se a IA responder com dados de outro cliente, pare tudo e confira o hostname e o usuário no arquivo de configuração.

Quando ampliar para escrita e por que usar um segundo token

Só depois da validação. Gere um segundo token, com as permissões de escrita que a tarefa exige, e deixe o token de leitura intacto para diagnóstico. Dois tokens separados permitem revogar o de escrita assim que a tarefa acaba, sem perder a conexão de consulta.

Revogar o token pelo nome e fechar o ciclo

A revogação fica no mesmo gerenciador de tokens da conta cPanel. A página Connect to MCP cobre a conexão, não o ciclo de vida do token, então esse passo é conferir na tela da sua versão. Revogue pelo nome. Se você nomeou com data, a limpeza trimestral leva dois minutos.

Cinco erros de configuração e o que cada um provoca

Erro Sintoma Correção
Token com acesso total "só para testar" Funciona de primeira, e fica assim para sempre Recriar restrito e revogar o antigo
Hostname do site no lugar do hostname do servidor Falha de conexão ou certificado Usar o host do servidor informado pelo provedor
Dois clientes com nomes iguais no config A IA age na conta errada Nomear por cliente: cpanel-acme, cpanel-beta
Token colado em prompt ou em repositório Credencial vazada Revogar imediatamente e gerar outra
Token sem data no nome Ninguém revoga Padrão de nomenclatura obrigatório na agência

Um detalhe operacional: assistente de IA erra de forma plausível. Ele vai afirmar com confiança que apagou algo que não apagou, ou que o domínio existe quando não existe. Por isso a validação cruzada com o painel não é paranoia, é parte do procedimento.

Checklist de token para rodar igual em todo cliente

Cole isto no runbook interno e rode igual em todo cliente:

O penúltimo item é o que separa agência organizada de passivo acumulado. Tokens não expiram sozinhos por boa vontade.

A frase que autoriza o acesso antes de configurar qualquer coisa

Use uma frase só, antes de qualquer configuração:

Se depois você precisar de escrita, avise de novo e diga exatamente qual tarefa: "vou liberar permissão de criar subdomínio nesta semana, e revogo na sexta". Cliente aceita acesso temporário com prazo. O que ele não aceita é descobrir meses depois que uma IA tinha chave da casa.

Quando usar MCP e quando não usarTarefa de clique único?Faça no painel, sem MCPDados sensíveis de terceiros?Processo manual até ter contratoDá para conferir o resultado?Sem painel ou log, não delegueInventário ou diagnóstico repetitivoAqui o MCP compensa
Filtro antes de conectar: o ganho real está em leitura em escala com conferência por amostra.

Três casos em que o MCP só adiciona risco

Três situações em que o MCP só adiciona superfície de risco:

O ganho real aparece em inventário e diagnóstico repetitivo: levantar quais contas estão perto do limite de disco, quais domínios têm certificado perto de vencer, quantas caixas de e-mail existem em cada cliente. Leitura, em escala, com você conferindo a amostra. É aí que vale.

Referências

  1. Documentação oficial (cpanel) — Connect to MCP. Consultado em 2026-10-07.
Leia também