Vimonto Deploy ha un server MCP integrato, così assistenti AI come Claude Code, Claude Desktop, Cursor e VS Code possono lavorare con le tue organizzazioni: elencare server e siti, fare il deploy di un sito e seguirlo, leggere l'output di un'attività fallita, creare un database ed eseguire backup e ricette. MCP, il Model Context Protocol, è lo standard aperto che questi assistenti usano per chiamare strumenti in altre applicazioni.
Il server MCP è l'API in un'altra forma. Accede con un token API personale e l'assistente può fare esattamente ciò che consentono quel token e il tuo ruolo, sui server a cui hai accesso. Tramite MCP non si può eliminare nulla.
Come colleghi un assistente?
- Apri il menu dell'account in alto a destra e scegli Impostazioni account → Token API.
- Clicca su Nuovo token, dagli un Nome come "Claude Code" e scegli i suoi Ambiti (vedi ambiti). Per un assistente che deve solo dare un'occhiata, Lettura basta.
- Clicca su Crea token.
- La finestra Il tuo nuovo token mostra il token e, sotto Collega un assistente AI, un Prompt con il tuo token e il tuo indirizzo già inseriti. Clicca su Copia e incollalo in Claude Code, Cursor, VS Code o Claude Desktop: l'assistente aggiunge il collegamento alla propria configurazione, mantiene i server che hai già, ti dice se devi riavviarlo e verifica che la connessione funzioni.
Preferisci configurarlo tu? Le schede Claude Code, Claude Desktop, Cursor e VS Code accanto a Prompt mostrano il comando o la configurazione per ciascuno, anch'essi con il tuo token e il tuo indirizzo già inseriti, come descritto qui sotto.
Il token viene mostrato una sola volta. Quando chiudi la finestra, sparisce anche la configurazione con il token; crea un nuovo token se ti serve di nuovo. La sezione Assistenti AI nella stessa pagina mostra in ogni momento l'indirizzo del server MCP.
L'indirizzo del server è /mcp sull'indirizzo da cui usi Vimonto Deploy, come https://deploy.example.com/mcp. Usa il transport Streamable HTTP e si aspetta il token come bearer token nell'header Authorization. Negli esempi qui sotto sostituisci deploy.example.com con il tuo indirizzo e YOUR_TOKEN con il token.
Claude Code
Esegui questo nel terminale:
claude mcp add --transport http vimonto-deploy https://deploy.example.com/mcp \
--header "Authorization: Bearer YOUR_TOKEN"
Aggiungi --scope user per usarlo in ogni progetto, non solo in quello attuale. Verificalo con claude mcp list, oppure con /mcp dentro Claude Code.
Cursor
Aggiungi questo a ~/.cursor/mcp.json (tutti i progetti) o a .cursor/mcp.json in un progetto:
{
"mcpServers": {
"vimonto-deploy": {
"url": "https://deploy.example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
VS Code
Aggiungi questo a .vscode/mcp.json in un progetto, oppure esegui MCP: Open User Configuration dalla palette dei comandi per tutti i progetti:
{
"servers": {
"vimonto-deploy": {
"type": "http",
"url": "https://deploy.example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
Claude Desktop e altri assistenti che avviano solo server locali
Il file di configurazione di Claude Desktop avvia solo server MCP locali. mcp-remote collega un assistente di questo tipo a un server remoto; richiede Node.js. Apri Settings → Developer → Edit Config in Claude Desktop, aggiungi questo a claude_desktop_config.json e riavvia Claude:
{
"mcpServers": {
"vimonto-deploy": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://deploy.example.com/mcp", "--header", "Authorization:${AUTH_HEADER}"],
"env": {
"AUTH_HEADER": "Bearer YOUR_TOKEN"
}
}
}
}
Il token è in env e non in args perché alcuni sistemi dividono gli argomenti sugli spazi. La stessa configurazione funziona in qualsiasi assistente che sa solo avviare un comando.
Cosa può fare l'assistente?
Gli ambiti del token decidono quali strumenti l'assistente vede. Uno strumento per cui il token non ha l'ambito non compare nell'elenco e non può essere chiamato.
| Ambito | Strumenti |
|---|---|
| Lettura | Tutto ciò che legge: organizzazioni, server, siti, deployment, attività, database, backup e ricette. |
| Deploy | list_organizations, list_sites (un sito, per dominio o ID), list_deployments, get_deployment, deploy_site e get_task. |
| Scrittura | Tutto ciò che consente Lettura, più deploy_site, create_database, run_backup e run_recipe. |
Sopra a questo viene controllato il tuo ruolo, esattamente come nell'app e nell'API: per il deploy serve un ruolo che può gestire i siti, per creare un database uno che può gestire i server, e così via. Il token di un osservatore può leggere, ma ogni modifica viene rifiutata. Con l'accesso per team, i server al di fuori dei tuoi team e i loro siti non esistono per l'assistente.
Gli strumenti
| Strumento | Ambiti | Cosa fa |
|---|---|---|
list_organizations |
qualsiasi | A chi appartiene il token, i suoi ambiti e le tue organizzazioni con il tuo ruolo in ciascuna. |
list_servers |
lettura, scrittura | I server dell'organizzazione a cui hai accesso. |
get_server |
lettura, scrittura | Un server: tipo, stato, provider, indirizzi IP, versione di PHP, database. |
list_sites |
lettura, deploy, scrittura | I siti sui tuoi server, filtrati per dominio, ID del sito o server. Con il solo ambito Deploy sono richiesti un dominio o un ID del sito. |
get_site |
lettura, scrittura | Un sito, per ID o dominio. |
list_deployments |
lettura, deploy, scrittura | I deployment di un sito, dal più recente, 25 per pagina. |
get_deployment |
lettura, deploy, scrittura | Un deployment con il suo commit e la sua attività. |
deploy_site |
deploy, scrittura | Fa il deploy del branch del sito, come Fai il deploy. |
get_task |
lettura, deploy, scrittura | Stato, passaggio, avanzamento ed errore di un'attività e le ultime righe del suo output. |
list_databases |
lettura, scrittura | I database di un server. |
create_database |
scrittura | Crea un database vuoto su un server. |
list_backups |
lettura, scrittura | Le configurazioni di backup di un server con gli ultimi backup. |
run_backup |
scrittura | Esegue subito una configurazione di backup. |
list_recipes |
lettura, scrittura | Le ricette dell'organizzazione con i loro script. |
run_recipe |
scrittura | Esegue una ricetta su uno o più server. |
Ogni strumento accetta un'organization (il suo slug); l'assistente può ometterla quando appartieni a una sola organizzazione. I siti possono essere indicati con il loro dominio, quindi puoi semplicemente chiedere: "Fai il deploy di shop.example.com e dimmi quando è online."
Deploy, database, backup e ricette girano come attività in background. Lo strumento risponde subito con un ID attività e l'assistente segue l'attività con get_task finché non è riuscita o fallita. Quando un deploy fallisce, legge l'errore e la fine dell'output, che di solito basta per dirti perché.
Cosa non è possibile
Non ci sono strumenti che eliminano qualcosa: niente rimozione di database, siti o server. Non sono disponibili nemmeno la creazione di server e siti, la modifica dei file di ambiente e la gestione dei domini; per questi usa l'app.
È sicuro?
- Solo token. Essere connesso all'app nel browser non apre il server MCP; ogni richiesta richiede un token API valido e non scaduto. Revocare il token in Token API scollega subito l'assistente.
- Mai più di te. L'assistente agisce come te, limitato agli ambiti del token, al tuo ruolo attuale e al tuo accesso ai server. Quando il tuo ruolo cambia, cambia anche ciò che l'assistente può raggiungere.
- Nessun segreto. Password, chiavi SSH, file
.env, URL di deploy e token non fanno mai parte di una risposta. L'output delle attività e gli script dele ricette vengono mostrati così come sono nell'app, quindi non stampare segreti negli script di deploy. - Tutto viene registrato. Le modifiche fatte da un assistente compaiono nel registro di audit a tuo nome, con il nome del token ("Token API Claude Code").
- Con limite di richieste. Ogni token può fare 120 richieste al minuto, condivise con l'API.
- Il tuo assistente chiede prima. Gli strumenti che cambiano qualcosa sono contrassegnati come tali, così gli assistenti chiedono la tua approvazione prima di fare un deploy o eseguire una ricetta. Deploy ed esecuzione dele ricette sono contrassegnati come distruttivi, perché cambiano ciò che gira sui tuoi server.
Domande frequenti
Quali assistenti funzionano?
Ogni assistente che supporta server MCP remoti via Streamable HTTP con un header personalizzato, come Claude Code, Cursor e VS Code. Gli assistenti che avviano solo server locali, come Claude Desktop tramite il suo file di configurazione, si collegano con mcp-remote.
Perché l'assistente dice che un server o un sito non esiste?
Non esiste in quell'organizzazione, oppure non hai accesso: il tuo accesso per team nasconde i server al di fuori dei tuoi team. Controlla anche che l'assistente usi l'organizzazione giusta; list_organizations le elenca.
Perché l'assistente non vede uno strumento?
Il token non ha l'ambito necessario. Un token Lettura, per esempio, non può fare deploy. Crea un nuovo token con l'ambito che ti serve e sostituisci il token nella configurazione dell'assistente.
Posso usare lo stesso token per l'API, la CLI e un assistente?
Sì, ma token separati sono più sicuri: puoi revocarne uno senza rompere gli altri, e il registro di audit mostra quale ha fatto una modifica.