Con il connettore ZapX MCP gestisci i tuoi server su ZAP-Hosting direttamente in chat con Claude, ChatGPT, Cursor o un altro assistente AI. In questa guida ti mostriamo passo dopo passo come collegare il tuo client e decidere cosa può fare.
Un account ZapX con ZapX Pass Plus, Pro o Max attivo e un client AI compatibile con MCP: Claude, Claude Code, ChatGPT, Cursor, Gemini CLI, VS Code o Windsurf.
L’indirizzo del server è sempre https://zap-hosting.com/api/mcp. Lo trovi anche nel pannello ZapX, in Impostazioni → Accesso API → MCP Connect.
- In Claude, apri Settings → Connectors.
- Clicca su Add custom connector.
- Inserisci un nome, per esempio «ZapX», e come URL
https://zap-hosting.com/api/mcp. - Clicca su Connect. Si apre la pagina di accesso a ZapX.
- Accedi, scegli nella pagina di autorizzazione cosa può fare Claude e clicca su Autorizza.
- Attiva il connettore in una chat e chiedi, per esempio: «Quali servizi ho su ZAP?»
La possibilità di creare connettori personalizzati dipende dal tuo piano Claude.
- Apri Settings → Apps & Connectors → Advanced settings e attiva la Developer mode. La funzione è disponibile a seconda del tuo piano ChatGPT o delle regole del workspace.
- Vai su Apps & Connectors → Create.
- Inserisci nome e descrizione, imposta l’URL
https://zap-hosting.com/api/mcpe scegli OAuth come metodo di autenticazione. - Accedi a ZapX e autorizza i permessi che vuoi concedere.
- Attiva il connettore in una chat da + → Developer mode.
ChatGPT cambia di tanto in tanto il nome di questi menu. Se non trovi una voce, cerca «Connectors» o «Developer mode» nelle impostazioni.
Esegui questi due comandi nel terminale:
claude mcp add --transport http zapx-services https://zap-hosting.com/api/mcp
claude mcp list
Al primo avvio, Claude Code apre il browser per farti accedere a ZapX.
- Apri Settings → Tools & Integrations → MCP tools e aggiungi il server, oppure inseriscilo nel file di configurazione.
- Riavvia Cursor e completa l’accesso a ZapX.
Come file di configurazione usa ~/.cursor/mcp.json (globale) o .cursor/mcp.json (progetto):
{
"mcpServers": {
"zapx-services": { "url": "https://zap-hosting.com/api/mcp" }
}
}
Nella pagina MCP trovi anche un pulsante che aggiunge il server direttamente a Cursor.
Questi client si configurano tramite un file di configurazione:
| Client | Dove inserirlo | Configurazione |
|---|---|---|
| Gemini CLI | ~/.gemini/settings.json | "mcpServers": { "zapx-services": { "httpUrl": "https://zap-hosting.com/api/mcp" } }, poi /mcp list |
| VS Code (dalla versione 1.101) | «MCP: Open User Configuration» o .vscode/mcp.json | "servers": { "zapx-services": { "type": "http", "url": "https://zap-hosting.com/api/mcp" } }, accedi in modalità agente Copilot |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | "mcpServers": { "zapx-services": { "serverUrl": "https://zap-hosting.com/api/mcp" } }, poi aggiorna |
Quando accedi, decidi a cosa può accedere il tuo client AI. Per impostazione predefinita è abilitata solo la lettura. Gli altri ambiti li autorizzi in modo mirato:
| Ambito | Esempio |
|---|---|
| Visualizzazione dei servizi | Elenco dei tuoi server, stato e dettagli |
| Lettura della configurazione | Visualizzazione di configurazioni e file |
| Avvio, arresto e riavvio | Riavvio del server |
| Console e log | Lettura delle righe di log e invio di comandi alla console |
| Modifica della configurazione | Modifica dei valori di configurazione e dei file |
| Gestione di TeamSpeak | Token e ban |
| Gestione dei domini | Record DNS |
| Modifiche ai pacchetti | Preparazione di upgrade e downgrade |
| Visualizzazione degli ordini | Stato degli ordini |
In seguito puoi modificare i permessi da Impostazioni → Accesso API → App collegate, dove puoi anche interrompere del tutto la connessione. Se al client manca un permesso per un’azione, ZapX ti indica quale ambito devi abilitare.
ZapX MCP mette a disposizione oltre 160 strumenti per server di gioco, VPS, server dedicati, TeamSpeak, bot Discord e domini. Ecco alcuni esempi:
- «Mostrami lo stato in tempo reale dei miei server.»
- «Cosa dicono le ultime righe della console del mio server Minecraft?»
- «Crea un backup e poi riavvia il server.»
- «Imposta
max-playersa 40 inserver.properties.» - «Quanto traffico ha consumato il mio VPS questo mese?»
- «Crea un record A per
playnel mio dominio.» - «Quanto costerebbe portare il mio VPS a 8 GB di RAM?»
- ZapX MCP esegue le azioni che modificano qualcosa solo con una tua conferma esplicita.
- Le modifiche ai pacchetti avvengono in due passaggi: prima ricevi un’anteprima del prezzo, poi confermi esplicitamente. In ChatGPT le modifiche ai pacchetti non sono disponibili.
- L’AI non può ordinare nuovi servizi. Per questo continui a usare lo shop.
- L’accesso avviene tramite OAuth. Non fornisci mai la tua password al client AI e puoi interrompere la connessione in qualsiasi momento.
Mi serve uno ZapX Pass?
Sì, MCP Connect è incluso a partire da ZapX Pass Plus. Se il Pass scade, la connessione resta, ma torna a funzionare solo quando hai di nuovo un Pass attivo.
Funziona anche senza OAuth, con una chiave API?
Sì. In Impostazioni → Accesso API crei una chiave API e la invii come Bearer token. La chiave viene mostrata una sola volta e i suoi permessi li scegli al momento della creazione.
Il mio client indica «client non verificato». È normale?
Sì. ZapX mostra come non verificati i client che si registrano automaticamente. Prima di autorizzare, controlla che il nome corrisponda al tuo client.
Qual è il client giusto per me?
Per gestire i server dal browser o dallo smartphone, Claude e ChatGPT sono i più comodi. Se lavori già in un editor o nel terminale, ti conviene di più Cursor, Claude Code, VS Code, Windsurf o Gemini CLI.
La configurazione richiede solo pochi minuti: inserisci l’indirizzo, accedi con il tuo account ZapX e scegli i permessi. L’ideale è partire con la sola lettura e attivare controllo, console o configurazioni solo quando ti servono davvero. Tutti i dettagli sull’endpoint li trovi nella pagina MCP, mentre cosa c’è dietro MCP te lo spieghiamo in Cos’è un server MCP?.
Fonte preferita su Google
