Nous et des tiers sélectionnés utilisons des cookies ou des technologies similaires à des fins techniques et, avec votre consentement, pour analyser l’utilisation du site.

Vous pouvez librement donner, refuser ou retirer votre consentement à tout moment.

Coolify MCP

Serveur MCP par Stuart Mason

Déployer, diagnostiquer et exploiter un PaaS Coolify auto-hébergé depuis votre assistant IA, avec confirmation humaine pour les actions destructrices.

S’exécute en local (Tourne sur votre machine : sa page donne la commande d’installation)S’exécute avec npxClé API requise

Installer Coolify MCP

Tourne sur votre machine. Votre client le lance avec cette commande :

npx -y @masonator/coolify-mcp

Nécessite Node.js sur votre ordinateur. Les étapes ci-dessous montrent où placer la commande dans chaque client.

  • COOLIFY_ACCESS_TOKEN secret Your Coolify API access token
  • COOLIFY_BASE_URL facultatif Your Coolify instance URL

Partager ce serveur

Ouvre cette page, avec la commande d’installation et les étapes de configuration.

mcp.tc/i/coolify

Présentation

Se connecte à une instance Coolify v4 et permet à un assistant de déployer des applications, de lire les logs des conteneurs, de diagnostiquer applications et serveurs, de gérer bases de données, services, projets, variables d’environnement, sauvegardes et tâches planifiées, et de rechercher dans la documentation de Coolify. Les opérations destructrices demandent d’abord une confirmation à l’utilisateur, et les secrets sont masqués dans les réponses.

S’exécute en local via stdio avec npx @masonator/coolify-mcp, ou sous forme de bundle MCPB en un clic pour Claude Desktop. Il peut aussi être déployé en conteneur à côté de Coolify pour un usage distant. Nécessite un jeton API Coolify dans COOLIFY_ACCESS_TOKEN et, en option, l’URL de l’instance dans COOLIFY_BASE_URL.

Ce que vous pouvez faire

  • Diagnostiquer applications et serveurs par nom, domaine, IP ou UUID
  • Analyser le parc à la recherche de problèmes et lire les logs des conteneurs
  • Déployer des applications et revenir en arrière, en attendant un statut final
  • Démarrer, arrêter et redémarrer des ressources
  • Créer et gérer applications, bases de données, services et projets
  • Gérer variables d’environnement, stockages, sauvegardes et tâches planifiées avec secrets masqués
  • Exécuter des opérations en masse après confirmation humaine
  • Rechercher dans la documentation de Coolify

Outils

Les serveurs locaux présentent leurs outils une fois lancés, nous ne pouvons donc pas les afficher ici. Cherchez la liste dans sa documentation ; votre client les affiche après l’ajout.

Exemples de prompts

  • Pourquoi mon application sur example.com échoue-t-elle ? Diagnostique-la.

  • Déploie l’application de staging et montre-moi la fin des logs si elle échoue.

  • Analyse mon parc Coolify à la recherche de ressources défaillantes.

  • Cherche dans la documentation de Coolify comment configurer un stockage persistant.

Configuration

Chaque client lance Coolify MCP sur votre machine avec la même commande. Choisissez le vôtre ; la page retient votre choix.

Claude Code

  1. Lancez ceci dans un terminal, dans le dossier de votre projet :
claude mcp add --transport stdio coolify --env "COOLIFY_ACCESS_TOKEN=<YOUR_COOLIFY_ACCESS_TOKEN>" -- npx -y @masonator/coolify-mcp
  1. Démarrez Claude Code et tapez /mcp. coolify devrait apparaître comme connecté.

Ajoutez --scope user pour le rendre disponible dans tous vos projets. Remplacez les espaces réservés par vos propres valeurs.

Claude Desktop

  1. Ouvrez Settings → Developer → Edit Config. Cela ouvre claude_desktop_config.json. Ajoutez :
claude_desktop_config.json
{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": [
        "-y",
        "@masonator/coolify-mcp"
      ],
      "env": {
        "COOLIFY_ACCESS_TOKEN": "<YOUR_COOLIFY_ACCESS_TOKEN>"
      }
    }
  }
}
  1. Enregistrez le fichier et redémarrez Claude Desktop. Remplacez les espaces réservés par vos propres valeurs.

