Tools & MCP – Trung tâm công cụ và máy chủ MCP để mở rộng năng lực AI Agent
Module Tool MCP•Giải pháp AI Automation

Tools & MCP – Trung tâm công cụ và máy chủ MCP để mở rộng năng lực AI Agent

Tools & MCP là trung tâm quản lý công cụ của RedAI: khai báo tool từ OpenAPI, kết nối máy chủ MCP từ xa, xuất bản MCP Server kèm API key và gắn năng lực vào Kỹ năng cho AI Agent sử dụng.

Một AI Agent chỉ trả lời được đúng bằng những gì nó được phép làm. Muốn nhân viên AI tra cứu tồn kho thật, đẩy đơn vị vận chuyển, kiểm tra voucher hay gọi một hệ thống nội bộ, đều cần một "đường ống" nối từ ngôn ngữ tự nhiên tới hệ thống thật. Nếu mỗi năng lực đó phải được viết tay, kiểm thử tay và bàn giao tay, chi phí triển khai sẽ cao hơn nhiều lần giá trị thu được.

Tools & MCP là trung tâm quản lý công cụ của nền tảng RedAI – nơi khai báo công cụ API, kết nối máy chủ MCP từ xa, xuất bản máy chủ MCP để dùng chung với các phần mềm khác, và quản lý toàn bộ vòng đời của những năng lực đó. Theo mô tả chính thức của module, đây là trung tâm quản lý các công cụ tích hợp (Built-in Tools) và các tích hợp Model Context Protocol (MCP) mở, giúp mở rộng năng lực của AI Agent: duyệt web, thực thi mã, truy vấn cơ sở dữ liệu và các thao tác qua API.

Bài viết này đi qua sáu câu hỏi: Tools & MCP là gì, vì sao AI Agent cần một trung tâm công cụ, mô hình vận hành của nó, một công cụ được định nghĩa ra sao, quy trình xuất bản và kiểm toán thế nào, và cuối cùng là cách đưa mọi thứ vào Kỹ năng để AI Agent thực sự dùng được.

1. Tools & MCP là gì?

Tools & MCP là trung tâm quản lý công cụ của RedAI – nơi khai báo, kết nối, kiểm soát và xuất bản các năng lực thực thi để AI Agent có thể hành động trên hệ thống thật.

Nguồn gốc của module nằm ở một khoảng cách quen thuộc trong cách xây AI Agent. Kỹ năng (Skill) và tài liệu (Docs) giúp Agent biết "nên làm gì", nhưng phần "làm" – gọi API, đọc ghi dữ liệu, chạy một hệ thống bên ngoài – lại nằm ngoài nền tảng và phải được nối vào thủ công cho từng Agent. Khi số lượng Agent và số lượng API cùng tăng, phần nối thủ công trở thành nút thắt.

Tools & MCP gom phần "làm" vào một trung tâm quản trị duy nhất, với ba đặc điểm cốt lõi:

  • Một định nghĩa chuẩn cho mọi công cụ. Mỗi tool được mô tả bằng contract rõ ràng: tên, mô tả, phương thức HTTP, endpoint, Base URLs, Input Schema và Output Schema – đúng những thông tin AI Agent cần để gọi chính xác thay vì đoán.

  • Hai chiều kết nối thay vì một chiều. Bạn có thể kết nối vào các MCP Server từ xa để lấy công cụ, đồng thời xuất bản năng lực của chính RedAI thành MCP Server để các MCP client khác – ví dụ Claude Desktop hay Codex CLI – sử dụng.

  • Quản trị được sau khi đã dùng. Lịch sử gọi tool, nhật ký gọi MCP với mã trạng thái, độ trễ và traceId, cùng cơ chế quản lý API key theo thời hạn giúp doanh nghiệp biết công cụ nào đang chạy, ai đang gọi và lỗi nào xảy ra.

2. Vì sao AI Agent cần một trung tâm công cụ?

Ba vấn đề lặp đi lại ở mọi đội ngũ đang vận hành AI Agent trên RedAI, và module này giải quyết trực tiếp từng vấn đề.

