AI Agent & MCP — nối trợ lý AI bất kỳ với NextX

Máy chủ MCP có sẵn của NextX cho AI agent đọc và thao tác dữ liệu workspace qua 62 công cụ — không cần cài đặt hay dựng gì, chỉ cần 1 API key và ~2 phút.

Cách nhanh nhất: chỉ cần URL

ChatGPT, Claude, Claude Code, Copilot, Cursor, Gemini CLI, Grok, VS Code… — mọi trợ lý AI hỗ trợ MCP: thêm máy chủ https://mcp.nextx.vn/mcp — client tự mở màn đăng nhập NextX, bạn chọn workspace và quyền. Không cần khoá. Các bước dưới đây là Cách 2 — API key cho máy chủ tự động, n8n, tự host.

Hướng dẫn Cách 1 theo từng client →

Máy chủ MCPhttps://mcp.nextx.vn/mcpHosted · 62 công cụSandbox: https://mcp-dev.nextx.vn/mcp

Cách 2 — API key: 3 bước

1
Tạo API key trong NextX
Vào Thiết lập › AI Agent & API (hoặc wizard Tích hợp AI), chọn quyền Chỉ đọc hay Đọc + ghi rồi bấm Tạo khoá. Khoá chỉ hiện một lần — sao chép ngay.
Mở màn tạo khoá trong NextX →
2
Dán cấu hình theo client của bạn
Chọn tab bên dưới đúng ứng dụng AI bạn dùng, thay YOUR_API_KEY bằng khoá vừa tạo rồi copy nguyên khối.
3
Hỏi thử
Ví dụ: "Liệt kê 5 liên hệ mới nhất trong CRM" — agent sẽ tự gọi công cụ search_contacts. Xong.

Cấu hình theo client

Mọi client theo chuẩn MCP (Streamable HTTP) đều nối được. Khoá đặt trong header Authorization: Bearer.

Cline, Windsurf, Zed, LibreChat… và mọi client chuẩn MCP (Streamable HTTP):

{
  "url": "https://mcp.nextx.vn/mcp",
  "transport": "streamable-http",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }
}

Muốn thử trước ở môi trường sandbox: thay URL bằng máy chủ sandbox ở đầu trang và dùng khoá tạo trên app-dev.nextx.vn.

62 công cụ — agent làm được gì?

Nhóm theo phân hệ; bấm vào từng nhóm để xem tham số chi tiết. Công cụ ghi (tạo/sửa) yêu cầu khoá Đọc + ghi.

CRM (9) →

search_contactsget_contactcreate_contactget_deal_pipelineget_dealupdate_deal_stageget_sales_summaryget_recent_activitiescreate_task

Chat đa kênh (1) →

send_zalo_message

Bán hàng (6) →

sales_list_orderssales_get_ordersales_list_productssales_get_productsales_get_product_stocksales_list_customers

Office (10) →

office_list_recordsoffice_get_recordoffice_create_recordoffice_update_recordoffice_delete_recordoffice_list_approval_instancesoffice_get_approval_instanceoffice_create_approval_instanceoffice_approve_taskoffice_reject_task

Nhân sự (5) →

hrm_list_attendance_deviceshrm_list_raw_puncheshrm_get_clock_history_dailyhrm_get_clock_timelinehrm_list_employee_credentials

DMS (7) →

dms_list_catalog_productsdms_list_checkinsdms_list_daily_plansdms_get_daily_plandms_list_outletsdms_list_ordersdms_list_routes

Tổng đài (7) →

call_list_agentscall_list_campaignscall_list_call_flowscall_list_ivr_flowscall_list_phone_numberscall_list_callscall_list_queues

Marketing (6) →

marketing_list_email_campaignsmarketing_get_email_campaignmarketing_list_email_templatesmarketing_list_integrationsmarketing_get_report_overviewmarketing_list_sender_profiles

Thanh toán (6) →

payment_get_intentpayment_list_refundspayment_list_transactionspayment_get_transactionpayment_list_subscriptionspayment_get_report_overview

Hoá đơn điện tử (5) →

einvoice_list_invoiceseinvoice_get_invoiceeinvoice_list_serieseinvoice_get_report_summaryeinvoice_get_settings

230 công cụ AI qua đăng nhập OAuth

Khi người dùng kết nối trợ lý AI bằng tài khoản của họ (OAuth), trợ lý dùng bộ công cụ đọc, xuất và write proposal theo từng phân hệ — mỗi công cụ có tham số và ví dụ gọi.

Xem 230 công cụ AI →

Mô hình bảo mật

Khoá thuộc một workspace — agent chỉ thấy dữ liệu workspace đó, không hơn.
Quyền theo scope gắn lúc tạo khoá: Chỉ đọc = các scope *.view; Đọc + ghi thêm *.manage. Khoá chỉ-đọc gọi công cụ ghi sẽ nhận 403 scope_required.
Thu hồi khoá bất kỳ lúc nào tại Thiết lập › AI Agent & API — hiệu lực ngay.

Lỗi thường gặp

Triệu chứng	Nguyên nhân → cách sửa
401 ngay lệnh đầu tiên	Sai header hoặc khoá đã thu hồi — dùng đúng `Authorization: Bearer <khoá>`; tạo khoá mới nếu đã thu hồi.
403 `scope_required`	Khoá Chỉ đọc gọi công cụ ghi (tạo liên hệ, duyệt phiếu…) — tạo khoá Đọc + ghi rồi thay vào cấu hình.
Trả về HTML thay vì JSON	Sai URL hoặc DNS cache — endpoint đúng là `https://mcp.nextx.vn/mcp`; thử `curl https://mcp.nextx.vn/health` phải ra JSON.
Client treo khi trả lời dài	Kết nối đi qua proxy có buffer làm nghẽn stream — nối thẳng tới máy chủ MCP, không qua proxy tự dựng.

Nâng cao: tự host

Chạy nextx-mcp trong hạ tầng riêng (STDIO + OAuth2) — dành cho đối tác nhúng sâu

Đa số trường hợp KHÔNG cần mục này — máy chủ hosted phía trên là đường khuyến nghị. Tự host khi bạn muốn nhúng MCP vào hệ thống riêng, dùng danh tính OAuth2 client_credentials của app đối tác thay vì khoá workspace.

git clone https://github.com/nextx-organization/nextx-mcp
cd nextx-mcp
npm install && npm run build      # build ra dist/index.js

Environment variable (lấy client_id/secret khi đăng ký app đối tác):

NEXTX_CLIENT_ID=...       # OAuth2 client (đăng ký app đối tác)
NEXTX_CLIENT_SECRET=...
NEXTX_WORKSPACE_ID=...    # workspace khách đã cài app
NEXTX_API_URL=https://api.nextx.vn
node dist/index.js

Cấu hình client STDIO (Claude Desktop, Cursor, VS Code…):

{
  "mcpServers": {
    "nextx": {
      "command": "node",
      "args": ["/duong-dan/nextx-mcp/dist/index.js"],
      "env": {
        "NEXTX_API_URL": "https://api.nextx.vn",
        "NEXTX_CLIENT_ID": "YOUR_CLIENT_ID",
        "NEXTX_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "NEXTX_WORKSPACE_ID": "WORKSPACE_GUID"
      }
    }
  }
}

Chưa có OAuth2 client? Xem Tạo app trong console.