Netlify

官方

使用自然语言创建、构建、部署和管理 Netlify 资源。

GitHub
72

你可以用 Netlify MCP 做什么？

  • 创建和部署项目 — 使用自然语言提示，让你的助手创建、管理和部署 Netlify 项目。
  • 管理访问控制 — 修改项目访问控制，以调整 Netlify 项目的安全设置。
  • 管理扩展 — 在项目中安装或卸载 Netlify 扩展。
  • 管理环境变量 — 为项目创建和管理环境变量及密钥。
  • 查看部署 — 询问“显示我项目的近期部署”，即可查看部署状态、分支、错误和链接。
  • 获取账户信息 — 获取用户和团队信息，并启用或管理表单提交。

托管 MCP 服务器

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

可安装到 Claude Code、Codex、Cursor 等客户端

文档

Netlify MCP Server

Netlify MCP Server 遵循 Model Context Protocol (MCP) 标准，使代码代理能够使用 Netlify API 和 CLI，从而通过自然语言提示创建新项目、构建、部署和管理 Netlify 资源。

概述

Model Context Protocol 是一项新兴标准协议，用于将代码代理连接到 MCP 服务器，使其能够通过自然语言管理资源并执行任务。Netlify MCP Server 充当桥梁，为代理提供 API 访问权限、CLI 工具、提示等功能。

你可以使用多种 MCP 客户端连接到 Netlify MCP Server，包括：

使用场景

借助 Netlify MCP Server，你的 AI 代理可以：

  • 创建、管理和部署 Netlify 项目
  • 修改访问控制，增强项目安全性
  • 安装或卸载 Netlify 扩展
  • 获取用户和团队信息
  • 启用和管理表单提交
  • 创建和管理环境变量与密钥
  • 等等...

前提条件

  • Node.js 22 或更高版本 使用 node --version 检查
  • Netlify 账户
  • MCP 客户端（例如 Windsurf、Cursor、Claude、Copilot）

提示： 全局安装 Netlify CLI 可获得最佳体验： npm install -g netlify-cli

MCP 配置

对于生产环境 MCP 服务器，请使用以下配置：

支持一键安装的编辑器：

Install MCP Server on Cursor

Add MCP Server netlify to LM Studio

Install on VS Code

Install on VS Code Insiders Edition

Install on Goose

  • 如果链接无法呈现或打开，请在浏览器中使用以下链接：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.

MCP 配置文件的配置：

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

本地开发请参阅设置本地 MCP 配置。

故障排除

Node 版本

  • 为获得最佳效果，请使用 Node.js 22 或更高版本。

  • 如果你使用 nvm，请运行：

    nvm install 22
nvm use 22

Netlify 身份验证故障排除

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

请勿将 PAT 提交到你的代码仓库！ 问题解决后，请从配置中移除 PAT。

生成新的 Personal Access Token (PAT)

  1. 在 Netlify 控制面板中，选择你的用户图标。
  2. 前往 User settings > OAuth > New access token。
  3. 复制令牌，并按上述说明将其（临时）添加到 MCP 配置中。
  4. 重启或刷新 MCP 客户端。

部署卡片（托管 MCP）

向兼容 MCP Apps 的客户端提问：“显示我项目的近期部署。” netlify-open-deployments 工具接受一个 siteId（以及可选的 deployId），并 显示最多五个匹配的部署，包括状态、分支、带标签的创建时间、 错误信息和链接，以及项目所属团队和团队控制面板链接。可按状态筛选 项目列表。工具也接受 status；筛选由 Netlify 在限制结果数量之前 应用。筛选条件不适用于特定的 deployId。当显示的部署处于活动状态时，卡片 每五秒刷新一次；部署完成或经过 15 分钟后停止刷新，隐藏期间的时间也 计入其中。点击“刷新”按钮可手动再次检查，并重新开始 15 分钟的自动更新 时段。应用筛选条件也会开启新的时段。 不支持 MCP Apps 的客户端会收到文本摘要。

此功能使用现有的 Netlify OAuth 连接，不会添加环境变量或前端构建步骤。 部署后，请刷新客户端的 MCP 工具目录。此首个版本不包含构建日志或多项目 查询；如需查看完整构建详情，请使用卡片中的 在 Netlify 中打开 链接。

要在 ChatGPT 中进行冒烟测试，请连接已部署预览的 /mcp 端点，打开一个 有正在运行的部署的项目，并确认卡片会持续更新直至部署完成。 还要检查空项目、失败的部署，以及不支持 MCP Apps 的客户端中的文本回退显示。

资源