--- title: Serveur MCP Coolify description: >- Activez le serveur MCP de Coolify sur votre serveur MapleDeploy, créez un jeton d'API et connectez Claude Code, Cursor ou Codex pour déployer vos applications. order: 9 lastUpdated: '2026-09-24' type: article author: Ross Hill locale: fr_CA keywords: - hébergement canadien - souveraineté des données canadiennes - hébergement géré Coolify - hébergement conforme LPRPDE - déploiement par git push - bases de données gérées Canada site_name: MapleDeploy slogan: Hébergement performant en sol canadien organization_url: 'https://mapledeploy.ca/' logo: 'https://mapledeploy.ca//api/logo/lockup' creator: MapleDeploy publisher: MapleDeploy founding_date: '2026-01-13' email: hello@mapledeploy.ca geo_region: CA-QC geo_placename: Montréal address_country: CA area_served: Canada application_category: DeveloperApplication app_url: 'https://app.mapledeploy.ca' llms_txt: 'https://mapledeploy.ca/fr/llms.txt' offers: >- Starter $45/mo, Pro $95/mo, Ultra $195/mo, Ultra 32 $395/mo, Ultra 64 $695/mo CAD in_language: fr-CA canonical_url: 'https://mapledeploy.ca/fr/docs/coolify-mcp-server' --- Coolify intègre un serveur MCP, un point de terminaison Model Context Protocol à `/mcp` sur votre instance. Une fois que vous l'activez et créez un jeton d'API, un client de codage IA comme Claude Code, Cursor ou Codex peut déployer vos applications, démarrer et arrêter des ressources, et lire les journaux sur votre serveur MapleDeploy. Le serveur MCP est désactivé jusqu'à ce que vous l'activiez. Ce guide couvre son activation, la création d'un jeton, la connexion d'un client et sa désactivation. ## Ce qu'un client connecté peut faire Les outils qu'un client peut appeler dépendent des droits du jeton que vous lui donnez, et le droit de déploiement de Coolify est exclusif : un jeton de déploiement peut agir sur vos ressources, mais ne peut pas les lire. - Un jeton de déploiement peut déployer et redéployer vos applications et démarrer, arrêter et redémarrer vos ressources. - Un jeton de lecture peut lister vos ressources et les noms de leurs variables d'environnement. Il ne renvoie jamais les valeurs. - La lecture des journaux de service exige un jeton read:sensitive. Donnez au client le jeton le moins puissant possible pour sa tâche. S'il doit à la fois agir et lire, créez un jeton distinct pour chaque usage. ## Activer le serveur MCP 1. Connectez-vous au tableau de bord MapleDeploy. 2. Ouvrez le serveur et allez à l'onglet **Outils**. 3. Sous **Serveur MCP**, sélectionnez **Activer le serveur MCP**. 4. Lisez l'avertissement sur ce qu'un point de terminaison activé expose, puis confirmez. Seuls les propriétaires et administrateurs de l'organisation peuvent modifier ce paramètre. Si vous ne voyez pas le contrôle, votre serveur a peut-être besoin d'une mise à jour de Coolify avant qu'il apparaisse; il s'affiche dans l'onglet Outils une fois la mise à jour appliquée. ## Créer un jeton d'API Coolify Le point de terminaison MCP s'authentifie avec un jeton d'API Coolify. Les droits du jeton décident de ce qu'un client connecté peut faire. 1. Ouvrez votre tableau de bord Coolify. Le lien se trouve sur la page de détails de votre serveur. 2. Allez à **Security** puis **API Tokens**. 3. Créez un jeton et choisissez ses droits. Coolify propose read, read:sensitive, write, write:sensitive, deploy et root. Le droit de déploiement est exclusif : un jeton de déploiement ne peut pas aussi lire. Créez un jeton de lecture distinct si votre client a aussi besoin des journaux ou de la configuration. Commencez par le minimum dont vous avez besoin. 4. Copiez le jeton. Coolify ne l'affiche qu'une fois. Si la création de jeton est masquée, l'API REST de Coolify est désactivée sur votre instance. Activez-la sous **Settings** puis **Advanced** dans Coolify, puis créez le jeton. Activer l'API REST ouvre aussi la surface REST de Coolify, alors désactivez-la de nouveau si vous n'en avez pas besoin. ## Connecter votre client Votre point de terminaison est votre adresse Coolify suivie de `/mcp`. Une fois le serveur MCP activé, l'onglet **Outils** l'affiche avec un bouton pour le copier : ``` https://votre-serveur.mapledeploy.ca/mcp ``` Chaque client a besoin de deux choses : cette URL, et votre jeton d'API transmis comme jeton porteur. Remplacez `VOTRE_JETON` ci-dessous par le jeton que vous avez copié. **Claude Code.** Exécutez : ```bash claude mcp add --transport http coolify https://votre-serveur.mapledeploy.ca/mcp --header "Authorization: Bearer VOTRE_JETON" ``` **Cursor.** Ajoutez le serveur à `~/.cursor/mcp.json`. Utilisez ce fichier global plutôt que le `.cursor/mcp.json` d'un projet, pour que le jeton ne se retrouve jamais dans un dépôt. ```json { "mcpServers": { "coolify": { "url": "https://votre-serveur.mapledeploy.ca/mcp", "headers": { "Authorization": "Bearer VOTRE_JETON" } } } } ``` **Codex.** Codex lit le jeton dans une variable d'environnement. Définissez-la là où Codex s'exécute, par exemple dans le profil de votre shell, puis ajoutez le serveur : ```bash export COOLIFY_TOKEN=VOTRE_JETON codex mcp add coolify --url https://votre-serveur.mapledeploy.ca/mcp --bearer-token-env-var COOLIFY_TOKEN ``` Une fois connecté, demandez au client de déployer une application ou de récupérer les journaux d'un service. Ce qu'il peut faire dépend des droits du jeton, décrits plus haut. ## Le désactiver Retournez à l'onglet **Outils** du serveur et sélectionnez **Désactiver le serveur MCP**. Le point de terminaison cesse de répondre immédiatement. La désactivation ne supprime pas vos jetons d'API; révoquez dans Coolify, sous **Security** puis **API Tokens**, tout jeton dont vous n'avez plus besoin. ## À garder en tête Un serveur MCP activé est une vraie capacité, alors traitez-le comme telle. - Tout jeton d'API Coolify de votre instance peut joindre le point de terminaison une fois activé, y compris les jetons en lecture seule. Gardez les droits des jetons aussi restreints que la tâche l'exige. - Le risque réaliste est l'injection d'invite atteignant un client connecté. Soyez délibéré sur ce que vous connectez et ce que vous y collez. - Le point de terminaison renvoie les noms des variables d'environnement, jamais leurs valeurs. - Vous pouvez désactiver le point de terminaison à tout moment depuis l'onglet Outils. ## Documentation connexe - [Accès à l'équipe Coolify](/fr/docs/coolify-access) - [Déployer votre première application](/fr/docs/deploy-your-first-app)