Netlify

npx add-mcp 'https://netlify-mcp.netlify.app/mcp'

Serveur MCP Netlify

Serveur MCP Netlify suit le Model Context Protocol (MCP) pour permettre aux agents de code d’utiliser l’API et la CLI Netlify, afin qu’ils puissent créer de nouveaux projets, les compiler, les déployer et gérer vos ressources Netlify à l’aide de prompts en langage naturel.

---

Présentation

Le Model Context Protocol est un protocole standard émergent qui permet de connecter des agents de code à des serveurs MCP et de leur permettre de gérer des ressources et d’effectuer des tâches en langage naturel. Le serveur MCP Netlify sert de passerelle et fournit à vos agents un accès à l’API, des outils CLI, des prompts et bien plus encore.

Vous pouvez vous connecter au serveur MCP Netlify à l’aide de différents clients MCP, notamment :

• Windsurf
• Cursor
• Claude
• Copilot (VSCode)
• Cline
• Warp
• LM Studio
• Voir la liste complète

---

Cas d’utilisation

Avec le serveur MCP Netlify, vos agents IA peuvent :

• Créer, gérer et déployer des projets Netlify
• Modifier les contrôles d’accès pour renforcer la sécurité des projets
• Installer ou désinstaller des extensions Netlify
• Récupérer des informations sur les utilisateurs et les équipes
• Activer et gérer les soumissions de formulaires
• Créer et gérer des variables d’environnement et des secrets
• et bien plus encore...

---

Prérequis

• Node.js 22 ou version ultérieure Vérifiez avec node --version
• Un compte Netlify
• Un client MCP (par exemple, Windsurf, Cursor, Claude, Copilot)

Conseil : Installez la CLI Netlify globalement pour une expérience optimale : npm install -g netlify-cli

---

Configuration MCP

Pour le serveur MCP de production, utilisez la configuration suivante :

Éditeurs proposant une installation en un clic :

• utilisez le lien suivant dans votre navigateur si le lien ne s’affiche pas ou ne s’ouvre pas : goose://extension?cmd=npx&arg=-y&arg=%40netlify%2Fmcp&id=netlify&name=Netlify&description=Build%2C%20deploy%2C%20and%20manage%20sites%20with%20Netlify's%20official%20MCP%20server.

Configuration des fichiers de configuration MCP :

{
  "mcpServers": {
    "netlify": {
      "command": "npx",
      "args": [
        "-y",
        "@netlify/mcp"
      ]
    }
  }
}

Pour le développement local, consultez Configurer MCP en local.

---

Dépannage

Version de Node

• Pour de meilleurs résultats, utilisez Node.js 22 ou une version ultérieure.

• Si vous utilisez nvm, exécutez :

  nvm install 22
  nvm use 22
  

Dépannage de l’authentification Netlify

• En cas de problème d’authentification, vous pouvez ajouter temporairement un jeton d’accès personnel Netlify (PAT) à votre configuration MCP :

{
  "mcpServers": {
    "netlify-mcp": {
      "command": "npx",
      "args": ["-y", "@netlify/mcp"],
      "env": {
        "NETLIFY_PERSONAL_ACCESS_TOKEN": "YOUR-PAT-VALUE"
      }
    }
  }
}

Ne validez pas votre PAT dans votre dépôt ! Une fois le problème résolu, supprimez votre PAT de la configuration.

---

Générer un nouveau jeton d’accès personnel (PAT)

1. Dans le tableau de bord Netlify, sélectionnez l’icône de votre utilisateur.
2. Accédez à User settings > OAuth > New access token.
3. Copiez votre jeton et ajoutez-le (temporairement) à votre configuration MCP comme indiqué ci-dessus.
4. Redémarrez ou actualisez votre client MCP.

---

Carte de déploiement (MCP hébergé)

Demandez à un client compatible avec MCP Apps : « Affiche les déploiements récents de mon projet. » L’outil netlify-open-deployments prend un siteId (et éventuellement un deployId) et affiche jusqu’à cinq déploiements correspondants avec leur état, leur branche, une date de création libellée, les erreurs et les liens, ainsi que l’équipe du projet et le lien vers son tableau de bord. Filtrez la liste des projets par état. Les outils acceptent également status ; Netlify applique les filtres avant de limiter les résultats. Les filtres ne s’appliquent pas à un deployId spécifique. La carte s’actualise toutes les cinq secondes tant qu’un déploiement affiché est actif et cesse de s’actualiser lorsqu’il est terminé ou après 15 minutes, y compris le temps passé en arrière-plan. Le bouton Actualiser relance la vérification manuellement et démarre une nouvelle période de 15 minutes pour les mises à jour automatiques. L’application de filtres démarre également une nouvelle période. Les clients qui ne prennent pas en charge MCP Apps reçoivent un résumé textuel.

Cette fonctionnalité utilise la connexion OAuth Netlify existante et n’ajoute aucune variable d’environnement ni étape de compilation frontend. Après le déploiement, actualisez le catalogue d’outils MCP du client. Cette première version n’inclut pas les journaux de compilation ni la recherche sur plusieurs projets ; utilisez le lien Ouvrir dans Netlify de la carte pour consulter tous les détails de compilation.

Pour effectuer un test rapide dans ChatGPT, connectez le point de terminaison /mcp d’un aperçu déployé, ouvrez un projet avec un déploiement en cours et vérifiez que la carte s’actualise jusqu’à la fin. Vérifiez également un projet vide, un déploiement ayant échoué et le texte de remplacement dans un client qui ne prend pas en charge MCP Apps.

Ressources

• Documentation du Model Context Protocol
• Liste officielle des clients MCP
• CLI Netlify