Một, mỗi Agent lại phải nối API riêng. Hai nhân viên AI cùng cần đọc tồn kho sẽ phải có hai cấu hình gọi API riêng biệt, và khi endpoint thay đổi thì phải sửa ở cả hai nơi. Trong Tools & MCP, công cụ được khai báo một lần theo "Project Schema" (nhóm dự án), quản lý tập trung và gắn vào bất kỳ Kỹ năng nào cần dùng – cập nhật một lần, áp dụng khắp nơi.

Hai, gọi API thủ công tạo rủi ro vận hành. Gửi request bằng tay hoặc bằng script rời rạc khiến khó truy vết, dễ sai định dạng dữ liệu và không có cơ chế thu hồi quyền. Contract chuẩn của tool cùng nhật ký gọi (hành động, mã trạng thái, độ trễ, mã lỗi, API key đã dùng) biến mỗi lượt gọi thành dữ liệu có thể kiểm toán.

Ba, năng lực tốt không chia sẻ được ra ngoài. Đội ngũ đã xây một bộ công cụ hoàn chỉnh cho quy trình nội bộ muốn dùng lại nó trên công cụ khác, nhưng thường phải đóng gói thủ công. Tính năng Xuất bản MCP cho phép đóng gói toàn bộ công cụ, kịch bản và tài liệu của một Kỹ năng – hoặc các công cụ tích hợp của một Project Schema – thành một máy chủ MCP độc lập, phát hành bằng API key có thể cấp hạn dùng.

Dẫn chứng thực tế: một đội vận hành xây bộ công cụ API tra cứu đơn hàng và tồn kho từ đặc tả OpenAPI, đóng gói thành một Kỹ năng "Agent Chăm sóc Đơn Hàng". Khi cần dùng ở phần mềm khác, nhóm này xuất bản chính Kỹ năng đó thành MCP Server, cấp API key riêng cho từng client, và theo dõi nhật ký để biết ứng dụng nào đang gọi và gặp lỗi ở đâu.

3. Tools & MCP vận hành theo mô hình nào?

Module được chia thành ba khu vực vận hành tách biệt nhưng liền mạch:

Khu vực

Dùng để làm gì

Đối tượng chính

Tích hợp Tools (External)

Khai báo và quản lý các bộ công cụ API theo nhóm dự án: định nghĩa contract, xem thông số, sửa endpoint, cập nhật xác thực, theo dõi lịch sử sử dụng

Đội kỹ thuật, người quản trị hệ thống tích hợp

Máy chủ MCP

Kết nối tới MCP Server từ xa bằng URL và Header, xem số lượng công cụ mỗi máy chủ cung cấp, chỉnh sửa hoặc gỡ kết nối

Người tích hợp hệ sinh thái công cụ MCP

Xuất bản MCP

Tạo và phát hành MCP Server từ Skill hoặc Project Schema, quản lý API key, cấu hình cho MCP client, theo dõi lịch sử gọi

Người phát hành năng lực ra bên ngoài, quản trị viên

Bên cạnh đó, các tài nguyên được quản trị ở đây không nằm lại trong module mà được đưa vào Kỹ năng để AI Agent dùng. Trang Chi tiết Kỹ năng có ba tab tài nguyên thực thi:

  • Tools – danh sách công cụ API theo nhóm dự án (Project Schema), hỗ trợ cài đặt Phân quyền tính năng (Capability Tag) và mở trang ứng dụng gốc.

  • MCPs – danh sách máy chủ MCP kết nối vào Kỹ năng.

  • Workflows – danh sách kịch bản tự động hóa đa bước.

Nói cách khác: Tools & MCP là nơi sản xuất và kiểm soát năng lực; Kỹ năng là nơi gắn năng lực đó vào một AI Agent cụ thể. Đây là ranh giới quan trọng, vì nó giải quyết đúng vấn đề ở mục 2: một công cụ được quản trị một lần nhưng áp dụng được cho nhiều Agent.

4. Một công cụ API được định nghĩa như thế nào?

Điểm khác biệt cốt lõi của một tool trên RedAI là contract – một bộ mô tả chuẩn gồm tên, mô tả, phương thức HTTP, phiên bản, trạng thái mặc định, endpoint, Base URLs cùng Input Schema và Output Schema. Đây chính là thứ giúp AI Agent gọi đúng API và hiểu đúng cấu trúc dữ liệu trả về, thay vì đoán mò.

