Mọi năng lực AI Agent mà doanh nghiệp đã xây dựng – gọi API tra cứu đơn hàng, kiểm tra tồn khoản, duyệt đơn hay chạy quy trình tự động hóa – thường bị giam cất trong Workspace của mình. Nếu muốn dùng lại những năng lực này trên phần mềm khác (như Claude Desktop, Codex CLI hoặc ứng dụng nội bộ), trước giờ bạn phải đóng gói thủ công, viết tài liệu riêng và cố tình nối nối lại từ đầu.
Xuất bản MCP là tính năng trên module Tools & MCP của RedAI, cho phép bạn đóng gói toàn bộ công cụ, kịch bản và tài liệu tri thức 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 (Model Context Protocol Server) độc lập. Sau đó, bạn cấp API key và cung cấp cấu hình cho các MCP client bên ngoài kết nối và sử dụng năng lực của RedAI mà không cần rebuild lại hệ thống.
Bài viết này hướng dẫn bạn từ A đến Z về tính năng Xuất bản MCP: chuẩn bị, 7 bước tạo và xuất bản, quản lý vòng đời server, quản lý API key, cấu hình cho 4 loại MCP client, tra cứu lịch sử gọi và vị trí của tính năng trong hệ sinh thái RedAI. Nội dung được viết để kỹ sư phần mềm và tích hợp viên nắm bắt chi tiết, đồng thời người dùng phổ thông chưa có kiến thức chuyên môn vẫn có thể làm theo từng bước.
1. Xuất bản MCP là gì?
Xuất bản MCP là quy trình đóng gói năng lực có sẵn trong RedAI thành một máy chủ MCP, cho phép các phần mềm bên ngoài kết nối và sử dụng các công cụ, kịch bản và tài liệu tri thức của bạn theo chuẩn Model Context Protocol (MCP).
Nó khác với việc chia sẻ file hoặc gửi tài liệu thủ công ở chỗ: khi xuất bản, RedAI sinh ra một endpoint MCP chuẩn kèm API key. Bên ngoài (máy khách/MCP client) chỉ cần kết nối đến endpoint này và cung cấp API key là có thể gọi được các công cụ mà bạn đã đóng gói – giống như gọi một API thuần túy, nhưng được chuẩn hoá theo giao thức MCP.
Ba đặc điểm cốt lõi:
Hai nguồn xuất bản linh hoạt: Bạn có thể xuất bản từ một Kỹ năng (đóng gói toàn bộ công cụ, kịch bản và tài liệu tri thức của Skill) hoặc từ một Project Schema (xuất bản trực tiếp các công cụ tích hợp API đã định nghĩa trong Tools & MCP).
Quản lý API key tập trung: Tự sinh khóa truy cập, đặt thời hạn sử dụng, sao chép và thu hồi bất kỳ lúc nào.
Cấu hình sẵn cho các máy khách phổ biến: RedAI cung cấp mẫu cấu hình cho Codex CLI, Claude Code/Desktop, Generic MCP remote server và NPX bridge – bạn chỉ cần sao chép và dán.
2. Tại sao cần xuất bản MCP ra bên ngoài?
Có ba vấn đề lặp đi lại khi vận hành AI Agent, và Xuất bản MCP giải quyết trực tiếp từng vấn đề.
Một, năng lực AI Agent bị kẹt trong Workspace. Một Kỹ năng đã được kiểm thử và vận hành tốt trong Workspace của bộ phận A, khi bộ phận B hoặc một ứng dụng khác muốn dùng lại, thường phải cấu hình lại từ đầu. Xuất bản MCP biến Kỹ năng đó thành một endpoint chuẩn mà bất kỳ hệ thống nào hỗ trợ MCP đều có thể kết nối.
Hai, chia sẻ năng lực bằng cách thủ công gây rủi ro. Gửi file tài liệu, hướng dẫn gọi API hoặc script rời rạc cho bên khác khiến khó kiểm soát phiên bản, dễ sai định dạng và không có cơ chế thu hồi quyền. Xuất bản MCP cung cấp API key có thể thu hồi, giúp bạn quản lý ai được phép kết nối.
Ba, mỗi hệ thống cần một cách kết nối riêng. Một ứng dụng dùng Claude Desktop, một công cụ khác dùng Codex CLI, một hệ thống nội bộ dùng generic HTTP endpoint. Xuất bản MCP cung cấp mẫu cấu hình riêng cho từng loại client, giúp bạn không phải viết adapters cho từng hệ thống.
3. Ứng dụng của tính năng và sức mạnh của nó
Đây là phần giải đáp trực tiếp: tính năng Xuất bản MCP được dùng vào đâu, và điểm vượt trội của nó nằm ở đâu.
3.1 Ứng dụng thực tế
Ví dụ thực tế: Một doanh nghiệp logistic đã xây dựng Kỹ năng "Agent Đối soát Đơn Hàng" trong RedAI, chứa công cụ gọi API đơn hàng, kịch bản tự động hóa đối soát và tài liệu tri thức quy trình. Thay vì gửi file hướng dẫn cho đội phát triển ứng dụng vận xuất, họ xuất bản Kỹ năng này thành MCP Server, cấp API key cho đội phát triển. Đội đó cấu hình vào ứng dụng nội bộ và gọi trực tiếp năng lực của RedAI qua endpoint MCP.
3.2 Sức mạnh cốt lõi của tính năng
Sức mạnh của Xuất bản MCP không chỉ ở việc "kết nối được API", mà ở cách RedAI chuẩn hoá, quản trị và khai thác lại những năng lực đó:
Đóng gói toàn diện, không thiếu thành phần: Xuất bản từ Kỹ năng kèm theo toàn bộ công cụ, kịch bản (Flows) và tài liệu tri thức (Docs) của Skill. Xuất bản từ Project Schema đóng gói trực tiếp các công cụ API đã định nghĩa. Bên ngoài nhận được một "hồ sơ có thể chạy", không phải mảnh rời rạc.
Quản lý API key vòng đời đầy đủ: Tự sinh khóa đầu tiên khi tạo server, đặt thời hạn sử dụng, tạo thêm khóa mới, sao chép và thu hồi bất kỳ lúc nào. Giúp bạn kiểm soát "ai được kết nối" và "cho đến khi nào".
Cấu hình sẵn cho các máy khách phổ biến: Hỗ trợ 4 dạng cấu hình: Codex CLI, Claude Code/Desktop JSON, Generic MCP remote server và NPX bridge. Bạn không cần viết documentation kết nối từ đầu.
Theo dõi và kiểm toán sau khi dùng: Tab Lịch sử ghi lại mỗi lượt gọi với hành động kèm traceId, mã trạng thái (200, 401, 500…), độ trễ tính bằng ms, mã lỗi nếu có, mã API key đã dùng và thời gian cập nhật. Hỗ trợ tìm kiếm theo traceId và lọc theo trạng thái thành công/lỗi.
Vòng đời rõ ràng, an toàn: Server đi qua các trạng thái Bản nháp → Đã publish → Lưu trữ → Xóa vĩnh viễn. Chỉ xóa vĩnh viễn khi server đã ở trạng thái Lưu trữ, giúp tránh xóa nhầm năng lực đang được dùng.
Dễ làm theo cả cho người không rành code: 7 bước tạo có sẵn trên giao diện, không cần viết code cho server MCP. Người dùng phổ thông vẫn có thể làm theo từng bước.
4. Nhìn tổng quan module Xuất bản MCP
Bạn truy cập qua Tools & MCP (Công cụ) > Xuất bản MCP trên RedAI.
Danh sách hiển thị các cột: Tên MCP, Nguồn MCP, Server key, Trạng thái, Cập nhật và cột Thao tác.
Có hai nguồn xuất bản:
Khi nhấp vào tên nguồn ở cột Nguồn MCP, bạn có thể mở thẳng trang chi tiết của Kỹ năng hoặc Project Schema gốc. Mở Xem chi tiết để kiểm tra số lượng Tools, Workflows, Docs và sự hiện diện của API key trong tab Thông tin chung.
5. Chuẩn bị trước khi xuất bản
Trước khi tạo MCP Server, bạn cần chuẩn bị:
Nếu chưa có Kỹ năng hoặc Project Schema, hãy tạo trước tại module Skill hoặc Tools & MCP > Tích hợp Tools (External).
6. Cách tạo và xuất bản MCP Server (7 bước)
Từ trang Xuất bản MCP, bấm Tạo và xuất bản MCP trên thanh công cụ để mở cửa sổ thiết lập. Thực hiện theo 7 bước:
Bước 1 – Chọn loại nguồn MCP. Chọn Skill hoặc Project Schema.
Bước 2 – Chọn nguồn cụ thể. Mở cửa sổ chọn, lọc theo phạm vi Cá nhân, Hệ thống (hoặc Admin nếu có quyền), nhập từ khóa tìm kiếm rồi nhấp vào thẻ nguồn mong muốn.
Bước 3 – Nhập tên và mô tả. Nhập Tên MCP server và Mô tả. Nếu để trống, hệ thống tự động lấy theo tên và mô tả của nguồn đã chọn.
Bước 4 – Đặt hạn API key đầu tiên (tùy chọn). Chọn ngày và giờ hết hạn nếu muốn giới hạn thời gian sử dụng khóa. Để trống nếu không muốn đặt hạn.
Bước 5 – Chọn trạng thái xuất bản. Đánh dấu Xuất bản ngay sau khi tạo để kích hoạt máy chủ MCP ngay khi lưu, hoặc bỏ chọn để lưu ở trạng thái Bản nháp.
Bước 6 – Tạo sẵn API key đầu tiên. Đánh dấu Tạo sẵn API key đầu tiên để hệ thống tự động sinh khóa truy cập cùng máy chủ. Điều này giúp client có thông tin xác thực để kết nối ngay sau khi tạo.
Bước 7 – Hoàn tất tạo server. Chọn Tạo mới để lưu cấu hình và khởi tạo MCP server.
Kiểm tra kết quả sau khi tạo
Máy chủ MCP mới xuất hiện trong danh sách với đúng tên, nguồn và trạng thái Đã publish (hoặc Bản nháp).
Nhấp vào tên nguồn ở cột Nguồn MCP để kiểm tra liên kết trực tiếp tới trang chi tiết của Kỹ năng hoặc Project Schema tương ứng.
Mở Xem chi tiết, kiểm tra các số lượng Tools, Workflows, Docs và sự hiện diện của API key trong tab Thông tin chung.
Lưu ý bảo mật: Sau khi tạo thành công kèm tùy chọn tạo API key, hệ thống sẽ hiển thị thông báo kèm khung API key mới tạo. Hãy chọn Sao chép để lưu lại khóa truy cập này. 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 lý vòng đời MCP Server
Menu ba chấm trên từng MCP Server cung cấp đầy đủ thao tác quản trị:
Vòng đời tiêu dùng: Bản nháp → Đã publish → Lưu trữ → Xóa vĩnh viễn.
Có thể đánh dấu chọn nhiều máy chủ bằng các ô vuông đầu dòng, sau đó chọn biểu tượng Xóa màu đỏ trên thanh công cụ để xóa nhanh cùng lúc.
Cảnh báo: Xóa máy chủ MCP sẽ ngừng cấp toàn bộ công cụ trực thuộc cho các client đang kết nối. Trước khi xóa vĩnh viễn, hãy đảm bảo không còn ứng dụng nào cần dùng năng lực này.
8. Quản lý API key
Trong tab Thông tin chung, bạn quản lý các khóa truy cập:
Cảnh báo: Trước khi thu hồi hoặc xóa một API key, cần cập nhật khóa mới vào cấu hình của các MCP client liên quan để tránh làm gián đoạn các phiên làm việc đang chạy.
9. Cấu hình cho MCP client bên ngoài
Trong tab Cấu hình sử dụng, RedAI cung cấp mẫu cấu hình theo 4 loại client:
Cách thực hiện:
Xác định loại MCP client đang sử dụng.
Chọn Sao chép tại khối cấu hình tương ứng.
Dán đoạn cấu hình vào phần mềm client. Nếu cấu hình đang hiển thị placeholder <YOUR_DYNAMIC_MCP_API_KEY>, hãy thay bằng chuỗi API key thật của server.
Nếu bạn vừa tạo API key trong phiên làm việc hiện tại, hệ thống sẽ tự động điền sẵn khóa thật vào đoạn cấu hình khi nhấp Sao chép.
10. Tra cứu lịch sử gọi (Audit Logs)
Trong tab Lịch sử, bạn theo dõi từng lượt gọi MCP với các trường:
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
Thời gian Cập nhật
Công cụ hỗ trợ:
Tìm kiếm: Nhập từ khóa vào ô tìm kiếm để lọc nhật ký theo hành động hoặc traceId – hữu ích khi điều tra sự cố hoặc đối chiếu một lần gọi cụ thể.
Lọc theo trạng thái: Chọn Tất cả trạng thái, Thành công (2xx) hoặc Lỗi (4xx/5xx) để thu hẹp vào nhóm request cần xử lý.
Tải lại: Cập nhật các lượt gọi MCP mới nhất phát sinh từ client.
11. Xuất bản MCP trong hệ sinh thái RedAI
Xuất bản MCP không nằm đơn lập, mà gắn liền với các module khác:
Kỹ năng (Skill): Nếu xuất bản từ Skill, toàn bộ công cụ, kịch bản và tài liệu tri thức của Skill được đóng gói vào MCP Server. Bạn có thể quản lý Kỹ năng tại Trang chủ > Skill > Chi tiết.
Project Schema (Tools & MCP): Nếu xuất bản từ Project Schema, các công cụ API đã định nghĩa trong Tools & MCP được đóng gói thành server độc lập.
AI Agent: Kỹ năng đã được gắn công cụ và xuất bản thành MCP có thể được gọi từ bên ngoài, mở rộng khả năng hành động của AI Agent ra ngoài Workspace.
12. So sánh: Xuất bản MCP vs chia sẻ công cụ thủ công
13. Câu hỏi thường gặp (FAQ)
1. Xuất bản MCP khác gì với Tích hợp Tools (External)?
Tích hợp Tools (External) dùng để khai báo và quản lý công cụ API bên trong RedAI. Xuất bản MCP dùng để đóng gói năng lực đã có (từ Kỹ năng hoặc Project Schema) thành máy chủ MCP để phần mềm bên ngoài kết nối. Hai tính năng bổ trợ nhau.
2. Tôi có cần viết code để tạo MCP Server không?
Không. Toàn bộ quy trình tạo có sẵn trên giao diện: chọn nguồn, đặt tên, cấu hình hạn API key, chọn trạng thái xuất bản rồi bấm Tạo mới. Hệ thống tự sinh endpoint và API key.
3. MCP Server và MCP client khác nhau thế nào?
Trong RedAI, bạn quản lý phía máy chủ (tạo server, quản lý API key, xem nhật ký). 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, NPX bridge). Tab Cấu hình sử dụng cung cấp mẫu cấu hình cho từng loại client.
4. Xóa một MCP Server ảnh hưởng đến gì?
Xóa máy chủ MCP sẽ ngừng cấp toàn bộ công cụ trực thuộc cho các client đang kết nối. Nếu chỉ muốn tạm ngưng, hãy dùng thao tác Lưu trữ. Xóa vĩnh viễn chỉ được phép khi server đã ở trạng thái Lưu trữ.
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. 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 dụng nào đang gọi MCP Server của tôi không?
Tại tab Lịch sử, bạn xem nhật ký gọi với traceId, mã trạng thái, độ trễ, mã lỗi, API key đã dùng và thời gian cập nhật. Hỗ trợ tìm kiếm theo traceId và lọc theo trạng thái thành công/lỗi.
7. Tôi có thể xuất bản cùng một Kỹ năng thành nhiều MCP Server không?
Có. Bạn có thể tạo nhiều MCP Server từ cùng một nguồn (Kỹ năng hoặc Project Schema), mỗi server có tên, API key và cấu hình riêng, phù hợp cho việc cấp quyền cho nhiều client khác nhau.