MCP trong n8n: AI Agent gọi công cụ bên ngoài | RevidAPI

MCP trong n8n cho phép AI Agent dùng MCP Client Tool gọi công cụ trên MCP server; để đọc Excel, server phải truy cập được tệp và tài khoản kết nối phải có quyền đọc. Giả sử bạn cần hỏi bảng đơn hàng Excel xem những dòng nào chưa có mã vận đơn. Kết nối MCP thành công chưa đủ để agent trả lời đúng: công cụ do server cung cấp phải đọc được bảng đơn hàng đó, và bạn cần kiểm tra câu trả lời với dữ liệu gốc. Bài viết sẽ giúp bạn xác nhận điều kiện truy cập, dựng workflow trong n8n, chạy một yêu cầu đọc bảng rồi đối chiếu các dòng được trả về với tệp Excel. Nếu server không có công cụ phù hợp, bạn sẽ biết cần kiểm tra ở đâu trước khi sửa câu hỏi gửi cho agent.

Tóm tắt nhanh

• MCP Client Tool là node tích hợp sẵn trong n8n để agent gọi công cụ từ MCP server bên ngoài.
• Đọc Excel chỉ khả thi khi công cụ trên server truy cập được đúng tệp và tài khoản kết nối có quyền đọc.
• Khi chạy thử, hãy đối chiếu dòng và cột agent nêu với bảng Excel gốc, thay vì chỉ dựa vào câu trả lời.

Bạn hỏi AI Agent trong n8n: “Đơn hàng nào trong bảng Excel đang chờ giao?”. Agent không tự mở tệp trên máy bạn. Nó chỉ có thể lấy dữ liệu qua một công cụ mà workflow cho phép gọi; nếu dùng MCP, công cụ đó phải được MCP server cung cấp.

Ba vai trò trong một lượt gọi AI Agent nhận câu hỏi và quyết định có gọi công cụ hay không. MCP Client Tool là node tích hợp sẵn

của n8n, được gắn làm tool cho agent để kết nối tới MCP server bên ngoài. MCP server công bố các công cụ và thực thi lời gọi ở phía có quyền truy cập dữ liệu. MCP là giao thức để client và server trao đổi thông tin về công cụ cùng lời gọi, không phải một chức năng tự quét ổ đĩa hay tự hiểu mọi tệp `.xlsx`. Với ví dụ đơn hàng, luồng đi theo thứ tự: agent nhận yêu cầu → MCP Client Tool chuyển lời gọi → công cụ trên server truy cập bảng Excel → kết quả quay về agent để soạn câu trả lời. Muốn luồng này hoạt động, server phải thực sự có công cụ đọc nguồn chứa bảng và tài khoản mà công cụ dùng phải có quyền với nguồn đó. Chỉ thêm MCP Client Tool vào workflow không tạo ra quyền đọc tệp.

Node tích hợp sẵn khác gì community node?

Tài liệu n8n mô tả MCP Client Tool là node tích hợp sẵn; phần cấu hình

của node có tham số `SSE Endpoint` và các lựa chọn xác thực như Bearer, header, nhiều header hoặc OAuth2. Các mục này nói về cách client liên lạc với server, không nói rằng server đã có công cụ đọc Excel. Một số hướng dẫn trên mạng bắt đầu bằng việc cài community node rồi cấu hình môi trường và kết nối server. Đó là một lộ trình triển khai khác, không phải điều kiện bắt buộc để dùng MCP Client Tool tích hợp sẵn. Khi đọc hướng dẫn, bạn nên kiểm tra chính xác tên node được dùng: nếu là community node, màn hình cấu hình có thể không khớp với MCP Client Tool trong tài liệu n8n.

Agent chọn công cụ dựa vào đâu? Agent dựa vào câu hỏi

