Netlify

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

Netlify MCP Server

Netlify MCP Server sigue el Model Context Protocol (MCP) para permitir que los agentes de código usen la API y la CLI de Netlify, de modo que puedan crear proyectos, compilarlos, implementarlos y administrar tus recursos de Netlify mediante instrucciones en lenguaje natural.

---

Descripción general

El Model Context Protocol es un protocolo estándar emergente para conectar agentes de código con servidores MCP, lo que les permite administrar recursos y realizar tareas mediante lenguaje natural. Netlify MCP Server actúa como puente y proporciona a tus agentes acceso a la API, herramientas de la CLI, instrucciones y mucho más.

Puedes conectarte a Netlify MCP Server con diversos clientes MCP, entre ellos:

• Windsurf
• Cursor
• Claude
• Copilot (VSCode)
• Cline
• Warp
• LM Studio
• Consulta la lista completa

---

Casos de uso

Con Netlify MCP Server, tus agentes de IA pueden:

• Crear, administrar e implementar proyectos de Netlify
• Modificar los controles de acceso para mejorar la seguridad de los proyectos
• Instalar o desinstalar extensiones de Netlify
• Obtener información de usuarios y equipos
• Habilitar y administrar envíos de formularios
• Crear y administrar variables de entorno y secretos
• y mucho más...

---

Requisitos previos

• Node.js 22 o superior Compruébalo con node --version
• Una cuenta de Netlify
• Un cliente MCP (p. ej., Windsurf, Cursor, Claude, Copilot)

Consejo: Instala la CLI de Netlify globalmente para disfrutar de la mejor experiencia: npm install -g netlify-cli

---

Configuración de MCP

Para el servidor MCP de producción, usa la siguiente configuración:

Editores con instalación en un clic:

• usa el siguiente enlace en tu navegador si el enlace no se muestra o no se abre: 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.

Configuración para archivos de configuración de MCP:

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

Para el desarrollo local, consulta Configurar MCP localmente.

---

Solución de problemas

Versión de Node

• Para obtener los mejores resultados, usa Node.js 22 o superior.

• Si usas nvm, ejecuta:

  nvm install 22
  nvm use 22
  

Solución de problemas de autenticación de Netlify

• Si tienes problemas de autenticación, puedes añadir temporalmente un token de acceso personal de Netlify (PAT) a tu configuración de MCP:

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

¡No confirmes tu PAT en el repositorio! Cuando se resuelva el problema, elimina el PAT de la configuración.

---

Generar un nuevo token de acceso personal (PAT)

1. En el panel de Netlify, selecciona el icono de usuario.
2. Ve a User settings > OAuth > New access token.
3. Copia el token y añádelo (temporalmente) a tu configuración de MCP como se indicó anteriormente.
4. Reinicia o actualiza tu cliente MCP.

---

Tarjeta de implementaciones (MCP alojado)

Pídele a un cliente compatible con MCP Apps: «Muestra las implementaciones recientes de mi proyecto». La herramienta netlify-open-deployments acepta un siteId (y, de forma opcional, deployId) y muestra hasta cinco implementaciones coincidentes con su estado, rama, hora de creación etiquetada, errores y enlaces, además del equipo del proyecto y el enlace a su panel. Filtra la lista de proyectos por estado. Las herramientas también aceptan status; Netlify aplica los filtros antes de limitar los resultados. Los filtros no se aplican a un deployId específico. La tarjeta se actualiza cada cinco segundos mientras haya una implementación activa en pantalla y deja de hacerlo cuando finaliza o después de 15 minutos, incluido el tiempo que permanece oculta. El botón Refresh vuelve a comprobarlo manualmente e inicia un nuevo período de 15 minutos para las actualizaciones automáticas. Al aplicar filtros también se inicia un nuevo período. Los clientes que no admiten MCP Apps reciben un resumen de texto.

Esto usa la conexión OAuth existente de Netlify y no añade variables de entorno ni pasos de compilación del frontend. Después de implementar, actualiza el catálogo de herramientas MCP del cliente. Esta primera versión no incluye registros de compilación ni búsquedas en varios proyectos; usa el enlace Open in Netlify de la tarjeta para consultar todos los detalles de la compilación.

Para probar rápidamente en ChatGPT, conecta el endpoint /mcp de una vista previa implementada, abre un proyecto con una implementación en curso y verifica que la tarjeta se actualice hasta que finalice. Comprueba también un proyecto vacío, una implementación fallida y la alternativa de texto en un cliente sin compatibilidad con MCP Apps.

Recursos

• Documentación de Model Context Protocol
• Lista oficial de clientes MCP
• CLI de Netlify