Có ba cách khai báo công cụ, tùy vào nguồn đặc tả sẵn có:

Cách

Dùng khi

Điều kiện

Upload File

Tải đặc tả OpenAPI từ tệp có sẵn

Có tệp OpenAPI JSON trên máy

Paste JSON Code

Nhập trực tiếp nội dung đặc tả vào giao diện

Có nội dung OpenAPI ở định dạng JSON

Tạo bằng form

Khai báo từng tool bằng giao diện, không cần file

Nhập Tên tool, HTTP Method, Endpoint path, Mô tả, Input schema, Output schema, Input example, Output example

Các nhóm công cụ được phân biệt theo phạm vi sở hữu: Cá nhân (do bạn tạo), Hệ thống (do nền tảng cung cấp) và Cộng đồng (được chia sẻ từ cộng đồng). Danh sách tích hợp còn hỗ trợ lọc theo thẻ, tìm kiếm theo tên và – điểm đáng chú ý – mở Graph RAG Explorer để xem cấu trúc dạng đồ thị mạng lưới của các tool trong một tích hợp, thay vì chỉ đọc danh sách dạng bảng.

Ngoài việc khai báo, toàn bộ bộ công cụ còn có các công cụ quản trị cấu hình chung: xuất đặc tả OpenAPI JSON để dùng lại, cấu hình biến môi trường dạng {{KEY}} cho các Base URL khác nhau, và cài đặt project để quản lý tên, mô tả, phân loại, Base URLs cùng cấu hình xác thực. Riêng với từng tool, người quản trị có thể xem lại contract, sửa thông số, cập nhật URL gốc (hỗ trợ thêm nhiều URL để dự phòng hoặc cân bằng tải) và cập nhật loại xác thực.

Phân biệt phạm vi – điểm dễ nhầm nhất: Cài đặt project cập nhật cấu hình chung cho cả bộ công cụ tích hợp; còn các thao tác trên từng tool chỉ áp dụng cho tool đang chọn. Một thay đổi ở đúng nhầm chỗ có thể ảnh hưởng tới toàn bộ bộ công cụ.

5. Kết nối máy chủ MCP mang lại điều gì?

