Trong trang này
Tóm lại. Máy chủ MCP cho phép một ứng dụng tương thích MCP (Claude Desktop, Claude Code, Codex, Cursor) hỏi về các chỉ số của một tổ chức ngay từ máy của bạn. Super admin tạo token riêng cho từng tổ chức; một chương trình cầu nối nhỏ chạy trên máy bạn chuyển yêu cầu của ứng dụng thành các lệnh gọi HTTPS tới nền tảng.
Cách hoạt động#
- Phía nền tảng. Hai điểm cuối trong ứng dụng web: một trả danh sách công cụ, một chạy công cụ. Cả hai đều yêu cầu token, dùng tổ chức gắn với token, tính theo giờ Việt Nam và cùng công thức với trợ lý dữ liệu, và ghi một dòng nhật ký kiểm toán cho mỗi lần gọi.
- Phía cầu nối.
apps/mcp-serverlà một chương trình Node trong kho mã, chạy bằngpnpm --filter @yng/mcp-server starttừ bản checkout. Nó đọcUCIP_API_URLvàUCIP_API_TOKENtừ biến môi trường và lấy danh sách công cụ một lần lúc khởi động, nên công cụ mới tới ứng dụng ở lần khởi động lại kế tiếp. - Token. Chỉ super admin tạo được: mở tổ chức trong bảng điều khiển, tab "Token MCP", nhập nhãn và thời hạn (mặc định 90 ngày, tối đa 365). Token chỉ hiện một lần và được lưu dưới dạng băm. Token thuộc về tổ chức, không thuộc một người; hãy coi nó như thông tin xác thực dịch vụ và chuyển qua công cụ quản lý bí mật.
Các bước kết nối#
- Super admin tạo token như trên.
- Thêm cầu nối vào cấu hình MCP của ứng dụng dưới dạng máy chủ stdio, kèm hai biến môi trường, rồi khởi động lại ứng dụng.
- Yêu cầu ứng dụng liệt kê các chỉ số, rồi hỏi một câu thật. Nó phải gọi một công cụ truy vấn và tóm tắt kết quả.
Công cụ#
| Công cụ | Trả lời |
|---|---|
| Liệt kê chỉ số, lấy ngữ cảnh | Đo được gì và bối cảnh của tổ chức |
| Truy vấn chỉ số | Tổng và xu hướng của một chỉ số trong một kỳ |
| Top N theo chiều | Giá trị đứng đầu theo nhóm: sàn, creator, SKU |
| So sánh giữa các kỳ | Một chỉ số qua hai kỳ |
| Giải thích thay đổi | Yếu tố nào làm chỉ số dịch chuyển |
| Dự báo chỉ số | Dự phóng ngắn hạn |
| Công cụ marketing | Chi quảng cáo, nhịp ngân sách, chiến dịch, kiểm tra marketing, phễu khách tiềm năng, kênh sở hữu; mỗi công cụ chỉ có khi dữ liệu tương ứng đã kết nối |
Công cụ dữ liệu thị trường, thảo luận khách hàng và bộ dữ liệu của tổ chức không bao giờ được mở qua MCP. Nền tảng từ chối trả danh sách nếu một công cụ như vậy lọt vào.
Nếu không chạy#
| Triệu chứng | Nguyên nhân | Cách xử lý |
|---|---|---|
| Không thấy công cụ MSO Cloud sau khi khởi động lại | Cầu nối không chạy | Kiểm tra địa chỉ và token trong cấu hình ứng dụng |
| Mọi lệnh gọi lỗi dù trước đó chạy được | Token bị thu hồi hoặc hết hạn | Xin super admin token mới; thu hồi có hiệu lực từ lần gọi kế tiếp |
| Lệnh gọi lỗi từng đợt | Quá 30 lần gọi trong một phút | Chờ một phút rồi thử lại |
Giới hạn#
- Cầu nối không phải dịch vụ lưu trữ sẵn và không nằm trong container production nào; mỗi ứng dụng tự chạy bản của mình tới địa chỉ nền tảng. Phía nền tảng đi cùng ứng dụng web. Xem Tình trạng dự án.
- Không có công cụ ghi ngược. Mọi công cụ chỉ đọc.