Coolify MCP
Server MCP di Stuart Mason
Distribuisci, diagnostica e gestisci un PaaS Coolify self-hosted dal tuo assistente AI, con conferma umana per le azioni distruttive.
Installa Coolify MCP
Gira sul tuo computer. Il tuo client lo avvia con questo comando:
Richiede Node.js sul tuo computer. I passaggi qui sotto mostrano dove va il comando in ogni client.
COOLIFY_ACCESS_TOKENsegreto Your Coolify API access tokenCOOLIFY_BASE_URLfacoltativo Your Coolify instance URL
Condividi questo server
Apre questa pagina, con il comando di installazione e i passaggi di configurazione.
mcp.tc/i/coolifyDescrizione
Si connette a un’istanza Coolify v4 e permette a un assistente di distribuire applicazioni, leggere i log dei container, diagnosticare app e server, gestire database, servizi, progetti, variabili d’ambiente, backup e attività pianificate, e cercare nella documentazione di Coolify. Le operazioni distruttive chiedono prima conferma all’utente e i segreti sono mascherati nelle risposte.
Si esegue in locale tramite stdio con npx @masonator/coolify-mcp, oppure come bundle MCPB con un clic per Claude Desktop. Può anche essere distribuito come container accanto a Coolify per l’uso remoto. Richiede un token API di Coolify in COOLIFY_ACCESS_TOKEN e, facoltativamente, l’URL dell’istanza in COOLIFY_BASE_URL.
Cosa puoi fare
- Diagnosticare app e server per nome, dominio, IP o UUID
- Analizzare l’intera infrastruttura alla ricerca di problemi e leggere i log dei container
- Distribuire applicazioni ed eseguire il rollback, attendendo uno stato finale
- Avviare, arrestare e riavviare le risorse
- Creare e gestire applicazioni, database, servizi e progetti
- Gestire variabili d’ambiente, storage, backup e attività pianificate con segreti mascherati
- Eseguire operazioni in blocco dopo conferma umana
- Cercare nella documentazione di Coolify
Tool
I server locali mostrano i loro tool solo quando sono in esecuzione, quindi non possiamo mostrarli qui. Cerca l’elenco nella sua documentazione; il tuo client li mostra dopo che lo hai aggiunto.
Prompt di esempio
Perché la mia app su example.com non funziona? Diagnostica il problema.
Distribuisci l’applicazione di staging e mostrami le ultime righe del log se fallisce.
Analizza la mia infrastruttura Coolify alla ricerca di risorse non integre.
Cerca nella documentazione di Coolify come configurare lo storage persistente.
Configurazione
Ogni client avvia Coolify MCP sul tuo computer con lo stesso comando. Scegli il tuo; la pagina ricorda la tua scelta.
Claude Code
- Eseguilo in un terminale, nella cartella del tuo progetto:
claude mcp add --transport stdio coolify --env "COOLIFY_ACCESS_TOKEN=<YOUR_COOLIFY_ACCESS_TOKEN>" -- npx -y @masonator/coolify-mcp- Avvia Claude Code e digita
/mcp. coolify dovrebbe risultare collegato.
Aggiungi --scope user per renderlo disponibile in tutti i progetti. Sostituisci i segnaposto con i tuoi valori.
Claude Desktop
- Apri Settings → Developer → Edit Config. Si apre
claude_desktop_config.json. Aggiungi:
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": [
"-y",
"@masonator/coolify-mcp"
],
"env": {
"COOLIFY_ACCESS_TOKEN": "<YOUR_COOLIFY_ACCESS_TOKEN>"
}
}
}
}- Salva il file e riavvia Claude Desktop. Sostituisci i segnaposto con i tuoi valori.
Richiede Node.js sul tuo computer. Il file si trova in ~/Library/Application Support/Claude/ su macOS e in %APPDATA%\Claude\ su Windows.
Cursor
Aggiungi a Cursor (si apre in una nuova scheda)
Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": [
"-y",
"@masonator/coolify-mcp"
],
"env": {
"COOLIFY_ACCESS_TOKEN": "<YOUR_COOLIFY_ACCESS_TOKEN>"
}
}
}
}Richiede Node.js sul tuo computer. Sostituisci i segnaposto con i tuoi valori.
VS Code
Aggiungilo a .vscode/mcp.json. VS Code chiede il segreto la prima volta e lo conserva in modo sicuro:
{
"servers": {
"coolify": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@masonator/coolify-mcp"
],
"env": {
"COOLIFY_ACCESS_TOKEN": "${input:coolify-access-token}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "coolify-access-token",
"description": "COOLIFY_ACCESS_TOKEN",
"password": true
}
]
}Richiede Node.js sul tuo computer.
Devin Desktop
- Aggiungilo a
~/.config/devin/mcp_config.json(macOS e Linux) o a%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": [
"-y",
"@masonator/coolify-mcp"
],
"env": {
"COOLIFY_ACCESS_TOKEN": "<YOUR_COOLIFY_ACCESS_TOKEN>"
}
}
}
}- Aggiorna l’elenco dei server MCP in Cascade. Sostituisci i segnaposto con i tuoi valori.
Devin Desktop è il nuovo nome di Windsurf.
Codex
codex mcp add coolify --env "COOLIFY_ACCESS_TOKEN=<YOUR_COOLIFY_ACCESS_TOKEN>" -- npx -y @masonator/coolify-mcpOppure modifica direttamente ~/.codex/config.toml:
[mcp_servers.coolify]
command = "npx"
args = ["-y", "@masonator/coolify-mcp"]
env = { COOLIFY_ACCESS_TOKEN = "<YOUR_COOLIFY_ACCESS_TOKEN>" }Richiede Node.js sul tuo computer. Sostituisci i segnaposto con i tuoi valori.
Gemini CLI
gemini mcp add -e "COOLIFY_ACCESS_TOKEN=<YOUR_COOLIFY_ACCESS_TOKEN>" coolify npx -- -y @masonator/coolify-mcpCosì lo aggiungi al progetto corrente. Aggiungi -s user per usarlo ovunque.
Qualsiasi client
La maggior parte dei client che avviano server locali accetta questa forma:
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": [
"-y",
"@masonator/coolify-mcp"
],
"env": {
"COOLIFY_ACCESS_TOKEN": "<YOUR_COOLIFY_ACCESS_TOKEN>"
}
}
}
}Zed mette i server sotto context_servers nelle sue impostazioni, con gli stessi campi command, args ed env.
Richiede Node.js sul tuo computer. Sostituisci i segnaposto con i tuoi valori.
Embed
Mostra Coolify MCP in un README o sul tuo sito. Ogni embed rimanda a questa pagina, usa il comando di installazione del server e non imposta cookie. Come funzionano gli embed
Card, iframe e JSON sono in inglese. Aggiungi ?lang=it, fr, de o es al loro indirizzo per un’altra lingua.
Badge per il README
[](https://mcp.tc/i/coolify)<a href="https://mcp.tc/i/coolify"><img src="https://mcp.tc/i/coolify/badge.svg" alt="Coolify MCP on mcp.tc" height="20"></a>Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.
Card per il sito
<script src="https://mcp.tc/w/coolify.js" async></script>La card compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta cookie.
iframe
<iframe src="https://mcp.tc/embed/coolify" title="Coolify MCP on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.
JSON
La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, comando di installazione, tool e i link «Add to». Qualsiasi sito può leggerla (CORS aperto).
https://mcp.tc/i/coolify.jsonPrompt per l’AI
Incollalo in un assistente di programmazione con l’AI, come Claude Code o Cursor, e aggiungerà la card di Coolify MCP al tuo sito.
Aggiungi al mio sito la card di mcp.tc per Coolify MCP, un server MCP. È un solo script statico: niente build, nessun pacchetto da installare, nessun cookie.
Metti questo tag dove deve comparire la card. La card appare subito prima del tag:
```html
<script src="https://mcp.tc/w/coolify.js" async></script>
```
Per mostrarla altrove, metti lì questo segnaposto e carica lo stesso script una volta sola, per esempio prima di `</body>`. Lascia il link al suo interno: lo vede chi non ha JavaScript.
```html
<div data-mcptc="coolify"><a href="https://mcp.tc/i/coolify">Coolify MCP on mcp.tc</a></div>
```
Opzioni:
- `data-theme="light"` o `"dark"` sul tag o sul segnaposto fissa i colori. Senza l’attributo, la card segue la modalità chiara o scura di chi visita.
- `data-size="compact"` dà una card più piccola, senza la descrizione breve.
- La variabile CSS `--mcptc-max-width` sul segnaposto o su un elemento padre imposta la larghezza (predefinita `520px`).
- `?lang=` nell’URL dello script imposta la lingua della card: `en`, `it`, `fr`, `de` o `es`.
Se il sito ha una Content Security Policy, consenti `script-src https://mcp.tc` e `img-src data:` (l’icona è inline).
Per un README o altra documentazione in Markdown, usa invece il badge:
```markdown
[](https://mcp.tc/i/coolify)
```
Riferimento: https://mcp.tc/it/embedCronologia delle modifiche
Questo server gira sul tuo computer, quindi seguiamo il suo pacchetto npm: qui compare ogni nuova versione, insieme alle modifiche di chi lo gestisce.
Domande frequenti
Posso incollare mcp.tc/i/coolify nel mio client MCP?
No. Coolify MCP gira sul tuo computer, avviato dal tuo client, quindi non ha un indirizzo web a cui collegarsi. Il link rapido è la pagina da condividere; il comando di installazione è npx -y @masonator/coolify-mcp.
Coolify MCP richiede una chiave API?
Sì. Legge COOLIFY_ACCESS_TOKEN dal suo ambiente, e COOLIFY_ACCESS_TOKEN è un segreto. Metti il valore nella configurazione del tuo client sul tuo computer, mai in un file condiviso.
Coolify MCP è un server remoto o locale?
Locale. Il tuo client lo avvia come processo sul tuo computer con npx -y @masonator/coolify-mcp, che richiede Node.js.
Cosa può fare Coolify MCP?
Puoi diagnosticare app e server per nome, dominio, IP o UUID, analizzare l’intera infrastruttura alla ricerca di problemi e leggere i log dei container e distribuire applicazioni ed eseguire il rollback, attendendo uno stato finale.
Quali client possono usarlo?
Qualsiasi client che avvia server locali: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed e altri. claude.ai e ChatGPT si collegano solo a server remoti.
mcp.tc tiene traccia delle modifiche di Coolify MCP?
In parte. Gira sul tuo computer, quindi seguiamo il suo pacchetto npm: la sua sezione Cronologia mostra ogni nuova versione e le modifiche di chi lo gestisce. Segui la scheda per ricevere un’email quando cambia.
Chi ha scritto questa pagina?
Il robot di mcp.tc ha letto i metadati pubblici di Coolify MCP (le pagine del suo pacchetto e del repository), e un modello di AI ne ha ricavato il testo. Una persona esamina tutto ciò che i controlli non riescono a confermare. Il testo può comunque contenere errori, quindi se ne trovi uno usa Segnala questa scheda su questa pagina. Questa traduzione è stata fatta da un modello di AI a partire dal testo inglese.
mcp.tc non è affiliato a Stuart Mason. Questa pagina è stata creata a partire dai metadati pubblici di Coolify MCP (ultimo controllo: 12 ott 2026), e la descrizione l’ha scritta un modello di AI, quindi può contenere errori. Nomi e marchi appartengono ai rispettivi titolari. Qualcosa non va? Segnala questa scheda. La traduzione è stata fatta da un modello di AI a partire dal testo inglese.