Nécessite Node.js sur votre ordinateur. Le fichier se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows.

Cursor

Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :

mcp.json
{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": [
        "-y",
        "@masonator/coolify-mcp"
      ],
      "env": {
        "COOLIFY_ACCESS_TOKEN": "<YOUR_COOLIFY_ACCESS_TOKEN>"
      }
    }
  }
}

Nécessite Node.js sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.

VS Code

Ajoutez-le à .vscode/mcp.json. VS Code demande le secret la première fois et le stocke de façon sécurisée :

.vscode/mcp.json
{
  "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
    }
  ]
}

Nécessite Node.js sur votre ordinateur.

Devin Desktop

  1. Ajoutez-le à ~/.config/devin/mcp_config.json (macOS et Linux) ou %APPDATA%\devin\mcp_config.json (Windows) :
mcp_config.json
{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": [
        "-y",
        "@masonator/coolify-mcp"
      ],
      "env": {
        "COOLIFY_ACCESS_TOKEN": "<YOUR_COOLIFY_ACCESS_TOKEN>"
      }
    }
  }
}
  1. Actualisez la liste des serveurs MCP dans Cascade. Remplacez les espaces réservés par vos propres valeurs.

Devin Desktop est le nouveau nom de Windsurf.

Codex

codex mcp add coolify --env "COOLIFY_ACCESS_TOKEN=<YOUR_COOLIFY_ACCESS_TOKEN>" -- npx -y @masonator/coolify-mcp

Ou modifiez directement ~/.codex/config.toml :

config.toml
[mcp_servers.coolify]
command = "npx"
args = ["-y", "@masonator/coolify-mcp"]
env = { COOLIFY_ACCESS_TOKEN = "<YOUR_COOLIFY_ACCESS_TOKEN>" }

Nécessite Node.js sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.

Gemini CLI

gemini mcp add -e "COOLIFY_ACCESS_TOKEN=<YOUR_COOLIFY_ACCESS_TOKEN>" coolify npx -- -y @masonator/coolify-mcp

Cela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.

Tout client

La plupart des clients qui lancent des serveurs locaux acceptent cette forme :

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": [
        "-y",
        "@masonator/coolify-mcp"
      ],
      "env": {
        "COOLIFY_ACCESS_TOKEN": "<YOUR_COOLIFY_ACCESS_TOKEN>"
      }
    }
  }
}

Zed place les serveurs sous context_servers dans ses réglages, avec les mêmes champs command, args et env.

Nécessite Node.js sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.

Intégrer

Affichez Coolify MCP dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise la commande d’installation du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations

La carte, l’iframe et le JSON sont en anglais. Ajoutez ?lang=it, fr, de ou es à leur adresse pour une autre langue.

Badge pour README

