Netlify MCP 服务器

Netlify MCP 服务器 遵循 模型上下文协议 (MCP)，使代码代理能够使用 Netlify API 和 CLI——通过自然语言提示创建新项目、构建、部署和管理您的 Netlify 资源。

---

概述

模型上下文协议是一种新兴的标准协议，用于连接代码代理与 MCP 服务器，允许它们使用自然语言来管理和执行任务。Netlify MCP 服务器充当桥梁，提供 API 访问、CLI 工具、提示等，供您的代理使用。

您可以使用多种 MCP 客户端连接到 Netlify MCP 服务器，包括：

• Windsurf
• Cursor
• Claude
• Copilot (VSCode)
• Cline
• Warp
• LM Studio
• 查看完整列表

---

使用场景

借助 Netlify MCP 服务器，您的 AI 代理可以：

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

---

先决条件

• Node.js 22 或更高版本 检查版本：node --version
• 一个 Netlify 账户
• 一个 MCP 客户端（例如，Windsurf, Cursor, Claude, Copilot）

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

---

MCP 配置

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

编辑器的一键安装：

• 如果链接无法渲染或打开，请使用以下链接在浏览器中访问：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 认证故障排除

• 如果遇到认证问题，您可以暂时将 Netlify 个人访问令牌 (PAT) 添加到您的 MCP 配置中：

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

不要将您的 PAT 提交到您的仓库！ 一旦问题解决，请从配置中移除您的 PAT。

---

生成新的个人访问令牌 (PAT)

1. 在 Netlify 控制面板中，选择您的用户图标。
2. 前往 用户设置 > OAuth > 新建访问令牌。
3. 复制您的令牌，并将其（临时）添加到您的 MCP 配置中，如上所述。
4. 重新启动或刷新您的 MCP 客户端。

---

资源

• 模型上下文协议文档
• 官方 MCP 客户端列表
• Netlify CLI