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.

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
- Leitura primeiro, escrita depois, revogação sempre
- O que você precisa ter em mãos antes de gerar o token
- Os cinco passos da conexão documentada
- Cinco erros de configuração e o que cada um provoca
- Checklist de token para rodar igual em todo cliente
- A frase que autoriza o acesso antes de configurar qualquer coisa
- 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:
- Gere o token com o menor escopo possível, idealmente só leitura.
- 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.
- Só então amplie para escrita, e amplie para a tarefa específica, não para tudo.
- 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.
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:
- "Liste os domínios e subdomínios desta conta."
- "Qual o uso de disco atual e o limite?"
- "Quantas contas de e-mail existem e em quais domínios?"
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:
- [ ] Autorização do cliente registrada por escrito
- [ ] Token criado com nome
mcp-<escopo>-<AAAA-MM> - [ ] Permissões restritas ao mínimo, conferidas na tela
- [ ] Entrada no config nomeada com o cliente, não com "cpanel"
- [ ] Consulta de leitura validada contra o painel aberto em paralelo
- [ ] Token de escrita separado, criado só quando a tarefa exigir
- [ ] Token de escrita revogado ao fim da tarefa
- [ ] Revisão trimestral: listar tokens ativos em cada conta e revogar os sem dono
- [ ] Registro de qual IA teve acesso a qual conta e em que período
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.
Três casos em que o MCP só adiciona risco
Três situações em que o MCP só adiciona superfície de risco:
- Tarefa de clique único. Criar uma conta de e-mail no painel leva menos tempo do que descrever o pedido.
- Conta com dados sensíveis de terceiros. Jurídico, saúde, qualquer base com dado pessoal: resolva por processo manual até ter contrato de tratamento de dados que cubra o fornecedor da IA.
- Você não tem como conferir o resultado. Se não existe painel aberto na outra aba nem log para comparar, você está delegando sem verificação.
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
- Documentação oficial (cpanel) — Connect to MCP. Consultado em 2026-10-07.