Trải nghiệm khi dùng n8n-MCP
Có hai đường. Đường nhanh nhất là dịch vụ trực tuyến do tác giả vận hành, có gói miễn phí giới hạn 100 lượt gọi công cụ mỗi ngày: bạn đăng ký, nối với n8n của mình rồi nối ứng dụng AI. Đường thứ hai là tự chạy bằng npx hoặc Docker trên máy, không phụ thuộc dịch vụ ngoài.
Khi chạy cục bộ, bạn thêm vào Claude Desktop hoặc Claude Code một khối cấu hình. Chỉ với cấu hình cơ bản, AI đã tra được tài liệu về hàng nghìn node và các mẫu workflow để thiết kế quy trình. Nếu bạn thêm địa chỉ n8n và khoá API của n8n, AI còn xem, tạo và sửa workflow thật trên máy chủ n8n của bạn.
Ví dụ, bạn nhắn rằng workflow gửi báo cáo hằng sáng đã lỗi, hãy xem vì sao. AI đọc lần chạy lỗi, chỉ ra node hỏng, đề xuất sửa và có thể áp dụng chỉnh sửa. README nhấn mạnh nên thử trên bản sao trước vì AI có thể làm thay đổi workflow thật.
Tính năng nổi bật
Gỡ lỗi workflow
Đọc một lần chạy lỗi, chỉ ra node hỏng và dữ liệu đi vào, để bạn khỏi dò từng bước trên màn hình.
Sửa workflow tại chỗ
Áp dụng thay đổi nhỏ vào node và kết nối thay vì gửi lại cả workflow; mặc định lưu bản chụp trước khi sửa để có thể quay lại.
Kiểm tra trước khi chạy
Công cụ validate báo node lạ, thiếu trường bắt buộc, kết nối hay biểu thức sai; có công cụ tự sửa các lỗi phổ biến.
Kiến thức sẵn về node và mẫu
Cơ sở dữ liệu đi kèm gồm hơn ba nghìn node và hàng nghìn mẫu workflow, giúp AI cấu hình node thật thay vì đoán.
Chế độ chỉ đọc
Có cách triển khai chỉ đọc để tắt các thao tác ghi, hữu ích khi bạn chỉ muốn AI tra cứu.
Tận dụng n8n-MCP vào việc gì?
Người làm tự động hoá văn phòng, marketing
Nhờ AI dựng workflow từ mô tả
Mô tả quy trình như khi có đơn hàng mới thì ghi vào Google Sheets và báo Slack; AI tìm mẫu và node phù hợp.
Người vận hành n8n
Chẩn đoán workflow bị lỗi
Hỏi AI vì sao lần chạy đêm qua thất bại và nhận chỉ ra node lỗi cùng gợi ý sửa.
Freelancer, agency
Quản lý nhiều môi trường n8n
Dịch vụ hosted cho nối nhiều instance như production, staging, khách hàng trong một kết nối.
Người mới dùng n8n
Học n8n nhanh hơn
Hỏi AI node nào làm việc gì, cách cấu hình, có sẵn mẫu nào cho việc bạn cần.
Cần chuẩn bị gì?
- Một instance n8n có bật Public API và khoá API của n8n nếu muốn AI thao tác trên workflow thật.
- Node.js nếu chạy bằng npx, hoặc Docker nếu chạy bằng image ghcr.io/czlonkowski/n8n-mcp.
- Một ứng dụng AI hỗ trợ MCP như Claude Desktop, Claude Code, Cursor, VS Code hay Windsurf.
- Không có n8n kết nối vẫn dùng được các công cụ tra cứu tài liệu và kiểm tra, chỉ không quản lý được workflow thật.
Hướng dẫn cài đặt chi tiết
Cài trên Claude Desktop (npx)
Cài Node.js. Mở file claude_desktop_config.json (Windows: thư mục %APPDATA%\Claude; macOS: ~/Library/Application Support/Claude) và thêm khối dưới. Biến MCP_MODE là bắt buộc với Claude Desktop, nếu thiếu bạn sẽ thấy lỗi phân tích JSON.
{ "mcpServers": { "n8n-mcp": { "command": "npx", "args": ["n8n-mcp"], "env": { "MCP_MODE": "stdio", "LOG_LEVEL": "error", "DISABLE_CONSOLE_OUTPUT": "true" } } } }Để AI quản lý workflow thật, thêm hai biến N8N_API_URL và N8N_API_KEY vào env. Thay địa chỉ n8n và khoá API của bạn vào đúng chỗ.
"N8N_API_URL": "https://your-n8n-instance.com", "N8N_API_KEY": "YOUR_N8N_API_KEY"Khởi động lại Claude Desktop sau khi sửa cấu hình.
Cài trên Claude Code
Thêm máy chủ với cấu hình cơ bản (chỉ tài liệu và kiểm tra). Lệnh dưới dành cho bash, WSL hoặc Git Bash.
claude mcp add n8n-mcp \ -e MCP_MODE=stdio \ -e LOG_LEVEL=error \ -e DISABLE_CONSOLE_OUTPUT=true \ -- npx n8n-mcpMuốn có công cụ quản lý workflow thì thêm hai tuỳ chọn -e N8N_API_URL và -e N8N_API_KEY với giá trị của bạn. README có cú pháp riêng cho PowerShell nên xem tài liệu CLAUDE_CODE_SETUP của dự án nếu dùng PowerShell.
Kiểm tra trong phiên Claude Code bằng lệnh /mcp để xem máy chủ đã kết nối chưa.
Cài trên Dịch vụ hosted hoặc Docker
Muốn nhanh nhất không cài gì, dùng dịch vụ hosted có gói miễn phí 100 lượt gọi mỗi ngày.
https://dashboard.n8n-mcp.comMuốn tự chạy cô lập, kéo image Docker về rồi cấu hình ứng dụng AI chạy nó.
docker pull ghcr.io/czlonkowski/n8n-mcp:latestHướng dẫn tự dựng đầy đủ gồm npx, Docker, Railway và cài cục bộ nằm trong tài liệu SELF_HOSTING của dự án.
Dùng thử lần đầu
Bắt đầu với cấu hình cơ bản không nối n8n, để xem AI tra cứu node và mẫu mà không có rủi ro gì.
Nhờ AI gợi ý workflow cho một việc quen thuộc như gửi báo cáo bán hàng hằng ngày và xem nó chọn node ra sao.
Khi sẵn sàng, tạo khoá API trong n8n, thêm vào cấu hình, và dùng một instance thử nghiệm hoặc bản sao để thử.
Nhờ AI kiểm tra (validate) một workflow có sẵn và đọc báo cáo lỗi trước khi cho phép sửa.
Chỉ khi quen mới thử cho AI sửa workflow thật, và xem chắc chắn đã có bản chụp để quay lại.
Mẹo dùng hay
- Thử mọi thay đổi quan trọng trên bản sao hoặc môi trường staging trước; README nhấn mạnh AI có thể làm thay đổi workflow thật.
- Đừng sửa workflow trên giao diện n8n khi AI đang làm việc trên nó, vì thay đổi của bạn có thể bị ghi đè.
- Giữ bản xuất (export) của những workflow không được phép mất.
- Dùng chế độ chỉ đọc nếu bạn chỉ muốn AI phân tích mà không sửa gì.
Lưu ý và hạn chế
- Tên giống nhau dễ nhầm: n8n có máy chủ MCP tích hợp riêng; n8n-MCP là dự án khác của cộng đồng, cài thêm bên ngoài và README có bảng so sánh hai cái.
- AI có thể tạo, sửa hoặc xoá workflow và thông tin xác thực thật; khoá API n8n trong cấu hình cũng cần được giữ kín.
- Dịch vụ hosted do tác giả vận hành có gói giới hạn và có thể có phí; dự án cũng nhận tài trợ và kèm dịch vụ tư vấn trả phí của tác giả.
- Snapshot trước khi sửa có thể không lưu được mà vẫn tiếp tục sửa; hãy kiểm tra có bản lưu trước khi dựa vào việc quay lại.
Câu hỏi thường gặp
n8n-MCP có miễn phí không?
Mã nguồn mở giấy phép MIT và tự chạy miễn phí. Dịch vụ hosted có gói miễn phí 100 lượt gọi mỗi ngày; các gói khác xem trên trang của họ.
Tôi chưa biết n8n thì dùng được không?
Nên làm quen n8n trước, vì n8n-MCP chỉ là trợ lý cho n8n; bạn cần hiểu workflow để kiểm tra AI làm đúng hay sai.
Khác gì máy chủ MCP có sẵn trong n8n?
README nói hai cái bổ trợ nhau. Bản tích hợp chạy trong một instance; n8n-MCP là máy chủ riêng, nối được nhiều instance, quản lý thông tin xác thực và có thêm công cụ kiểm tra, tự sửa, mẫu.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/czlonkowski/n8n-mcp.gitRepo tương tự nên xem
n8n
n8n-io / n8n
Tự động hoá công việc bằng sơ đồ kéo thả, nối hơn 1500 ứng dụng và cả AI, tự cài trên máy chủ riêng
Activepieces
activepieces / activepieces
Công cụ tự động hoá kiểu Zapier mã nguồn mở, kéo thả các bước và nối được với AI, tự cài trên máy của bạn
Dify
langgenius / dify
Nền tảng kéo thả để dựng ứng dụng AI, chatbot hỏi đáp tài liệu và quy trình tự động, tự cài bằng Docker