Aperçu du badge, clairAperçu du badge, sombre
Markdown
[![Coolify MCP on mcp.tc](https://mcp.tc/i/coolify/badge.svg)](https://mcp.tc/i/coolify)
HTML
<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>

Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.

Carte pour site web

HTML
<script src="https://mcp.tc/w/coolify.js" async></script>

La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.

iframe

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

Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.

JSON

La fiche sous forme de données pour vos pages et vos outils : nom, accroche, commande d’installation, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).

https://mcp.tc/i/coolify.json

Ce que signifie chaque champ

Prompt pour l’IA

Collez-le dans un assistant de code IA, comme Claude Code ou Cursor, et il ajoutera la carte de Coolify MCP à votre site.

Markdown
Ajoute à mon site la carte mcp.tc de Coolify MCP, un serveur MCP. C’est un seul script statique : pas de build, aucun paquet à installer, aucun cookie.

Place cette balise là où la carte doit apparaître. La carte s’affiche juste avant elle :

```html
<script src="https://mcp.tc/w/coolify.js" async></script>
```

Pour l’afficher ailleurs, mets ce conteneur à cet endroit et charge le même script une seule fois, par exemple avant `</body>`. Garde le lien à l’intérieur : les visiteurs sans JavaScript le voient.

```html
<div data-mcptc="coolify"><a href="https://mcp.tc/i/coolify">Coolify MCP on mcp.tc</a></div>
```

Options :
- `data-theme="light"` ou `"dark"` sur la balise ou le conteneur fixe les couleurs. Sans cela, la carte suit le mode clair ou sombre du visiteur.
- `data-size="compact"` donne une carte plus petite, sans l’accroche.
- La variable CSS `--mcptc-max-width` sur le conteneur ou un parent fixe la largeur (`520px` par défaut).
- `?lang=` dans l’URL du script choisit la langue de la carte : `en`, `it`, `fr`, `de` ou `es`.

Si le site a une Content Security Policy, autorise `script-src https://mcp.tc` et `img-src data:` (l’icône est intégrée).

Pour un README ou une autre doc en Markdown, utilise plutôt le badge :

```markdown
[![Coolify MCP on mcp.tc](https://mcp.tc/i/coolify/badge.svg)](https://mcp.tc/i/coolify)
```

Référence : https://mcp.tc/fr/embed

Historique des changements

Ce serveur tourne sur votre ordinateur, donc nous suivons son paquet npm : chaque nouvelle version apparaît ici, avec les modifications de son propriétaire.

Suivez Coolify MCP et nous vous enverrons un e-mail quand quelque chose change.

  1. , Vérification automatique

    Nouvelle version 3.10.1 (avant : 3.9.0). Lue sur npm.

  2. , Vérification automatique

    Début de l’observation : version 3.9.0.

FAQ

Puis-je coller mcp.tc/i/coolify dans mon client MCP ?

Non. Coolify MCP tourne sur votre propre ordinateur, lancé par votre client, il n’a donc pas d’adresse web à laquelle se connecter. Le lien rapide est la page à partager ; la commande d’installation est npx -y @masonator/coolify-mcp.

Coolify MCP a-t-il besoin d’une clé API ?

Oui. Il lit COOLIFY_ACCESS_TOKEN dans son environnement, et COOLIFY_ACCESS_TOKEN est un secret. Mettez la valeur dans la configuration de votre client, sur votre propre machine, jamais dans un fichier partagé.

Coolify MCP est-il un serveur distant ou local ?

Local. Votre client le lance comme un processus sur votre ordinateur avec npx -y @masonator/coolify-mcp, qui nécessite Node.js.

Que peut faire Coolify MCP ?

Vous pouvez diagnostiquer applications et serveurs par nom, domaine, IP ou UUID, analyser le parc à la recherche de problèmes et lire les logs des conteneurs et déployer des applications et revenir en arrière, en attendant un statut final.

Quels clients peuvent l’utiliser ?

Tout client qui lance des serveurs locaux : Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed et d’autres. claude.ai et ChatGPT ne se connectent qu’à des serveurs distants.

mcp.tc suit-il les changements de Coolify MCP ?

En partie. Il tourne sur votre ordinateur, donc nous suivons son paquet npm : son onglet Historique montre chaque nouvelle version et les modifications de son propriétaire. Suivez la fiche pour recevoir un e-mail quand elle change.

Qui a rédigé cette page ?

Le robot de mcp.tc a lu les métadonnées publiques de Coolify MCP (ses pages de paquet et de dépôt), et un modèle d’IA en a tiré le texte. Une personne examine tout ce que les vérifications ne peuvent pas confirmer. Le texte peut encore contenir des erreurs : si vous en repérez une, utilisez Signaler cette fiche sur cette page. Cette traduction a été réalisée par un modèle d’IA à partir du texte anglais.

mcp.tc n’est pas affilié à Stuart Mason. Cette page a été construite à partir des métadonnées publiques de Coolify MCP, vérifiées pour la dernière fois le 12 oct. 2026, et un modèle d’IA a rédigé la description : elle peut contenir des erreurs. Les noms et marques appartiennent à leurs propriétaires. Quelque chose cloche ? Signaler cette fiche. La traduction a été réalisée par un modèle d’IA à partir du texte anglais.