Com o ZapX MCP Connector, você gerencia seus servidores na ZAP-Hosting direto no chat com o Claude, o ChatGPT, o Cursor ou outro assistente de IA. Neste guia, mostramos passo a passo como conectar seu cliente e definir o que ele pode fazer.
Uma conta ZapX com ZapX Pass Plus, Pro ou Max ativo e um cliente de IA com suporte a MCP: Claude, Claude Code, ChatGPT, Cursor, Gemini CLI, VS Code ou Windsurf.
O endereço do servidor é sempre https://zap-hosting.com/api/mcp. Você também o encontra no painel ZapX em Settings → API Access → MCP Connect.
- No Claude, abra Settings → Connectors.
- Clique em Add custom connector.
- Digite um nome, como “ZapX”, e informe
https://zap-hosting.com/api/mcpcomo URL. - Clique em Connect. A página de login da ZapX será aberta.
- Faça login, escolha na página de autorização o que o Claude pode fazer e clique em Autorizar.
- Ative o conector em um chat e pergunte, por exemplo: “Quais serviços tenho na ZAP?”
A possibilidade de criar seus próprios conectores depende do seu plano do Claude.
- Abra Settings → Apps & Connectors → Advanced settings e ative o Developer mode. A disponibilidade depende do seu plano do ChatGPT ou das políticas do workspace.
- Acesse Apps & Connectors → Create.
- Informe o nome e a descrição, use
https://zap-hosting.com/api/mcpcomo URL e escolha OAuth como método de autenticação. - Faça login na ZapX e autorize as permissões desejadas.
- Ative o conector em um chat por meio de + → Developer mode.
O ChatGPT muda o nome desses menus de vez em quando. Se não encontrar uma opção, procure por “Connectors” ou “Developer mode” nas configurações.
Execute estes dois comandos no terminal:
claude mcp add --transport http zapx-services https://zap-hosting.com/api/mcp
claude mcp list
Na primeira execução, o Claude Code abre o navegador para você fazer login na ZapX.
- Abra Settings → Tools & Integrations → MCP tools e adicione o servidor ou inclua-o no arquivo de configuração.
- Reinicie o Cursor e conclua o login na ZapX.
Para o arquivo de configuração, use ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto):
{
"mcpServers": {
"zapx-services": { "url": "https://zap-hosting.com/api/mcp" }
}
}
Na página do MCP, há também um botão que adiciona o servidor diretamente ao Cursor.
Esses clientes são configurados por meio de um arquivo de configuração:
| Cliente | Onde adicionar | Configuração |
|---|---|---|
| Gemini CLI | ~/.gemini/settings.json | "mcpServers": { "zapx-services": { "httpUrl": "https://zap-hosting.com/api/mcp" } }, depois /mcp list |
| VS Code (a partir da versão 1.101) | “MCP: Open User Configuration” ou .vscode/mcp.json | "servers": { "zapx-services": { "type": "http", "url": "https://zap-hosting.com/api/mcp" } }, login no modo Copilot Agent |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | "mcpServers": { "zapx-services": { "serverUrl": "https://zap-hosting.com/api/mcp" } }, depois atualize a lista |
Durante o login, você decide o que seu cliente de IA pode acessar. Por padrão, o acesso é somente para leitura. Outras áreas você libera de forma específica:
| Área | Exemplo |
|---|---|
| Consultar serviços | Lista dos seus servidores, status e detalhes |
| Ler configurações | Consultar configurações e arquivos |
| Iniciar, parar e reiniciar | Reiniciar o servidor |
| Console e logs | Ler linhas de log e enviar comandos ao console |
| Alterar configurações | Editar valores de configuração e arquivos |
| Gerenciamento do TeamSpeak | Tokens e banimentos |
| Gerenciamento de domínios | Registros DNS |
| Alterações de pacotes | Preparar upgrades e downgrades |
| Consultar pedidos | Status dos pedidos |
Você pode alterar as permissões depois em Settings → API Access → Connected Apps, onde também pode desconectar o aplicativo por completo. Se o cliente não tiver permissão para uma ação, a ZapX informa qual área você precisa liberar.
O ZapX MCP oferece mais de 160 ferramentas para servidores de jogos, VPS, servidores dedicados, TeamSpeak, bots do Discord e domínios. Alguns exemplos:
- “Mostre o status em tempo real dos meus servidores.”
- “O que aparece nas últimas linhas do console do meu servidor de Minecraft?”
- “Crie um backup e depois reinicie o servidor.”
- “Defina
max-playerscomo 40 emserver.properties.” - “Quanto tráfego meu VPS consumiu este mês?”
- “Adicione um registro A para
playao meu domínio.” - “Quanto custaria fazer upgrade do meu VPS para 8 GB de RAM?”
- O ZapX MCP só executa ações que alteram algo com sua confirmação explícita.
- As alterações de pacotes acontecem em duas etapas: primeiro, você recebe uma prévia do preço; depois, confirma explicitamente. No ChatGPT, as alterações de pacotes não estão disponíveis.
- A IA não pode contratar novos serviços. Para isso, você continua usando a loja.
- O login é feito por OAuth. Você nunca passa sua senha para o cliente de IA e pode desconectar o aplicativo a qualquer momento.
Preciso de um ZapX Pass?
Sim, o MCP Connect está incluído a partir do ZapX Pass Plus. Se o seu Pass expirar, a conexão continua existindo, mas só volta a funcionar quando houver um Pass ativo.
Também funciona sem OAuth, com uma chave de API?
Sim. Em Settings → API Access, você cria uma chave de API e a envia como Bearer Token. A chave só é exibida uma vez, e você define as permissões dela ao criá-la.
Meu cliente mostra “cliente não verificado”. Isso é normal?
Sim. A ZapX identifica como não verificados os clientes que se registram automaticamente. Antes de autorizar, confira se o nome corresponde ao seu cliente.
Qual cliente é o certo para mim?
Para gerenciar seus servidores pelo navegador ou pelo celular, o Claude e o ChatGPT são os mais práticos. Se você já trabalha em um editor ou no terminal, Cursor, Claude Code, VS Code, Windsurf ou Gemini CLI combinam melhor.
A configuração leva só alguns minutos: você adiciona o endereço, faz login com sua conta ZapX e define as permissões. O ideal é começar só com acesso de leitura e liberar controle, console ou configurações apenas quando realmente precisar. Todos os detalhes sobre o endpoint estão na página do MCP, e explicamos o que está por trás do MCP em O que é um servidor MCP?.
Fonte preferida no Google