của bạn cùng tên, mô tả và đầu vào mà server công bố cho từng công cụ. Nếu một công cụ nhận mã đơn còn công cụ khác nhận tên khách, yêu cầu có mã đơn sẽ cho agent căn cứ rõ hơn để chọn. Trường hợp hai công cụ được mô tả gần giống nhau, agent có thể chọn sai hoặc gửi đầu vào không phù hợp; đừng xem việc “có công cụ” là bảo đảm câu trả lời đúng.

Excel nằm ở phía nào?

Giả sử tệp Excel lưu trên một ổ dùng chung nhưng MCP server chỉ công bố công cụ tra cứu cơ sở dữ liệu. Thêm MCP Client Tool vào agent không tự tạo ra công cụ đọc tệp Excel trên ổ đó. Muốn agent trả lời từ bảng tính, phía server phải cung cấp công cụ truy cập

được tệp hoặc nguồn dữ liệu chứa các dòng

của bảng, đồng thời tài khoản dùng cho công cụ phải có quyền đọc. Câu hỏi “đơn của Lan” cũng cần đủ rõ để phân biệt các dòng trùng tên, chẳng hạn thêm mã đơn hoặc ngày đặt hàng; kết quả công cụ trả về vẫn cần được hiểu theo những trường thực sự có trong dữ liệu.

Kiểm tra kết nối trước khi đặt câu hỏi Ở bước 1, thử công cụ đọc dữ liệu ngay phía server bằng chính nguồn chứa `don-hang-mau.xlsx`, nếu môi trường

của bạn cho phép. Tệp nằm trên laptop không có nghĩa server chạy ở máy khác cũng nhìn thấy nó. Nếu server chỉ hỗ trợ đọc từ một dịch vụ lưu trữ, hãy đặt tệp ở nguồn đó và cấp quyền cho tài khoản mà công cụ sử dụng; tên công cụ và cách truyền đường dẫn phụ thuộc server bạn chọn. Với bước 3, tài liệu n8n liệt kê `SSE Endpoint` và các lựa chọn xác thực như Bearer, header, nhiều header hoặc OAuth2. Dùng URL endpoint và phương thức mà server thực sự cung cấp. Sau khi nối tool ở bước 4, thử yêu cầu: “Đọc sheet `DonHang` trong `don-hang-mau.xlsx`, phạm vi `A1:D5`. Trả về các cột `Ma_don`, `Ngay`, `Trang_thai`, `Tong_tien`; với mỗi dòng, ghi kèm số dòng Excel. Nếu không truy cập được tệp, báo lỗi thay vì đoán dữ liệu.” Ở bước 5, mở chi tiết lần chạy để xem có lời gọi MCP Client Tool và phản hồi từ công cụ hay không. So `A2:D5` với câu trả lời, nhất là `Tong_tien` và số dòng. Nếu không có lời gọi công cụ, câu trả lời của model chưa chứng minh được nó đã đọc bảng; nếu có lời gọi nhưng dữ liệu lệch, kiểm tra lại sheet và phạm vi đã gửi.

Agent có thể trả lời trôi chảy nhưng vẫn chưa đọc được một ô nào trong Excel. Trường hợp đầu tiên cần loại trừ: MCP server không công bố công cụ đọc đúng nguồn chứa tệp. Đổi prompt từ “đọc bảng” sang “phân tích bảng” không tạo thêm quyền hay công cụ cho server.

Kiểm tra lỗi từ phía nào?

Nếu agent không thấy công cụ, hãy xem trạng thái kết nối MCP Client Tool, thông tin xác thực và danh sách công cụ server trả về. Tài liệu n8n nêu các lựa chọn xác thực Bearer, header, nhiều header và OAuth2; chọn sai cách có thể khiến yêu cầu bị từ chối trước khi chạm tới tệp. Nếu đã thấy công cụ nhưng không lấy

được dữ liệu, kiểm tra tài khoản mà server dùng có quyền đọc đúng tệp và phản hồi lỗi

của lần gọi công cụ. Chỉ sửa prompt

