Tóm tắt nhanh
- Yêu cầu: n8n phiên bản mới nhất và Claude Desktop App.
- Cơ chế: Sử dụng Model Context Protocol (MCP) để biến n8n thành “tay chân” thực thi tác vụ cho Claude.
- Thiết lập: Bật Instance-Level MCP trong n8n -> Copy URL -> Add Connector trong Claude.
- Lưu ý: Cần cấp quyền “Available in MCP” cho từng workflow cụ thể để đảm bảo bảo mật.
Kết nối các mô hình ngôn ngữ lớn (LLM) với các công cụ tự động hóa đang là xu hướng tất yếu của Engineering hiện đại. Thay vì chỉ chat và nhận văn bản, chúng ta muốn AI thực sự “hành động”. Việc tích hợp n8n MCP Server vào Claude Desktop chính là chìa khóa giải quyết bài toán này.
Tính năng này cho phép Claude truy cập trực tiếp vào instance n8n của bạn, tìm kiếm các workflow có sẵn và thực thi chúng ngay trên giao diện chat. Bạn không cần phải switch tab, không cần cấu hình Webhook phức tạp, mọi thứ diễn ra seamless qua giao thức MCP. Dưới đây là hướng dẫn kỹ thuật chi tiết để bạn thiết lập hệ thống này trong vòng chưa đầy 5 phút.
Tại sao nên dùng n8n MCP với Claude?
Cơ chế MCP (Model Context Protocol) giúp chuẩn hóa cách AI giao tiếp với các hệ thống bên ngoài. Khi kết nối n8n qua giao thức này, bạn đang nâng cấp Claude từ một chatbot thông thường thành một AI Agent có khả năng:
- Trigger Workflow bằng ngôn ngữ tự nhiên: Không cần nhớ ID hay Webhook URL.
- Debug trực tiếp: Yêu cầu Claude chạy thử workflow với dữ liệu mẫu và phân tích output ngay lập tức.
- Quản lý tập trung: Điều phối hàng chục workflow khác nhau từ một giao diện duy nhất.
Bước 1: Cập nhật và kích hoạt MCP trên n8n
Để sử dụng tính năng này, n8n instance của bạn bắt buộc phải ở phiên bản mới nhất. Các phiên bản cũ chưa hỗ trợ native MCP server.
Kiểm tra và cập nhật:
Nếu bạn sử dụng n8n Cloud, hệ thống thường tự động gợi ý cập nhật. Nếu bạn self-host trên VPS (Docker), hãy chạy lệnh pull image mới nhất:
docker pull n8nio/n8n:latest
docker-compose up -dLấy thông tin Server URL:
Sau khi cập nhật thành công, truy cập vào giao diện dashboard của n8n:
- Vào Settings (Cài đặt) ở thanh bên trái.
- Chọn mục Connect hoặc Instance Level MCP (tùy phiên bản hiển thị).
- Tại đây, bạn sẽ thấy một Server URL. Hãy copy chuỗi URL này. Đây là endpoint để Claude giao tiếp với n8n.
TIPS:
Nếu bạn đang chạy n8n trên localhost và muốn Claude Desktop kết nối vào, bạn có thể cần sử dụng
supergatewayhoặc các giải pháp tunneling như ngrok để public port 5678 ra internet, hoặc nếu ae dùng OrbStack thì nó có hỗ trợ domain/IP riêng cho từng container nhé. Tuy nhiên, sử dụng n8n Cloud hoặc VPS có public IP là cách ổn định nhất.
Bước 2: Cấu hình Connector trên Claude Desktop
Claude Desktop hiện đã hỗ trợ add connector trực tiếp qua giao diện mà không cần chỉnh sửa file config JSON thủ công như trước đây.
Thao tác thực hiện:
- Mở Claude Desktop App.
- Truy cập vào Settings -> Connectors.
- Nhấn vào nút + (Add Connector).
- Chọn tab Web.
- Tìm kiếm hoặc chọn icon n8n.
- Paste Server URL bạn vừa copy ở Bước 1 vào ô input.
- Nhấn Continue.
Lúc này, Claude sẽ yêu cầu quyền truy cập vào n8n instance. Một popup hoặc thông báo sẽ hiện ra hỏi bạn có muốn cho phép (Allow) kết nối hay không. Hãy chọn Allow.
Sau khi kết nối thành công, bạn sẽ thấy n8n xuất hiện trong danh sách Active Connectors với trạng thái đèn xanh. Bạn có thể bật/tắt quyền truy cập này bất cứ lúc nào thông qua toggle switch.
Bước 3: Cấp quyền MCP cho Workflow
Mặc định, để đảm bảo an toàn, Claude không thể nhìn thấy toàn bộ workflow trong hệ thống của bạn. Bạn phải expose (công khai) từng workflow cụ thể mà bạn muốn AI điều khiển.
Giả sử tôi có một workflow đơn giản: Nhận dữ liệu từ Form -> Lưu vào Google Sheet.
Cách cấu hình:
- Mở workflow bạn muốn kết nối trong n8n Editor.
- Nhấn vào nút Settings (biểu tượng bánh răng) hoặc menu ở góc phải màn hình editor.
- Tìm tùy chọn Available in MCP.
- Gạt switch sang trạng thái ON.
- Nhấn Save workflow.
Nếu không thực hiện bước này, khi bạn yêu cầu Claude tìm workflow, nó sẽ trả về kết quả rỗng. Đây là cơ chế bảo mật quan trọng để tránh việc AI vô tình kích hoạt các quy trình nhạy cảm (như xóa database hay gửi email hàng loạt).
Bước 4: Thực thi và Debug qua Claude
Bây giờ là lúc chúng ta kiểm chứng sức mạnh của sự kết hợp này. Tôi sẽ demo với workflow “Form to Google Sheet” đã setup ở trên. Workflow này nhận 3 tham số: name, email, và request.
Prompt mẫu cho Claude:
“Search the n8n MCP server for the workflow ‘Form to Sheet’ and execute it using test data: Name=’Test User’, Email=’[email protected]’, Request=’Test submission from Claude’.“
Quá trình xử lý:
- Tool Use: Claude sẽ hiển thị trạng thái đang sử dụng tool
n8nđể tìm kiếm workflow. - Confirmation: Sau khi tìm thấy, Claude sẽ báo cáo lại và xác nhận các tham số input trước khi chạy. Bạn nhấn Allow/Confirm.
- Execution: Claude gửi request tới n8n.
- Output: n8n trả về kết quả thực thi (thường là JSON output của node cuối cùng). Claude sẽ hiển thị kết quả này cho bạn (ví dụ: “Success”, hoặc dữ liệu vừa ghi).
Kiểm tra chéo (Verification):
Để chắc chắn, bạn quay lại n8n, vào tab Executions. Bạn sẽ thấy một lượt chạy mới nhất với status “Success”. Mở chi tiết ra, dữ liệu input đúng là những gì bạn đã nhập trong Claude. Kiểm tra file Google Sheet, dòng dữ liệu mới đã xuất hiện.
TIPS:
Hãy đặt tên Workflow thật rõ ràng và mang tính mô tả (Descriptive Naming). Ví dụ thay vì đặt là
Flow 1, hãy đặt làCreate Jira Ticket from Slack. Điều này giúp Claude tìm kiếm chính xác hơn và hiểu rõ ngữ cảnh sử dụng của workflow đó mà không cần bạn giải thích nhiều.
Một vài lỗi thường gặp
Trong quá trình tích hợp, đôi khi bạn sẽ gặp lỗi. Dưới đây là các vấn đề phổ biến và cách xử lý:
1. Claude báo “No tools found” hoặc không tìm thấy workflow
- Nguyên nhân: Bạn chưa bật tính năng “Available in MCP” trong settings của workflow đó.
- Khắc phục: Vào n8n, mở workflow, bật setting này lên và nhớ Save lại.
2. Lỗi kết nối (Connection Refused/Error)
- Nguyên nhân: URL Server sai hoặc n8n instance bị down/chặn firewall.
- Khắc phục: Kiểm tra lại Server URL. Đảm bảo máy tính chạy Claude Desktop có thể ping được tới server n8n. Nếu dùng Localhost, hãy kiểm tra lại cấu hình network.
3. Dữ liệu đầu ra không đúng định dạng
- Nguyên nhân: Claude gửi JSON input không khớp với schema mà workflow mong đợi.
- Khắc phục: Trong prompt, hãy mô tả rõ cấu trúc JSON mà workflow cần. Hoặc tốt nhất, hãy dùng node “Code” hoặc “Edit Fields” ở đầu workflow để validate và chuẩn hóa dữ liệu đầu vào.
Câu hỏi thường gặp
- Hệ thống này có hoạt động với phiên bản n8n Community (Self-hosted) không?
- Có. Tính năng MCP Server được tích hợp trong core của n8n, nên bản self-hosted (Docker) hoàn toàn sử dụng được, miễn là bạn update lên version mới nhất.
- Tôi có thể kết nối nhiều n8n instance vào một Claude Desktop không?
- Hiện tại cơ chế Connector của Claude cho phép add nhiều nguồn, nhưng việc quản lý context có thể bị chồng chéo nếu bạn không đặt tên rõ ràng. Tốt nhất nên tập trung vào một instance chính hoặc sử dụng các profile khác nhau.
- Dữ liệu truyền qua MCP có được bảo mật không?
- Kết nối MCP là kết nối trực tiếp giữa Claude Client và n8n Server của bạn. Dữ liệu không đi qua server trung gian của bên thứ ba (ngoại trừ hạ tầng của Anthropic khi xử lý prompt). Tuy nhiên, hãy luôn cẩn trọng khi cấp quyền cho các workflow xử lý dữ liệu nhạy cảm.
