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

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

João Rizzon · 2026-10-13 · Painéis

---

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](https://docs.cpanel.net/cpanel/meridian/getting-started/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](https://docs.cpanel.net/cpanel/meridian/getting-started/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:

```json
{
  "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](https://docs.cpanel.net/cpanel/meridian/getting-started/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:

> **** "Vou conectar uma ferramenta de IA ao painel da sua hospedagem com uma credencial limitada, criada por mim, que só permite consultar informações como domínios, uso de disco e contas de e-mail. Ela não acessa o conteúdo dos seus e-mails nem altera nada sem que eu amplie essa permissão de propósito, e eu revogo a credencial assim que o trabalho terminar."

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.