sau khi xác nhận công cụ thực sự chạy được. Mục cấu hình SSE Endpoint xuất hiện trong tài liệu MCP Client Tool được cung cấp, nhưng giao diện và cách kết nối bạn thấy có thể phụ thuộc phiên bản n8n đang chạy. Trước khi nhập endpoint hoặc thiết lập xác thực theo một ảnh hướng dẫn, đối chiếu tài liệu với phiên bản trên hệ thống của bạn; chúng tôi chưa xác nhận một cấu hình dùng được cho mọi phiên bản.

Dữ liệu và chi phí cần chặn ở đâu?

Với bảng đơn hàng có số điện thoại, hãy chỉ đưa các cột cần hỏi sang model và kiểm tra dữ liệu nào

được gửi tiếp qua công cụ MCP tới dịch vụ bên ngoài. Chi phí cũng cần tính riêng: lượt gọi model, máy chủ chạy MCP và dịch vụ mà công cụ truy cập. Không có một mức giá chung cho việc “đọc Excel qua MCP”; hãy xem bảng giá

của từng bên trước khi chạy bảng thật.

Shop online: rà đơn cần nhân viên xử lý Một shop bán hàng qua Facebook xuất bảng Excel cuối ngày với các cột `ma_don`, `trang_thai_thanh_toan`, `ngay_hen_giao`, `tinh_trang_xac_nhan` và `ma_dong`. Trước khi cho AI Agent xử lý, shop thay tên, số điện thoại và địa chỉ bằng mã nội bộ; bản đưa vào luồng chỉ giữ các trường cần để lọc. Nhân viên đặt yêu cầu: “Liệt kê đơn đã thanh toán, hẹn giao hôm nay nhưng chưa xác nhận đóng gói; trả về mã đơn và mã dòng.” Trong n8n, agent dùng MCP Client Tool gọi công cụ đọc dữ liệu mà MCP server cung cấp, rồi trả danh sách để nhân viên mở bảng gốc kiểm tra. Muốn làm

được việc này với Excel, server phải có công cụ truy cập bảng và tài khoản kết nối phải có quyền đọc; MCP Client Tool không tự đọc tệp. Với mỗi mục, đầu ra nên giữ `ma_don`, `ma_dong` và giá trị

của ba cột đã dùng để lọc, thay vì chỉ ghi “đơn cần xử lý”. Nhân viên có thể tìm lại đúng dòng, xác nhận tình trạng mới nhất rồi mới liên hệ khách. Nếu bảng thường xuyên được sắp xếp lại, dùng `ma_dong` cố định hoặc `ma_don` làm tham chiếu; số hàng Excel có thể đổi.

Nhóm marketing: tìm ô trống trong lịch đăng Một agency quản lý lịch đăng cho nhiều khách hàng bằng bảng gồm `ngay_dang`, `kenh`, `chu_de`, `nguoi_phu_trach` và `nguon_noi_dung`. Trưởng nhóm yêu cầu agent tìm các mục dự kiến đăng trong tuần nhưng ô `nguoi_phu_trach` còn trống. Danh sách trả về gồm ngày đăng, kênh, chủ đề và mã dòng, để nhóm biết mục nào cần phân công thay vì đọc toàn bộ lịch. Trước khi chuyển danh sách cho biên tập, trưởng nhóm đối chiếu `nguon_noi_dung` ở từng dòng: mục ghi “brief khách hàng” cần kiểm tra brief, còn mục ghi “bài cũ” cần xác nhận quyền dùng lại. Ô nguồn bỏ trống phải

được gắn cờ, không để agent tự đoán xuất xứ từ `chu_de`. Nhờ mã dòng đi kèm, người nhận mở được đúng mục trong bảng và điền người phụ trách

sau khi kiểm tra nguồn.

Một bảng Excel có cột số điện thoại không cần đi nguyên vẹn sang API chỉ để soạn lời nhắc xử lý đơn hàng. Sau khi AI Agent nhận kết quả từ MCP server, bạn nên tách phần cần dùng, chẳng hạn mã đơn và trạng thái, rồi mới chuyển sang HTTP Request. MCP Client Tool phục vụ lời gọi công cụ của agent; endpoint RevidAPI ở bước này là API HTTP riêng, không phải công cụ MCP có sẵn.

