Model Context Protocol (MCP)

Bring your entire TrolyPage operation into an AI agent

Connect ChatGPT, Claude, Cursor, or any MCP client to the work that matters: customer support, commerce, marketing, analytics, and knowledge management.

MCP surface status

Gateway ready
8
MCP servers
85
Total tools
13
Resources
12
Prompts
OAuth Scope: mcp:use
Rate Limit: 180/workspace/min
Onboarding flow

Make your first connection in five minutes

Start with a safe read-only call. Once the AI client can see the tool catalog, configure approval rules for sensitive write operations.

01

Connect once

Use /mcp/troly for one connection. The server exposes only the tools included in the workspace plan.

02

Issue a credential

Use OAuth 2.1 + PKCE for ChatGPT or Claude Web, or create an MCP API key in the control panel for Cursor, VS Code, and Claude Code.

03

Test a read tool

Ask the agent to list tools, then run a read-only lookup such as finding an order or reading a conversation.

04

Set approval mode

Use Hybrid mode so messages, orders, posts, and other sensitive writes wait for workspace approval before execution.

mcp.json (Claude Desktop / Cursor / VS Code)
{
  "mcpServers": {
    "trolypage": {
      "url": "https://trolypage.com/mcp/troly",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}
Claude Code CLI
claude mcp add --transport http trolypage \
  https://trolypage.com/mcp/troly \
  --header "Authorization: Bearer YOUR_MCP_API_KEY"
No MCP API key yet? Create a scoped credential in one click from the control panel.
Create an API key
Protocol catalog

One unified server plus seven focused servers

Use the unified server for the full tool set through one connection, or choose a focused endpoint for tighter permissions and compatibility.

Explore all 85 tools

TrolyPage Unified Server

https://trolypage.com/mcp/troly
85 tools 13 resources

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.

12 prompts manifest.json

Customer Support Server

https://trolypage.com/mcp/support
17 tools 4 resources

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.

3 prompts manifest.json

Commerce Server

https://trolypage.com/mcp/commerce
15 tools 3 resources

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.

3 prompts manifest.json

Analytics Server

https://trolypage.com/mcp/analytics
12 tools 1 resources

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.

2 prompts manifest.json

Social Server

https://trolypage.com/mcp/social
12 tools 3 resources

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.

3 prompts manifest.json

Marketing Server

https://trolypage.com/mcp/marketing
13 tools 3 resources

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.

3 prompts manifest.json

Knowledge Server

https://trolypage.com/mcp/knowledge
6 tools 2 resources

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.

2 prompts manifest.json

Workspace Server

https://trolypage.com/mcp/workspace
10 tools 3 resources

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.

2 prompts manifest.json
Security & approval

Control every write requested by an AI client

Every external AI request is authenticated and bound to a workspace. Choose the approval policy that matches how your team operates.

Hybrid (recommended)

Default

Read-only calls and drafts run immediately. Sensitive writes such as publishing, broadcasting, creating orders, or creating shipments enter the workspace approval queue.

Strict

Maximum control

Every action that writes data must be manually approved by an operator before it can run.

Auto

Use with care

Tools run immediately when requested by the AI client. Use this only for well-tested agents and tightly controlled environments.

Troubleshooting

Understand MCP HTTP errors

When an AI client receives an error from the MCP gateway, use this table to identify the cause and next action.

HTTP code Cause and resolution
HTTP 401 The credential is missing, expired, or invalid. Sign in again through OAuth or create a new API key.
HTTP 402 The workspace plan does not include the requested MCP module. Upgrade the plan to enable it.
HTTP 403 The request is missing the mcp:use scope, has the wrong workspace context, lacks the required role, or uses a denied Origin.
HTTP 404 The MCP gateway is not enabled for this service, or the requested endpoint or resource does not exist.
HTTP 422 Tool arguments do not match the JSON Input Schema. Check the payload format and required fields.
HTTP 429 The workspace rate limit was reached. Wait for the duration specified by the Retry-After header before retrying.

Connect your AI agent today

Create a credential, explore the tool catalog, and choose a safe approval policy from the TrolyPage control panel.