Trần Văn GiỏiAI Thực Chiến · n8n × Claude
← Trang chính
Sau khi nối, bạn gõ trong Claude: “xem workflow nào đang lỗi”, “tạo workflow gửi báo cáo sáng”, “thêm node Telegram vào workflow X” — Claude tự thao tác trên n8n của bạn. Đây là đúng bộ kết nối tôi đang dùng hằng ngày, viết lại từng bước cho bạn.
n8n mạnh nhưng xây workflow vẫn phải kéo thả từng node, đọc log từng dòng. Nối vào Claude, bạn được 3 thứ: (1) mô tả bằng tiếng Việt → Claude dựng workflow giùm; (2) lỗi ở đâu Claude đọc execution log và chỉ tận nơi; (3) hỏi “nên dùng node nào” — Claude tra đúng tài liệu của hơn 500 node để trả lời. Kéo thả cả buổi thành ra một câu lệnh.
MCP (Model Context Protocol) = chuẩn cắm thiết bị ngoài cho AI — như cổng USB: cắm đúng chuẩn là Claude "thấy" và điều khiển được n8n. n8n-mcp là gói mã nguồn mở làm nhiệm vụ phiên dịch đó.
Cloud, hosting thuê, hay tự cài đều được — miễn bạn mở được giao diện n8n bằng trình duyệt và có địa chỉ URL (vd https://n8n-cua-ban.com).
Chưa có? Xem Bài 1 — phần Cài đặt.
Để chạy được lệnh npx. Kiểm tra: mở CMD/Terminal gõ node --version — ra số (vd v20.x) là ổn. Chưa có thì tải tại nodejs.org (bấm Next là xong).
Một trong hai (hoặc cả hai): Claude Code — dòng lệnh/app, mạnh nhất cho việc này; Claude Desktop — app chat quen thuộc. Hướng dẫn dưới có cho cả hai.
Mở CMD / PowerShell (Windows) hoặc Terminal (Mac), dán lệnh sau — thay 2 chỗ: URL n8n của bạn và key vừa lấy:
claude mcp add n8n ^ -e MCP_MODE=stdio ^ -e N8N_API_URL=https://n8n-cua-ban.com ^ -e N8N_API_KEY=KEY_CUA_BAN ^ -- cmd /c npx -y n8n-mcp
claude mcp add n8n \ -e MCP_MODE=stdio \ -e N8N_API_URL=https://n8n-cua-ban.com \ -e N8N_API_KEY=KEY_CUA_BAN \ -- npx -y n8n-mcp
claude mcp add n8n — đăng ký một "thiết bị ngoài" tên n8n với Claude ·
-e N8N_API_URL — địa chỉ n8n của bạn, chỉ phần gốc, không thêm /api hay dấu / cuối ·
-e N8N_API_KEY — chìa khoá vừa tạo ·
npx -y n8n-mcp — tự tải & chạy người phiên dịch (lần đầu hơi lâu vì phải tải) ·
cmd /c — bắt buộc trên Windows để npx chạy được trong nền; Mac bỏ đi.
Mở file cấu hình của Claude Desktop bằng Notepad/TextEdit:
· Windows: %APPDATA%\Claude\claude_desktop_config.json (dán vào thanh địa chỉ File Explorer)
· Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Dán khối sau (nếu file đã có mcpServers thì chỉ thêm phần "n8n": {...} vào trong):
{
"mcpServers": {
"n8n": {
"command": "cmd",
"args": ["/c", "npx", "-y", "n8n-mcp"],
"env": {
"MCP_MODE": "stdio",
"LOG_LEVEL": "error",
"DISABLE_CONSOLE_OUTPUT": "true",
"N8N_API_URL": "https://n8n-cua-ban.com",
"N8N_API_KEY": "DAN_KEY_CUA_BAN_VAO_DAY"
}
}
}
}
"command": "cmd" thành "command": "npx" và "args": ["-y", "n8n-mcp"] ·
JSON khó tính: thiếu/thừa 1 dấu phẩy là hỏng cả file — sửa xong nên dán vào jsonlint.com soát ·
Lưu file xong phải thoát hẳn Claude Desktop (chuột phải icon khay đồng hồ → Quit) rồi mở lại — đóng cửa sổ thôi là chưa đủ.
Kiểm tra kết nối n8n giúp tôi (health check)
Liệt kê các workflow trong n8n của tôi, cái nào đang Active?
| Nhóm việc | Ví dụ lệnh bạn gõ | Claude làm gì phía sau |
|---|---|---|
| 🔍 Đọc & chẩn đoán | “Workflow Đăng bài sáng nay có chạy không, lỗi gì?” | Đọc executions, tìm node đỏ, giải thích nguyên nhân bằng tiếng Việt |
| 🏗️ Tạo mới | “Tạo workflow: 8h sáng lấy giá vàng, nhắn Telegram cho tôi” | Dựng node schedule + HTTP + Telegram, nối dây, để Inactive chờ bạn duyệt |
| 🔧 Sửa & mở rộng | “Thêm bước lưu Google Sheets vào workflow X” | Chèn node, map dữ liệu, giữ nguyên phần đang chạy tốt |
| ✅ Soát lỗi trước khi chạy | “Validate workflow Y xem có gì sai không” | Kiểm tra cấu hình từng node, dây nối, expression — báo lỗi kèm cách sửa |
| 📚 Tra cứu node | “Node nào đăng được TikTok? Cấu hình sao?” | Tra tài liệu 500+ node và template cộng đồng, trả lời kèm ví dụ cấu hình |
| ▶️ Chạy & theo dõi | “Chạy thử workflow Z rồi cho tôi xem kết quả” | Kích hoạt chạy thử, đọc kết quả từng node, tóm tắt cho bạn |
Gặp thật trên hosting VN: tường lửa (WAF) chặn vì "người gọi lạ". Kiểm tra key còn hạn trong Settings → n8n API; nếu key đúng mà vẫn 403, hỏi nhà cung cấp hosting mở whitelist API — hoặc thử lại sau vài phút.
Key sai, thiếu ký tự khi copy, hoặc đã bị xoá. Tạo key mới, copy bằng nút copy (đừng bôi đen tay), cấu hình lại.
N8N_API_URL phải là gốc: https://n8n-cua-ban.com — không thêm /api/v1, không dấu / cuối, không quên https. Sai 1 trong 3 kiểu trên đều ra lỗi kết nối.
Thiếu cmd /c trước npx — Windows không tự chạy npx trong nền được. Dùng đúng lệnh/cấu hình Windows ở Phần 4 (đã có sẵn cmd /c).
npx đang tải gói n8n-mcp (vài chục MB) — mạng chậm mất 1–3 phút, nhìn như treo. Kiên nhẫn đúng 1 lần đầu; các lần sau mở là chạy ngay.
App chưa thật sự khởi động lại, hoặc JSON hỏng dấu phẩy. Quit hẳn từ khay đồng hồ rồi mở lại; soát JSON tại jsonlint.com.
Chuyện thật: khi dọn 92 workflow cho Kho, tôi quét ra hơn 3.200 thông tin nhạy cảm nằm thẳng trong file JSON — key OpenAI, token Facebook Page, token Google — do thói quen dán key trực tiếp vào node. Ai tải file đó về là cầm được chìa khoá thật. Đừng lặp lại.
Trong n8n, mọi key/token phải lưu ở mục Credentials — n8n mã hoá và không xuất ra khi bạn share file workflow. Dán thẳng key vào ô tham số của node = xuất file là lộ.
Key cho Claude đặt nhãn claude-mcp, key cho việc khác tạo cái khác. Lỡ lộ cái nào, xoá đúng cái đó — không phải đổi cả loạt.
Mở file JSON bằng Notepad, Ctrl+F tìm eyJ, sk-, EAA, AIza — thấy chuỗi dài lạ là có key sống trong đó. (Kho 92 workflow của tôi đã được quét sạch kiểu này 2 lượt.)
Settings → n8n API → xoá key cũ → tạo key mới → cập nhật lại cấu hình Claude. Mất 2 phút, an toàn tuyệt đối. Key API không phải mật khẩu — cứ mạnh dạn xoay.
Trang tiếp theo: quy trình 5 bước + 6 mẫu lệnh để Claude tự xây workflow, tự chạy thử, tự sửa lỗi — bạn chỉ duyệt.