Nếu hệ sinh thái công cụ bạn cần đã có MCP Server, bạn không cần viết lại đặc tả cho từng API. Một kết nối Remote MCP Server trên RedAI chỉ cần có tên server, mô tả, URL (ví dụ https://example.com/mcp) và các Header xác thực nếu cần – trong đó chỉ những Header có đầy đủ key và value mới được gửi đi; với Bearer Token, nhập key Authorization và value Bearer <token>.

Sau khi kết nối, hệ thống tự khám phá các công cụ mà máy chủ cung cấp, và danh sách hiển thị số lượng công cụ tương ứng – bạn có thể làm mới để cập nhật khi máy chủ thay đổi. Từ đây, các tool đó đã sẵn sàng để gắn vào Kỹ năng cho AI Agent sử dụng.

Ba lưu ý vận hành đáng nhớ:

  • Xóa máy chủ có hậu quả thật. Việc xóa một MCP Server sẽ ngừng cấp toàn bộ công cụ trực thuộc cho các AI Agent đang gọi máy chủ này trong kịch bản và phiên hội thoại.

  • Có thể chỉnh sửa thay vì xóa. Tên server, mô tả, URL và Header đều cập nhật được, nên nhiều khi chỉ cần sửa cấu hình kết nối.

  • Có thể tạm dừng thay vì xóa. Trong khu vực Xuất bản MCP, thao tác Lưu trữ đưa máy chủ về trạng thái tạm ngưng phục vụ các kết nối, thay vì xóa vĩnh viễn.

6. Xuất bản MCP Server để dùng chung ra sao?

Đây là chiều ngược lại: đưa năng lực của RedAI ra cho phần mềm khác sử dụng. Có hai nguồn xuất bản:

Nguồn

Phù hợp khi

Xuất bản từ Skill

Muốn đóng gói toàn bộ công cụ, kịch bản (Flows) và tài liệu tri thức (Docs) của một Kỹ năng thành máy chủ MCP

Xuất bản từ Project Schema

Muốn xuất bản trực tiếp các công cụ tích hợp (API Tools) đã định nghĩa trong Tools & MCP thành MCP Server độc lập

Khi tạo server, bạn chọn loại nguồn và đối tượng cụ thể, đặt tên và mô tả (để trống thì hệ thống tự lấy theo nguồn), tùy chọn đặt hạn dùng cho API key đầu tiên, và chọn trạng thái khởi tạo là Bản nháp hoặc Xuất bản ngay sau khi tạo. Hệ thống cũng có thể tự sinh API key đi kèm ngay khi tạo server.

Để phần mềm bên ngoài kết nối được, tab Cấu hình sử dụng cung cấp sẵn bốn dạng cấu hình theo loại client:

Loại client

Dạng cấu hình

Codex CLI

Lệnh terminal codex mcp add...

Claude Code / Desktop MCP JSON

Đoạn cấu hình JSON cho tệp claude_desktop_config.json

Generic MCP remote server

Cấu hình HTTP endpoint tiêu chuẩn cho các client hỗ trợ MCP từ xa

NPX bridge MCP JSON

Cấu hình dùng cầu nối @redonvn/redai-mcp-bridge cho các client yêu cầu stdio cục bộ

Người dùng chỉ cần chọn đúng loại client, sao chép cấu hình và dán vào phần mềm đích, thay placeholder <YOUR_DYNAMIC_MCP_API_KEY> bằng API key thật của server.

Cảnh báo bảo mật: API key dùng để xác thực và cấp quyền gọi các công cụ của MCP Server. Tuyệt đối không chia sẻ API key công khai, không đưa vào mã nguồn mở hoặc trao đổi qua kênh không bảo mật.

7. Quản trị và kiểm toán: vòng đời server, API key, nhật ký

Một máy chủ MCP đã xuất bản có vòng đời rõ ràng: Bản nháp → Đã publish → Lưu trữ → Xóa vĩnh viễn. Tùy trạng thái, các lệnh sẵn có khác nhau – chỉ server đang ở Bản nháp hoặc Lưu trữ mới xuất bản được; chỉ server đã Lưu trữ mới xóa vĩnh viễn được (kèm toàn bộ API key trực thuộc). Có thể đánh dấu chọn nhiều server để xóa nhanh cùng lúc.

API key được quản lý theo vòng đời riêng: tạo khóa mới kèm tên và thời hạn, sao chép khóa khi cấu hình cho client, và thu hồi bất kỳ lúc nào. Cách làm này cho phép cấp khóa riêng cho từng người dùng hoặc từng môi trường – một nguyên tắc tốt khi máy chủ được dùng bởi nhiều hệ thống khác nhau. Trước khi thu hồi hoặc xóa một khóa, cần cập nhật khóa mới vào cấu hình của các client liên quan để tránh làm gián đoạn các phiên làm việc đang chạy.

Nhật ký gọi (Audit Logs) là lớp minh bạch cuối cùng. Mỗi lượt gọi đều được ghi lại với hành động kèm mã traceId, mã trạng thái (ví dụ 200, 401, 500), độ trễ tính bằng ms, mã lỗi nếu có, mã API key đã sử dụng và thời gian cập nhật. Bạn có thể tìm kiếm nhật ký theo hành động hoặc traceId, và lọc theo trạng thái Tất cả / Thành công (2xx) / Lỗi (4xx/5xx) để thu hẹp đúng nhóm request cần xử lý.

Với những tích hợp nội bộ, tab Lịch sử sử dụng tool trong phần Chi tiết ứng dụng cũng cho bức tranh tương tự theo hướng AI Agent: Agent nào đã gọi, tool nào, số lần, thời gian, người dùng và kết quả Thành công hay Lỗi.

8. Đưa năng lực vào Kỹ năng để AI Agent dùng được

Đây là bước quyết định năng lực có thực sự được AI Agent sử dụng hay không. Tại Trang chủ > Skill > Chi tiết, ba tab Tools, MCPs, Workflows có luồng liên kết đồng nhất: chọn tài nguyên cần dùng từ danh sách (theo nhóm dự án, theo từ khóa, hoặc chọn tất cả), xác nhận, và tài nguyên xuất hiện trong tab tương ứng kèm bộ đếm cập nhật chính xác.

Phân quyền tính năng (Capability Tag) là cơ chế quản lý quyền gọi ở cấp độ từng công cụ. Khi một Kỹ năng gắn nhiều tool – ví dụ tạo đơn, tạo mã QR, đẩy vận đơn, kiểm tra voucher – bạn có thể gán cho mỗi tool một mã quyền để hệ thống tự động lọc công cụ theo tính năng mà ứng dụng đang bật:

  • Dùng chung (Toàn quyền) – Agent luôn có quyền gọi tool này (hệ thống gắn nhãn core).

  • Quyền chuyên biệt – gán mã tính năng cụ thể, ví dụ business.order, business.qr, business.shipping, business.voucher.

Bước cuối cùng là định tuyến: trong nội dung Skill, gõ ký tự @ để chọn công cụ vừa gắn và viết quy tắc hướng dẫn AI Agent gọi đúng công cụ theo từng tình huống.

Toàn bộ quy trình này – gắn/gỡ tài nguyên, cấu hình Capability Tag – cũng có thể thực hiện bằng ngôn ngữ tự nhiên qua trợ lý ảo AI Agent với Kỹ năng RedAI - Module - Skill, giúp đội ngũ nhiều người tuân thủ cùng một quy trình vận hành.

9. So sánh với cách gọi API thủ công

Tiêu chí

Gọi API thủ công bằng script hoặc tích hợp rời

Dán đặc tả OpenAPI vào từng Agent

Tools & MCP trên RedAI

Định nghĩa công cụ

Nằm rải rác trong code của từng Agent

Phải khai báo lại cho từng Agent

Khai báo một lần theo Project Schema, quản lý tập trung

Mô tả cho AI Agent

Agent phải đoán hoặc được dạy thủ công

Phụ thuộc chất lượng prompt

Contract chuẩn: Input/Output Schema, mô tả, phương thức, endpoint

Quản lý quyền gọi

Theo logic riêng của từng Agent

Không thống nhất

Phân quyền tính năng (Capability Tag) và lọc công cụ thích ứng

Kết nối hệ sinh thái MCP

Phải tự cài đặt client

Không hỗ trợ

Kết nối MCP Server từ xa và xuất bản MCP Server của RedAI

Truy vết lượt gọi

Không có lịch sử tập trung

Không có lịch sử tập trung

Lịch sử sử dụng tool và nhật ký MCP với traceId, mã trạng thái, độ trễ

Quản lý bí mật xác thực

Rải rác trong biến môi trường, dễ lộ

Phải tự làm

API key có tên, hạn dùng, thu hồi được; biến môi trường {{KEY}} cho Base URL

Khả năng mở rộng

Tăng chi phí bảo trì theo số Agent

Nhân đôi công việc khai báo

Cập nhật một lần, áp dụng cho mọi Kỹ năng và Agent liên quan

10. Tools & MCP dành cho ai?

Đội ngũ kỹ thuật nội bộ. Khi doanh nghiệp có sẵn API của hệ thống đơn hàng, CRM hay kho, đội kỹ thuật cần một cách duy nhất để biến các API đó thành công cụ mà Agent gọi được, kèm contract rõ ràng và cơ chế đổi cấu hình tập trung.

Tích hợp viên và đối tác triển khai. Khi triển khai AI Agent cho khách hàng, các MCP Server có sẵn từ hệ sinh thái công cụ phổ biến giúp mở rộng năng lực nhanh mà không phải viết lại từng API tool.

Đội ngũ quản trị hệ thống và bảo mật. Quản lý API key theo thời hạn, thu hồi khóa, nhật ký gọi và phân quyền tính năng giúp kiểm soát "ai được gọi gì" ở cấp độ Workspace.

Nhóm xây dựng sản phẩm dùng chung. Khi đã có một bộ công cụ hoàn chỉnh trong một Kỹ năng, nhóm có thể xuất bản thành MCP Server để đội khác hoặc phần mềm khác dùng lại mà không phải đóng gói thủ công.

Một tình huống điển hình: chuỗi bán lẻ cần Agent tra cứu tồn kho nội bộ và đối soát đơn hàng. Nhóm tích hợp khai báo hai bộ công cụ từ đặc tả OpenAPI, gắn vào Kỹ năng "Agent Chăm sóc Đơn Hàng" kèm Capability Tag phân biệt chức năng, đồng thời kết nối một MCP Server bên ngoài để bổ sung năng lực. Khi cần đưa năng lực này sang ứng dụng khác, nhóm xuất bản chính Kỹ năng đó thành MCP Server và cấp API key riêng cho từng client.

11. Câu hỏi thường gặp

1. Tools & MCP khác gì với Kho ứng dụng tích hợp?
Trong tài liệu, Kho Ứng dụng và Dịch vụ tích hợp quản lý danh mục nhà cung cấp, các kết nối tài khoản và khóa bí mật của dịch vụ (Facebook, Zalo, LLM, ngân hàng…). Tools & MCP quản lý phần "khả năng thực thi": định nghĩa công cụ API theo OpenAPI, kết nối máy chủ MCP từ xa và xuất bản máy chủ MCP. Hai phần bổ trợ nhau: một kết nối đã có tài khoản sẵn sàng là nền tảng để công cụ gọi được.

2. Tôi có cần viết code để tạo công cụ không?
Không bắt buộc. Bạn có thể khai báo bằng tệp OpenAPI JSON, dán trực tiếp đặc tả, hoặc điền biểu mẫu với tên tool, HTTP Method, Endpoint path, mô tả, Input/Output schema kèm ví dụ vào/ra – không cần viết code.

3. MCP Server và MCP client khác nhau thế nào?
Trong mô hình của RedAI, bạn quản lý phía máy chủ: thêm MCP Server từ xa để lấy công cụ, hoặc xuất bản MCP Server của RedAI. MCP client là phần mềm bên ngoài dùng năng lực đó – Codex CLI, Claude Code/Desktop, generic remote server hoặc client dùng cầu nối NPX bridge.

4. Xóa một MCP Server ảnh hưởng đến ai?
Xóa máy chủ MCP sẽ ngừng cấp toàn bộ công cụ trực thuộc cho các AI Agent đang gọi máy chủ này trong kịch bản và phiên hội thoại. Nếu chỉ muốn tạm ngưng phục vụ, hãy dùng thao tác Lưu trữ thay vì xóa vĩnh viễn.

5. API key của MCP Server có được chia sẻ công khai không?
Không. API key dùng để xác thực và cấp quyền gọi các công cụ của MCP Server. Tài liệu yêu cầu tuyệt đối không chia sẻ API key công khai, không đưa vào mã nguồn mở hoặc trao đổi qua kênh không bảo mật. Bạn có thể đặt thời hạn cho khóa, tạo khóa riêng theo từng client và thu hồi bất kỳ lúc nào.

6. Làm sao biết công cụ nào đang được dùng và lỗi ở đâu?
Tab Lịch sử sử dụng tool cho biết Agent, tên tool, số lần, thời gian, người dùng và trạng thái Thành công/Lỗi. Với máy chủ MCP đã xuất bản, tab Lịch sử ghi lại hành động kèm traceId, mã trạng thái, độ trễ, mã lỗi, API key đã dùng – hỗ trợ tìm kiếm theo traceId và lọc theo trạng thái 2xx hoặc 4xx/5xx.


Biến mọi API thành năng lực mà AI Agent sử dụng được

Một doanh nghiệp không cần nhiều mô hình AI hơn – họ cần nhiều năng lực thực thi hơn, và cần cách quản lý chúng một cách tập trung. Tools & MCP đóng vai trò đó: chuẩn hoá công cụ theo contract, kết nối hệ sinh thái MCP, phát hành năng lực ra bên ngoài, và ghi lại mọi lượt gọi để doanh nghiệp kiểm soát được.

Sẵn sàng trải nghiệm Tools & MCP – Trung tâm công cụ và máy chủ MCP để mở rộng năng lực AI Agent?

Kích hoạt ngay trên nền tảng RedAI với đầy đủ tính năng tự động hóa chuyên sâu.

Trải nghiệm ngay →