Tools & MCP - Xuất bản MCP Server và quản lý khóa API
Hướng dẫn tạo và phát hành máy chủ MCP ra cộng đồng hoặc nội bộ Workspace kèm phân quyền API Key.
Mở khu vực Xuất bản MCP
| Bước | Cách thực hiện |
|---|---|
| 1 | Mở Tools & MCP (Công cụ) trên RedAI. |
| 2 | Chọn Xuất bản MCP để mở danh sách các MCP Server đã cấu hình. Danh sách hiển thị Tên MCP, Nguồn MCP, Server key, Trạng thái, Cập nhật và cột Thao tác. |
Các bước thực hiện
Chọn phương án nguồn xuất bản
| Phương án | Dùng khi | Điều kiện |
|---|---|---|
| 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 Skill thành máy chủ MCP. | Skill đã được tạo sẵn trong thư viện Skills và có nội dung hoạt động. |
| 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. | Project Schema có ít nhất một công cụ (tool) hợp lệ. |
Tạo và xuất bản MCP Server
| Bước | Cách thực hiện |
|---|---|
| 1 | Chọn  Tạo và xuất bản MCP trên thanh công cụ. Cửa sổ thiết lập mở ra. |
| 2 | Tại mục Loại nguồn MCP, chọn Skill hoặc Project Schema. |
| 3 | Chọn ô chọn nguồn (Tìm và chọn skill hoặc Tìm và chọn project schema) để mở cửa sổ chọn: • Chuyển giữa các tab 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 nhanh nguồn cần dùng. • Nhấp vào thẻ nguồn mong muốn để xác nhận chọn. |
| 4 | Nhập Tên MCP server và Mô tả. Nếu để trống, hệ thống sẽ tự động lấy theo tên và mô tả của nguồn đã chọn. |
| 5 | Tại mục Hạn API key đầu tiê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). |
| 6 | Đá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). |
| 7 | Đá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ủ. |
| 8 | Chọn  Tạo mới để hoàn tất. |
Lưu ý: Sau khi tạo thành công với 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.
Cảnh báo: 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.
Kiểm tra kết quả xuất bản
| Bước | Cách thực hiện | Giao diện |
|---|---|---|
| 1 | Xác nhận 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). | Bảng danh sách Xuất bản MCP |
| 2 | Nhấp vào tên nguồn tại cột Nguồn MCP để kiểm tra liên kết trực tiếp tới trang chi tiết của Skill hoặc Project Schema tương ứng. | Cột Nguồn MCP (icon não bộ cho Skill, icon hộp cho Project Schema) |
| 3 | 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. | Cửa sổ Chi tiết server đã chọn > tab Thông tin chung |
| 4 | Chuyển sang tab Cấu hình sử dụng để sao chép cấu hình mẫu và thử nghiệm kết nối trên MCP client (Claude Desktop, Codex CLI…). | Cửa sổ Chi tiết server đã chọn > tab Cấu hình sử dụng |
Các tính năng quản lý MCP
Thao tác với từng MCP Server
Tại hàng của máy chủ MCP cần quản lý, chọn menu ba chấm trong cột Thao tác, sau đó chọn chức năng tương ứng:
| Thao tác | Cách thực hiện | Kết quả hoặc lưu ý |
|---|---|---|
 Xem chi tiết | Chọn Xem chi tiết. | Mở cửa sổ quản trị toàn diện gồm 3 tab: Thông tin chung, Cấu hình sử dụng và Lịch sử. |
 Xem danh sách API Key | Chọn Xem danh sách API Key. | Mở nhanh tab Thông tin chung để quản lý các khóa truy cập đang áp dụng. |
 Tạo API key | Chọn Tạo API key, nhập Tên API key, đặt thời hạn nếu cần rồi chọn Tạo API key. | Tạo thêm khóa truy cập mới cho máy chủ MCP này. |
 Xuất bản | Chọn Xuất bản (chỉ hiển thị khi MCP Server đang ở trạng thái Bản nháp hoặc Lưu trữ). | Kích hoạt máy chủ chuyển sang trạng thái Đã publish để sẵn sàng tiếp nhận kết nối từ các client. |
 Lưu trữ | Chọn Lưu trữ (hiển thị khi máy chủ chưa bị lưu trữ). | Đưa máy chủ về trạng thái Lưu trữ, tạm ngưng phục vụ các kết nối client. |
 Xóa vĩnh viễn | Chọn Xóa vĩnh viễn (chỉ hiển thị khi máy chủ đã ở trạng thái Lưu trữ), sau đó xác nhận xóa. | Xóa hoàn toàn máy chủ MCP và toàn bộ các API key trực thuộc khỏi hệ thống. |
Lưu ý thao tác hàng loạt: Có thể đánh dấu chọn nhiều máy chủ MCP bằng các ô vuông đầu dòng, sau đó chọn biểu tượng
Xem thông tin chung và quản lý API key
Trong cửa sổ Chi tiết server đã chọn, mở tab Thông tin chung:
| Tính năng | Cách thực hiện | Kết quả hoặc lưu ý |
|---|---|---|
| Thông tin định danh | Kiểm tra Tên MCP, Nguồn MCP, Trạng thái và chuỗi Server key. | Nhấp vào tên nguồn để mở trang quản lý chi tiết của Skill hoặc Project Schema gốc. |
| Thống kê năng lực | Xem các thẻ tổng số: Tools (công cụ), Workflows (kịch bản chạy) và Docs (tài liệu tri thức). | Cho biết quy mô tài nguyên mà máy chủ MCP này đang cung cấp cho các client bên ngoài. |
| Tạo API key | Nhấp biểu tượng chìa khóa cạnh tiêu đề API keys, nhập tên khóa và hạn dùng rồi xác nhận. | Cấp thêm một khóa truy cập riêng biệt cho từng người dùng hoặc môi trường. |
| Sao chép API key | Tại hàng của API key cần dùng, nhấp nút sao chép. | Hệ thống tự động giải mã và sao chép toàn bộ chuỗi API key vào bộ nhớ tạm. |
| Xóa API key | Chọn biểu tượng xóa màu đỏ tại API key không còn dùng và xác nhận xóa. | Thu hồi khóa ngay lập tức. Các client đang kết nối bằng khóa này sẽ bị từ chối 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.
Sao chép cấu hình sử dụng MCP client
Trong cửa sổ Chi tiết server đã chọn, mở tab Cấu hình sử dụng:
| Bước | Cách thực hiện |
|---|---|
| 1 | Xác định loại MCP client đang sử dụng: • 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ộ. |
| 2 | Chọn Sao chép tại khối cấu hình tương ứng. |
| 3 | 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>, thay thế bằng chuỗi API key thật của server. |
Lưu ý: 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 nút Sao chép.
Tra cứu lịch sử sử dụng (Audit Logs)
Trong cửa sổ Chi tiết server đã chọn, mở tab Lịch sử:
| Tính năng | Cách thực hiện |
|---|---|
| Xem bảng nhật ký | Theo dõi chi tiết từng lượt gọi gồm: 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. |
 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. |
| Lọc theo trạng thái | Mở menu bộ lọc trên thanh công cụ và chọn: Tất cả trạng thái, Thành công (2xx) hoặc Lỗi (4xx/5xx). |
 Tải lại | Chọn nút tải lại để cập nhật các lượt gọi MCP mới nhất phát sinh từ client. |