Netlify
chính thứcTạo, xây dựng, triển khai và quản lý tài nguyên Netlify bằng ngôn ngữ tự nhiên.
Bạn có thể làm gì với Netlify MCP?
- Tạo và triển khai dự án — Yêu cầu trợ lý tạo, quản lý và triển khai các dự án Netlify bằng câu lệnh ngôn ngữ tự nhiên.
- Quản lý quyền truy cập — Điều chỉnh quyền truy cập dự án để thay đổi cài đặt bảo mật cho các dự án Netlify của bạn.
- Quản lý tiện ích mở rộng — Cài đặt hoặc gỡ cài đặt tiện ích mở rộng Netlify trên các dự án của bạn.
- Quản lý biến môi trường — Tạo và quản lý biến môi trường cũng như thông tin bí mật cho các dự án của bạn.
- Xem các lần triển khai — Yêu cầu "Show recent deployments for my project" để xem trạng thái triển khai, nhánh, lỗi và liên kết.
- Lấy thông tin tài khoản — Truy xuất thông tin người dùng và nhóm, đồng thời bật hoặc quản lý việc gửi biểu mẫu.
Máy chủ MCP được lưu trữ
npx add-mcp 'https://netlify-mcp.netlify.app/mcp'Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác
Tài liệu
Netlify MCP Server
Netlify MCP Server tuân theo Model Context Protocol (MCP) để cho phép các tác tử lập trình sử dụng API và CLI của Netlify—nhờ đó, chúng có thể tạo dự án mới, xây dựng, triển khai và quản lý tài nguyên Netlify bằng các câu lệnh ngôn ngữ tự nhiên.
Tổng quan
Model Context Protocol là một giao thức tiêu chuẩn mới nổi để kết nối các tác tử lập trình với máy chủ MCP, cho phép chúng quản lý tài nguyên và thực hiện tác vụ bằng ngôn ngữ tự nhiên. Netlify MCP Server đóng vai trò cầu nối, cung cấp quyền truy cập API, công cụ CLI, câu lệnh và nhiều tính năng khác cho các tác tử của bạn.
Bạn có thể kết nối với Netlify MCP Server bằng nhiều ứng dụng khách MCP, bao gồm:
- Windsurf
- Cursor
- Claude
- Copilot (VSCode)
- Cline
- Warp
- LM Studio
- Xem danh sách đầy đủ
Trường hợp sử dụng
Với Netlify MCP Server, các tác tử AI của bạn có thể:
- Tạo, quản lý và triển khai dự án Netlify
- Sửa đổi quyền kiểm soát truy cập để tăng cường bảo mật dự án
- Cài đặt hoặc gỡ cài đặt tiện ích mở rộng Netlify
- Lấy thông tin người dùng và nhóm
- Bật và quản lý nội dung gửi qua biểu mẫu
- Tạo và quản lý biến môi trường cùng bí mật
- và nhiều tính năng khác...
Điều kiện tiên quyết
- Node.js 22 trở lên
Kiểm tra bằng
node --version - Tài khoản Netlify
- Ứng dụng khách MCP (ví dụ: Windsurf, Cursor, Claude, Copilot)
Mẹo: Cài đặt Netlify CLI trên toàn cục để có trải nghiệm tốt nhất:
npm install -g netlify-cli
Cấu hình MCP
Đối với máy chủ MCP dùng trong môi trường production, hãy sử dụng cấu hình sau:
Trình soạn thảo có cài đặt bằng một cú nhấp:
- dùng liên kết sau trong trình duyệt nếu liên kết không hiển thị hoặc không mở được:
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.
Cấu hình cho các tệp cấu hình MCP:
{
"mcpServers": {
"netlify": {
"command": "npx",
"args": [
"-y",
"@netlify/mcp"
]
}
}
}
Để phát triển cục bộ, xem Thiết lập cấu hình MCP cục bộ.
Khắc phục sự cố
Phiên bản Node
-
Để có kết quả tốt nhất, hãy dùng Node.js 22 trở lên.
-
Nếu bạn dùng
nvm, hãy chạy:nvm install 22 nvm use 22
Khắc phục sự cố xác thực Netlify
- Nếu gặp sự cố xác thực, bạn có thể tạm thời thêm Mã truy cập cá nhân Netlify (PAT) vào cấu hình MCP:
{
"mcpServers": {
"netlify-mcp": {
"command": "npx",
"args": ["-y", "@netlify/mcp"],
"env": {
"NETLIFY_PERSONAL_ACCESS_TOKEN": "YOUR-PAT-VALUE"
}
}
}
}
Không commit PAT vào kho lưu trữ của bạn! Sau khi khắc phục sự cố, hãy xóa PAT khỏi cấu hình.
Tạo mã truy cập cá nhân (PAT) mới
- Trong bảng điều khiển Netlify, chọn biểu tượng người dùng.
- Chuyển đến Cài đặt người dùng > OAuth > Mã truy cập mới.
- Sao chép mã thông báo và thêm mã đó (tạm thời) vào cấu hình MCP như trên.
- Khởi động lại hoặc làm mới ứng dụng khách MCP.
Thẻ triển khai (MCP được lưu trữ)
Hãy yêu cầu một ứng dụng khách tương thích với MCP Apps: “Hiển thị các lần triển khai gần đây cho dự án của tôi.”
Công cụ netlify-open-deployments nhận siteId (và deployId tùy chọn) rồi
hiển thị tối đa năm lần triển khai phù hợp, kèm trạng thái, nhánh, thời gian tạo có nhãn,
lỗi và liên kết, cùng với nhóm của dự án và liên kết đến trang tổng quan. Lọc
danh sách dự án theo trạng thái. Các công cụ cũng chấp nhận status; Netlify áp dụng bộ lọc
trước khi giới hạn kết quả. Bộ lọc không áp dụng cho một deployId cụ thể. Thẻ
làm mới sau mỗi năm giây khi một lần triển khai đang hiển thị vẫn hoạt động và dừng khi
quá trình hoàn tất hoặc sau 15 phút, kể cả thời gian thẻ bị ẩn. Nút Làm mới
kiểm tra lại theo cách thủ công và bắt đầu một khoảng thời gian mới 15 phút để tự động cập nhật.
Việc áp dụng bộ lọc cũng bắt đầu một khoảng thời gian mới.
Các ứng dụng khách không hỗ trợ MCP Apps sẽ nhận được bản tóm tắt dạng văn bản.
Tính năng này sử dụng kết nối OAuth Netlify hiện có và không thêm biến môi trường hay bước xây dựng frontend nào. Sau khi triển khai, hãy làm mới danh mục công cụ MCP của ứng dụng khách. Phiên bản đầu tiên này không bao gồm nhật ký bản dựng hoặc tra cứu nhiều dự án; hãy dùng liên kết Mở trong Netlify trên thẻ để xem đầy đủ chi tiết bản dựng.
Để kiểm tra nhanh trong ChatGPT, hãy kết nối điểm cuối /mcp của bản xem trước đã triển khai, mở một
dự án có lần triển khai đang chạy và xác minh thẻ cập nhật cho đến khi hoàn tất.
Đồng thời kiểm tra một dự án trống, một lần triển khai thất bại và phương án dự phòng dạng văn bản trong ứng dụng khách
không hỗ trợ MCP Apps.