Đưa toàn bộ vận hành TrolyPage vào AI Agent
Kết nối ChatGPT, Claude, Cursor hoặc bất kỳ MCP Client nào với đúng miền công việc: chăm sóc khách hàng, bán hàng, marketing, phân tích dữ liệu và quản lý tri thức.
Trạng thái bề mặt MCP
Gateway sẵn sàngmcp:use
Kết nối lần đầu trong năm phút
Bắt đầu bằng một lệnh đọc an toàn. Khi AI Client đã thấy danh mục công cụ, hãy thiết lập quy tắc duyệt cho các tác vụ ghi nhạy cảm.
Kết nối một lần
Dùng /mcp/troly cho một kết nối. Server chỉ hiển thị các tool thuộc gói hiện tại của workspace.
Cấp credential
Dùng OAuth 2.1 + PKCE cho ChatGPT hoặc Claude Web, hoặc tạo MCP API key trong trang quản trị cho Cursor, VS Code và Claude Code.
Thử một tool đọc
Yêu cầu agent liệt kê tools, sau đó chạy một tra cứu read-only như tìm đơn hàng hoặc đọc hội thoại.
Đặt chế độ duyệt
Dùng chế độ Hybrid để tin nhắn, đơn hàng, bài đăng và các lệnh ghi nhạy cảm chờ workspace duyệt trước khi thực thi.
{
"mcpServers": {
"trolypage": {
"url": "https://trolypage.com/mcp/troly",
"headers": {
"Authorization": "Bearer YOUR_MCP_API_KEY"
}
}
}
}
claude mcp add --transport http trolypage \
https://trolypage.com/mcp/troly \
--header "Authorization: Bearer YOUR_MCP_API_KEY"
Một server tổng và bảy server chuyên biệt
Dùng server tổng để truy cập đầy đủ tool qua một kết nối, hoặc chọn endpoint chuyên biệt khi cần giới hạn quyền chặt hơn.
TrolyPage Unified Server
https://trolypage.com/mcp/troly
One TrolyPage MCP connection for customer support, commerce, analytics, social, marketing, knowledge, and workspace operations. The exposed capabilities are filtered to the modules enabled for the authenticated workspace. Prefer list/search/get tools before writes, never invent IDs, and clearly report approval-queue results. Before the first action, read `trolypage://mcp/guide`. Use list/get tools before write tools, never invent IDs, and explain any approval-queue result to the user. HTTP writes require a workspace admin/owner; rate-limit responses use HTTP 429 with Retry-After.
Customer Support Server
https://trolypage.com/mcp/support
MCP Server cho hệ thống chăm sóc khách hàng Facebook/ManyChat. Cung cấp tools để tìm kiếm khách hàng, xem lịch sử hội thoại, gửi thông báo Telegram, cập nhật trạng thái, chat qua AI agent, và tạo báo cáo. Resources: cấu hình agent, knowledge base, danh sách subscribers. Prompts: hỗ trợ khách hàng, phân tích subscriber. Before the first action, read `trolypage://mcp/guide`. Use list/get tools before write tools, never invent IDs, and explain any approval-queue result to the user. HTTP writes require a workspace admin/owner; rate-limit responses use HTTP 429 with Retry-After.
Commerce Server
https://trolypage.com/mcp/commerce
MCP Server bán hàng & vận chuyển: đơn hàng, thanh toán QR VietQR, kiểm tra thanh toán, vận đơn (thường + hỏa tốc), sản phẩm/catalog và lịch hẹn. Tool tạo đơn chạy vào luồng chờ duyệt của shop; tool tạo vận đơn yêu cầu đơn đã xác nhận. Số tiền, tồn kho và mã đối soát luôn do hệ thống quyết định. Before the first action, read `trolypage://mcp/guide`. Use list/get tools before write tools, never invent IDs, and explain any approval-queue result to the user. HTTP writes require a workspace admin/owner; rate-limit responses use HTTP 429 with Retry-After.
Analytics Server
https://trolypage.com/mcp/analytics
MCP Server báo cáo & thống kê — 100% read-only, không có tool ghi. Cung cấp doanh thu, kênh, hội thoại, nhân viên, follow-up, MXH và dự báo với bộ lọc chung (range, channels, ai_agents...). Dữ liệu trùng khớp màn Reports trong TrolyPage. Before the first action, read `trolypage://mcp/guide`. Use list/get tools before write tools, never invent IDs, and explain any approval-queue result to the user. HTTP writes require a workspace admin/owner; rate-limit responses use HTTP 429 with Retry-After.
Social Server
https://trolypage.com/mcp/social
MCP Server đăng bài MXH (Facebook, TikTok, YouTube, LinkedIn, Instagram...): soạn nháp, lên lịch, đăng thật, retry và phân tích hiệu quả. Soạn/sửa/hủy chạy ngay; publish-social-post và retry cần duyệt của shop. AI hỗ trợ caption/hashtags/giờ đăng. Before the first action, read `trolypage://mcp/guide`. Use list/get tools before write tools, never invent IDs, and explain any approval-queue result to the user. HTTP writes require a workspace admin/owner; rate-limit responses use HTTP 429 with Retry-After.
Marketing Server
https://trolypage.com/mcp/marketing
MCP Server marketing & chiến dịch: chiến lược → chiến dịch → broadcast/nurture/follow-up. Soạn thảo (strategy/campaign/broadcast/nurture/follow-up) chạy ngay dưới dạng draft; submit-broadcast gửi vào hàng đợi duyệt của chủ shop. AI KHÔNG bao giờ tự gửi tin hàng loạt khi chưa được duyệt. Before the first action, read `trolypage://mcp/guide`. Use list/get tools before write tools, never invent IDs, and explain any approval-queue result to the user. HTTP writes require a workspace admin/owner; rate-limit responses use HTTP 429 with Retry-After.
Knowledge Server
https://trolypage.com/mcp/knowledge
MCP Server tri thức: tra cứu knowledge base theo agent (hybrid recall + rerank), xem cây node, tìm facts ĐÃ DUYỆT, tìm tài liệu. propose-fact chỉ tạo đề xuất chờ duyệt — facts chưa duyệt không bao giờ được dùng trả lời khách. Before the first action, read `trolypage://mcp/guide`. Use list/get tools before write tools, never invent IDs, and explain any approval-queue result to the user. HTTP writes require a workspace admin/owner; rate-limit responses use HTTP 429 with Retry-After.
Workspace Server
https://trolypage.com/mcp/workspace
MCP Server vận hành workspace: tổng quan kênh đã kết nối, trạng thái AI Agents, thông báo nội bộ (đọc/xử lý) và support ticket. Không chứa dữ liệu khách hàng nhạy cảm — phù hợp kết nối cho trợ lý vận hành của chủ shop. Before the first action, read `trolypage://mcp/guide`. Use list/get tools before write tools, never invent IDs, and explain any approval-queue result to the user. HTTP writes require a workspace admin/owner; rate-limit responses use HTTP 429 with Retry-After.
Kiểm soát mọi lệnh ghi từ AI Client
Mọi request từ AI bên ngoài đều được xác thực và gắn với một workspace. Bạn chọn chính sách phê duyệt phù hợp với cách đội ngũ vận hành.
Hybrid (khuyến nghị)
Mặc địnhLệnh read-only và bản nháp chạy ngay. Các lệnh ghi nhạy cảm như đăng bài, broadcast, tạo đơn hay tạo vận đơn sẽ vào hàng chờ duyệt của workspace.
Nghiêm ngặt
Kiểm soát tối đaMọi hành động ghi dữ liệu đều phải được người vận hành duyệt thủ công trước khi thực thi.
Tự động
Dùng thận trọngTool chạy ngay khi AI Client yêu cầu. Chỉ dùng cho agent đã được kiểm thử kỹ và môi trường được kiểm soát chặt.
Hiểu các lỗi HTTP của MCP
Khi AI Client nhận lỗi từ MCP gateway, dùng bảng này để xác định nguyên nhân và hành động tiếp theo.
| Mã HTTP | Nguyên nhân và cách khắc phục |
|---|---|
| HTTP 401 | Credential bị thiếu, hết hạn hoặc không hợp lệ. Đăng nhập lại qua OAuth hoặc tạo API key mới. |
| HTTP 402 | Gói hiện tại của workspace chưa có module MCP được yêu cầu. Nâng cấp gói để kích hoạt module. |
| HTTP 403 | Request thiếu scope mcp:use, sai workspace, thiếu role cần thiết hoặc dùng Origin bị từ chối. |
| HTTP 404 | MCP gateway chưa được bật cho dịch vụ này, hoặc endpoint hay tài nguyên được yêu cầu không tồn tại. |
| HTTP 422 | Tham số tool không khớp JSON Input Schema. Kiểm tra lại định dạng payload và các trường bắt buộc. |
| HTTP 429 | Workspace đã chạm giới hạn request. Hãy chờ theo thời gian trong header Retry-After trước khi thử lại. |
Kết nối AI Agent của bạn ngay hôm nay
Tạo credential, khám phá danh mục tool và chọn chính sách phê duyệt an toàn trong trang quản trị TrolyPage.