Chốt dữ liệu trước khi gửi Chạy thử agent và mở output thực tế

của bước trả kết quả MCP. Thêm node Edit Fields sau bước đó để tạo trường `summary` từ đúng các cột cần gửi; bỏ tên khách, số điện thoại và địa chỉ nếu tác vụ không cần chúng. Ví dụ, `summary` có thể là chuỗi “Đơn DH102: thiếu xác nhận thanh toán”; đây là dữ liệu minh họa, không phải tên trường mặc định của MCP server. Nếu output là văn bản thay vì từng cột, bạn phải kiểm tra và tách nội dung trước khi chuyển tiếp, không đoán đường dẫn JSON.

Gọi API bằng HTTP Request Trong HTTP Request, chọn `POST`, nhập `https://revidapi.com/v1/chat/completions`, thêm header `x-api-key` với API key lấy tại dashboard RevidAPI. Đặt body JSON gồm `model` và `messages`; trường `content` nhận giá trị `summary`

của item hiện tại bằng expression n8n `{{ $json.summary }}`. Để kiểm tra endpoint và cấu trúc payload độc lập với workflow, bạn có thể thử yêu cầu tương đương:

curl -X POST 'https://revidapi.com/v1/chat/completions' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Đề xuất bước xử lý cho đơn DH102: thiếu xác nhận thanh toán"}]}'

Trong n8n, đặt cùng nội dung ấy bằng expression thay vì chép cứng mã đơn. Đối chiếu `summary` ngay trước HTTP Request và phản hồi API sau khi chạy để phát hiện trường rỗng hoặc dữ liệu nhạy cảm lọt qua. Bạn có thể tham khảo hub workflow n8n và tài liệu RevidAPI; tên model và giá hiện hành xem qua `GET /v1/chat/models`. Chúng tôi chưa đo độ trễ của chuỗi MCP → HTTP Request này.

MCP Client Tool tự đọc Excel không?

Không. MCP Client Tool cho AI Agent trong n8n gọi công cụ do MCP server công bố; để đọc bảng Excel, server phải có công cụ truy cập

được tệp hoặc nguồn chứa bảng đó. Nếu server chỉ cung cấp công cụ tìm kiếm web, đổi prompt cũng không khiến nó đọc được tệp.

Agent cần quyền nào để đọc bảng?

Tài khoản hoặc thông tin xác thực mà công cụ trên server sử dụng phải có quyền đọc đúng tệp hay nguồn dữ liệu. Chẳng hạn, nếu bảng nằm trong thư mục chỉ cấp quyền cho nhóm kế toán, hãy kiểm tra quyền

của tài khoản kết nối tới thư mục đó trước khi chạy agent.

Không thấy công cụ trong n8n thì kiểm tra gì? Kiểm tra `SSE Endpoint`

của MCP Client Tool, thông tin xác thực và danh sách công cụ mà server thực sự công bố. Node hỗ trợ các cách xác thực như Bearer, header và OAuth2; hãy dùng cách server yêu cầu, rồi kiểm tra kết nối trước khi sửa câu lệnh cho agent.

RevidAPI có phải MCP server mặc định không? Không. Nếu workflow cần gọi một API RevidAPI

sau khi lấy dữ liệu qua MCP, hãy dùng node HTTP Request trong n8n; đừng điền địa chỉ API vào `SSE Endpoint` rồi chờ công cụ xuất hiện.

Tìm workflow và API key ở đâu? Bạn có thể tìm ví dụ tại hub workflow n8n

của RevidAPI. Lấy API key trong dashboard và đối chiếu cách xác thực, payload với tài liệu API RevidAPI trước khi cấu hình HTTP Request.

Khám phá workflow miễn phí tại AI Tạo ảnh & Video và lấy API key tại API Marketplace RevidAPI.